devbase

Bimodal Developer Workspace OS

One dashboard for humans. One API for agents.

devbase is a local-first bimodal workspace OS: it serves as both a multi-repo TUI dashboard designed for human developers and a structured codebase knowledge gateway for AI agents. In an era where AI cannot recognize your GUI or perceive your local file system, devbase is the sole gateway for AI to understand your local codebase.

Overview

Related MCP server: auxly-memory-cli

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 Features (Human Mode)

Terminal interface based on ratatui, designed for multi-repo scenarios:

TUI Panels

• Left 35%: Repo list, status icons (⏳ Loading / ● dirty / ◆ diverged / ▼ behind / ▲ ahead / ✓ clean / ○ no remote)

• Right 65%: Three-tab detail panel

  • Overview: Git status, HEAD, SyncPolicy, tags, language, upstream, last sync

  • Health: Full health report (dirty / detached / diverged / ahead / behind)

  • Insights: AI-powered insights + Stars Trend Sparkline (history of last 30 fetches)

MCP Tool Matrix (AI Mode)

Standardized interface based on Model Context Protocol. Supports both stdio (local process communication) and SSE (HTTP streaming) modes.

AI Assistant Integration Guide

• Claude Code Integration

• 5ire Integration

Why devbase?

Not a replacement, but a connection

AI cannot recognize your GUI

Your IDE, file manager, and even lazygit's interface are black boxes invisible to AI. devbase uses an MCP Server to translate the status, structure, and health of your local codebase into structured data that AI can understand—this is the infrastructure for AI to intervene in local development workflows.

Safe Sync Policy

devbase's sync is not a blunt git pull --all, but a tiered safe policy:

Pre-sync auto-checks: dirty workspaces, diverged branches, and protected branches are skipped and logged to OpLog, ensuring your work is never destroyed.

Smart Sync Suggestions: In the Sync Preview popup, AI-generated suggestions appear below each repo, e.g.:

• → 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

Feature List

• Workspace Scanning & Registration: Auto-discover Git repos and non-Git workspaces marked by SOUL.md / MEMORY.md / .devbase, persisted in SQLite

• GitHub Stars Tracking: Display, cache, TTL refresh, historical trend charts

• Code Statistics: Integrated tokei for lines of code, file counts, language distribution (calculated during scan)

• Rust Module Graph: Extract bin/lib/test targets via cargo metadata

• Health Check: Track Git repo dirty/ahead/behind, plus blake3 hash snapshot change detection for non-Git workspaces

• Knowledge Digest: Generate daily briefings based on repo health and summaries

• TUI Interface:

  • Multi-repo health overview, tag clustering, Stars sorting

  • Cross-repo code search /

  • AI Insights panel

  • Stars Trend sparkline

  • One-click launch of gitui/lazygit

  • Smart sync suggestions

• MCP Server: 19 tools (including 5 vault tools), stdio / SSE dual transport

• Natural Language Query: AI can query repos via natural language ("dirty rust repos with more than 100 stars")

• Registry Backup: export/import/backups/clean, auto-snapshot before schema migration

• Operation Log (OpLog): scan/sync/health auto-logged for auditability

• i18n: Chinese / English bilingual support

• Data Tiering: public / cooperative / private levels to control sync boundaries

Quick Start

Installation

One-click install (Recommended)

# 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

Build from source

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

Initialization

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

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

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

# 生成知识日报
devbase digest

TUI

# 启动 TUI 仪表盘
devbase tui

Common keys:

• ↑/↓ Navigate repos

• / Cross-repo code search

• Enter Launch gitui/lazygit (if installed)

• s Preview sync

• S Execute sync

• t Tag

• o Toggle sort (Status ↔ Stars)

• r Refresh

• q Quit

MCP Server

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

Claude Desktop Configuration (claude_desktop_config.json):

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

Cursor Configuration (~/.cursor/mcp.json): Same as above.

Current MCP only supports stdio transport. SSE remote mode is planned for future versions.

Other CLI Commands

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

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

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

Non-Git Workspace Support

devbase manages not only Git repos but also any marked directory:

Competitive Analysis

devbase is not a Git client or an AI coding assistant, but the infrastructure connecting the two.

Full 36-item competitive analysis available at docs/competitive-analysis.md.

Dependencies

• Rust 2024 edition

• SQLite (bundled via rusqlite)

• tokei (code stats)

• ripgrep (optional, for cross-repo search)

• Optional: clarity-core (for LLM-driven repo summary generation)

Privacy & Security

devbase follows the Local-First principle:

• Your code never leaves your local machine. Registry, indexes, and logs are all stored in SQLite within the user directory

• MCP Server communicates only via stdio local process, listening on no network ports

• GitHub Token / LLM API Key are stored locally in config.toml within the user config directory, never committed to Git repos

• .gitignore covers *.db, .devbase/, *.log, .env*, etc., to prevent accidental commits

Credential Management Best Practices

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

[llm]
# api_key = "<YOUR_LLM_API_KEY>"

Configuration

Configuration file located at:

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

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

First run will auto-generate a default template with comments.

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

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

cache.ttl_seconds = 3600  # Stars 缓存 TTL

License

MIT