devbase

Bimodales Entwickler-Workspace-OS — Bimodales Betriebssystem für Entwickler-Workspaces

Menschen nutzen die TUI für den Überblick, KI nutzt MCP für den Zugriff auf lokale Repos. Ein Dashboard für Menschen. Eine API für Agenten.

devbase ist ein lokal priorisiertes, bimodales Workspace-Betriebssystem: Es ist sowohl ein Multi-Repo-TUI-Dashboard für menschliche Entwickler als auch ein strukturierter Wissenseinstiegspunkt für Codebasen für KI-Agenten. In einer Zeit, in der KI Ihre GUI nicht erkennt und Ihr lokales Dateisystem nicht wahrnehmen kann, ist devbase der einzige Einstiegspunkt für KI, um Ihre lokalen Codebasen zu verstehen.

Kurzvorstellung

Bimodale Architektur (Bimodal Architecture)

┌─────────────────────────────────────────────────────────────┐
│ devbase │
│ Bimodal Developer Workspace OS │
├─────────────────────────────┬───────────────────────────────┤
│ Human Layer │ AI Layer │
│ (人类交互层) │ (智能体接口层) │
│ │ │
│ ┌─────────────────────┐ │ ┌─────────────────────┐ │
│ │ TUI Dashboard │ │ │ MCP Server │ │
│ │ 终端交互仪表盘 │ │ │ 17 Tools │ │
│ │ │ │ │ stdio / SSE │ │
│ │ • 多仓库健康总览 │ │ │ │ │
│ │ • 跨仓库代码搜索 / │ │ │ • devkit_scan │ │
│ │ • Stars 趋势图 │ │ │ • devkit_health │ │
│ │ • AI 洞察面板 │ │ │ • devkit_sync │ │
│ │ • 智能同步建议 │ │ │ • devkit_query_repos│ │
│ │ • gitui/lazygit 启动 │ │ │ • devkit_code_metrics│ │
│ │ │ │ │ • devkit_module_graph│ │
│ └─────────────────────┘ │ │ • devkit_natural... │ │
│ │ └─────────────────────┘ │
│ 一眼看遍所有仓库状态 │ 让 AI 拥有本地代码库的 │
│ 批量操作 + 深度集成 │ 结构化世界观 │
├─────────────────────────────┴───────────────────────────────┤
│ Data Layer │
│ (数据与引擎层) │
│ │
│ Filesystem (Source of Truth) │ SQLite (Lightweight Index) │ Tantivy (Search)
 ─────────────────────────────────────────────────────────────
 vault/ • repos.toml • assets/ registry.db search-index/│
│ │
│ • Git 仓库 + 标记目录的自动发现与持久化 │
│ • Vault 笔记系统（PARA 结构，Obsidian 兼容） │
│ • Stars 历史缓存 (趋势图数据源) │
│ • 代码统计 (tokei) + 模块图 (cargo metadata) │
│ • 安全同步策略 (Mirror / Conservative / Rebase / Merge) │
│ • 操作审计日志与 schema 迁移快照 │
└─────────────────────────────────────────────────────────────┘

TUI-Funktionsübersicht (Human Mode)

Terminal-Benutzeroberfläche basierend auf ratatui, speziell für Multi-Repo-Szenarien entwickelt:

TUI-Bereiche

• Links 35%: Repo-Liste, Status-Icons (⏳ Lädt / ● dirty / ◆ diverged / ▼ behind / ▲ ahead / ✓ normal / ○ kein Remote)

• Rechts 65%: Detailbereich mit drei Tabs

  • Overview: Git-Status, HEAD, SyncPolicy, Tags, Sprachen, Upstream, letzte Synchronisation

  • Health: Vollständiger Gesundheitsbericht (dirty / detached / diverged / ahead / behind)

  • Insights: KI-Intelligenz + Stars Trend Sparkline (Historie der letzten 30 Fetches)

MCP-Tool-Matrix (AI Mode)

Standardisierte Schnittstelle basierend auf dem Model Context Protocol. Unterstützt sowohl stdio (lokale Prozesskommunikation) als auch SSE (HTTP-Streaming).

Integrationsleitfaden für KI-Assistenten

• Claude Code Integration

• 5ire Integration

Warum devbase?

Kein Ersatz, sondern eine Verbindung

KI kann Ihre GUI nicht erkennen

Ihre IDE, Ihr Dateimanager und sogar die Oberfläche von lazygit sind für eine KI unsichtbare Blackboxen. devbase übersetzt den Status, die Struktur und den Gesundheitszustand lokaler Codebasen über den MCP-Server in strukturierte Daten, die die KI verstehen kann — dies ist die Infrastruktur für die Einbindung von KI in lokale Entwicklungsprozesse.

Safe Sync Strategie (Safe Sync)

devbase-Synchronisation ist kein grobes git pull --all, sondern eine abgestufte Sicherheitsstrategie:

Vor der Synchronisation erfolgt ein automatischer Pre-Check: Dirty Workspaces, diverged Branches und geschützte Branches werden übersprungen und im OpLog protokolliert, um Ihre Arbeit niemals zu gefährden.

Intelligente Sync-Vorschläge: Im Sync-Preview-Popup wird unter jedem Repo ein KI-generierter Vorschlag angezeigt, z. B.:

• → Safe to fast-forward 3 commit(s)

• → Working tree dirty — commit or stash before sync

• → Diverged (2 ahead, 3 behind) — switch to Rebase/Merge policy

Funktionsliste

• Workspace-Scan & Registrierung: Automatische Erkennung von Git-Repos sowie Nicht-Git-Workspaces (markiert durch SOUL.md / MEMORY.md / .devbase), persistiert in SQLite

• GitHub Stars Tracking: Anzeige, Caching, TTL-Refresh, historische Trend-Charts

• Code-Statistiken: Integration von tokei für Zeilen, Dateien und Sprachverteilung (wird beim Scan berechnet)

• Rust-Modulgraph: Extraktion von bin/lib/test-Targets via cargo metadata

• Gesundheitscheck: Tracking von dirty / ahead / behind bei Git-Repos sowie blake3-Hash-Snapshot-Änderungserkennung bei Nicht-Git-Workspaces

• Wissensbericht: Tägliche Zusammenfassung basierend auf Repo-Gesundheit und Zusammenfassungen

• TUI-Interaktion: Übersicht, Tag-Clustering, Stars-Sortierung, Suche, KI-Insights, Sparklines, One-Click-Start für gitui/lazygit, intelligente Sync-Vorschläge

• MCP Server: 19 Tools (inkl. 5 Vault-Tools), stdio / SSE-Übertragung

• Natürliche Sprachabfrage: KI kann Repos per Sprache abfragen ("dirty rust repos with more than 100 stars")

• Registry-Backup: export/import/backups/clean, automatische Snapshots vor Schema-Migrationen

• Operation Log (OpLog): Automatische Protokollierung von scan/sync/health für Audits

• i18n: Chinesisch / Englisch Unterstützung

• Datenklassifizierung: public / cooperative / private zur Kontrolle der Synchronisationsgrenzen

Erste Schritte

Installation

One-Click-Installation (empfohlen)

# Windows
irm https://raw.githubusercontent.com/juice094/devbase/main/scripts/install.ps1 | iex

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/juice094/devbase/main/scripts/install.sh | bash

Aus Quellcode bauen

cargo install --path .
# 或未来从 crates.io
# cargo install devbase

Initialisierung

# 扫描并注册当前目录下的所有工作区（Git + 非 Git）
devbase scan . --register

# 查看工作区健康状态
devbase health --detail

# 批量同步全部仓库（fetch-only）
devbase sync

# 生成知识日报
devbase digest

TUI

# 启动 TUI 仪表盘
devbase tui

Gebräuchliche Tasten:

• ↑/↓ Navigation

• / Repo-übergreifende Suche

• Enter Startet gitui/lazygit

• s Sync-Vorschau

• S Sync ausführen

• t Taggen

• o Sortierung umschalten

• r Aktualisieren

• q Beenden

MCP Server

# stdio 模式（本地 AI 助手，如 Claude Desktop / 5ire / Cursor）
devbase mcp

Claude Desktop Konfiguration (claude_desktop_config.json):

{
 "mcpServers": {
 "devbase": {
 "command": "devbase",
 "args": ["mcp"]
 }
 }
}

Cursor Konfiguration (~/.cursor/mcp.json): wie oben.

Aktuell unterstützt MCP nur stdio-Übertragung. SSE-Remote-Modus ist für zukünftige Versionen geplant.

Weitere CLI-Befehle

# 查看操作日志
devbase oplog --limit 20

# 导出 registry 备份
devbase registry export --format json

# 导入备份
devbase registry import backup-20260101.db

Unterstützung für Nicht-Git-Workspaces

devbase verwaltet nicht nur Git-Repos, sondern auch beliebige markierte Verzeichnisse:

Wettbewerbsanalyse

devbase ist kein Git-Client, kein KI-Coding-Assistent, sondern die Infrastruktur, die beides verbindet.

Die vollständige Wettbewerbsanalyse mit 36 Projekten finden Sie unter docs/competitive-analysis.md.

Abhängigkeiten

• Rust 2024 Edition

• SQLite (gebündelt via rusqlite)

• tokei (Code-Statistiken)

• ripgrep (optional, für repo-übergreifende Suche)

• Optional: clarity-core (für LLM-gestützte Repo-Zusammenfassungen)

Datenschutz und Sicherheit

devbase folgt dem Local-First-Prinzip:

• Ihr Code verlässt niemals die lokale Maschine. Registry, Index und Logs werden vollständig in SQLite im Benutzerverzeichnis gespeichert.

• MCP Server kommuniziert nur über stdio (lokale Prozesse) und öffnet keine Netzwerk-Ports.

• GitHub Token / LLM API Key werden lokal in config.toml im Konfigurationsverzeichnis gespeichert und gelangen nicht in Git-Repos.

• .gitignore deckt *.db, .devbase/, *.log, .env* etc. ab, um versehentliche Commits zu verhindern.

Best Practices für die Anmeldedatenverwaltung

# ~/.config/devbase/config.toml (Linux/macOS)
# %LOCALAPPDATA%\devbase\config.toml (Windows)
[github]
token = "<YOUR_GITHUB_PAT>" # NEVER 将此文件提交到版本控制

[llm]
# api_key = "<YOUR_LLM_API_KEY>"

Konfiguration

Die Konfigurationsdatei befindet sich unter:

• Windows: %LOCALAPPDATA%\devbase\config.toml

• Linux/macOS: ~/.config/devbase/config.toml

Beim ersten Start wird automatisch eine kommentierte Standardvorlage generiert.

[github]
# token = "<YOUR_GITHUB_PAT>" # 提高 GitHub API 限流阈值

[sync]
concurrency = 8 # 批量同步并发数
timeout_seconds = 60

cache.ttl_seconds = 3600 # Stars 缓存 TTL

Lizenz

MIT

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers