devbase

Bimodal Developer Workspace OS — バイモーダル開発者ワークスペースOS

人間は TUI で全体を俯瞰し、AI は MCP でローカルリポジトリを把握する。 One dashboard for humans. One API for agents.

devbase はローカルファーストなバイモーダル・ワークスペースOSです。人間向けにはマルチリポジトリ対応のTUIダッシュボードとして、AIエージェント向けには構造化されたコードベース知識の入り口として機能します。AIがGUIを認識できず、ローカルファイルシステムを把握できない現在、devbaseはAIがあなたのローカルコードベースを理解するための唯一の入り口となります。

一言で言うと

バイモーダル・アーキテクチャ (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 機能一覧 (Human Mode)

ratatui ベースのターミナルインターフェース。マルチリポジトリ環境に特化しています：

TUI パネル

• 左側 35%：リポジトリリスト、ステータスアイコン（⏳ ロード中 / ● dirty / ◆ diverged / ▼ behind / ▲ ahead / ✓ 正常 / ○ リモートなし）

• 右側 65%：3タブ構成の詳細パネル

  • Overview：Gitステータス、HEAD、SyncPolicy、タグ、言語、upstream、最終同期日時

  • Health：詳細な健全性レポート（dirty / detached / diverged / ahead / behind）

  • Insights：AIによるインサイト + Starsトレンドのスパークライン（直近30回のfetch履歴）

MCP Tool マトリックス (AI Mode)

Model Context Protocol に準拠した標準化インターフェース。stdio（ローカルプロセス通信）と SSE（HTTPストリーミング）の両モードをサポート。

AI アシスタント統合ガイド

• Claude Code 統合

• 5ire 統合

なぜ devbase なのか？

代替ではなく、接続

AI はあなたの GUI を認識できない

IDE、ファイルマネージャー、あるいは lazygit のインターフェースでさえ、AI にとっては不可視のブラックボックスです。devbase は MCP Server を通じて、ローカルコードベースの状態、構造、健全性をAIが理解できる構造化データに変換します。これはAIがローカル開発フローに介入するためのインフラストラクチャです。

安全な同期戦略 (Safe Sync)

devbase の同期は単なる git pull --all ではなく、段階的な安全戦略を採用しています：

同期前に自動プレチェック：dirty なワークスペース、diverged なブランチ、protected なブランチはスキップされ、OpLog に記録されます。あなたの作業成果を勝手に破壊することはありません。

スマート同期提案：Sync Preview ダイアログでは、各リポジトリの下にAIが生成した同期提案が表示されます。例：

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

機能リスト

• ワークスペースのスキャンと登録：Gitリポジトリ および SOUL.md / MEMORY.md / .devbase でマークされた非Gitワークスペースを自動検出し、SQLite に永続化

• GitHub Stars トラッキング：表示、キャッシュ、TTL更新、履歴トレンドグラフ

• コード統計：tokei を統合し、行数、ファイル数、言語分布を算出（スキャン時に自動計算）

• Rust モジュールグラフ：cargo metadata を通じて bin/lib/test ターゲットを抽出

• 健全性チェック：Gitリポジトリの dirty / ahead / behind、および非Gitワークスペースの blake3 ハッシュスナップショットによる変更検知

• 知識日報：リポジトリの健全性状態と要約に基づき、毎日のブリーフィングを生成

• TUI インターフェース：

  • マルチリポジトリ健全性概要、タグによるクラスタリング・ソート、Starsソート

  • リポジトリ横断コード検索 /

  • AI Insights パネル

  • Stars トレンドのスパークライン

  • gitui/lazygit のワンタッチ起動

  • スマート同期提案

• MCP Server：19種類のツール（5種類のvaultツールを含む）、stdio / SSE デュアル転送

• 自然言語クエリ：AIが自然言語でリポジトリをクエリ可能（"dirty rust repos with more than 100 stars"）

• Registry バックアップ：export/import/backups/clean、スキーマ移行前の自動スナップショット

• 操作ログ (OpLog)：scan/sync/health を自動記録し、監査可能

• i18n：中国語 / 英語のバイリンガル対応

• データ分類：public / cooperative / private の3段階で同期境界を制御

クイックスタート

インストール

ワンクリックインストール（推奨）

# 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

ソースからビルド

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

初期化

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

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

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

# 生成知识日报
devbase digest

TUI

# 启动 TUI 仪表盘
devbase tui

よく使うキー：

• ↑/↓ リポジトリのナビゲーション

• / リポジトリ横断コード検索

• Enter gitui/lazygit の起動（インストール済みの場合）

• s 同期プレビュー

• S 同期実行

• t タグ付け

• o ソート切替（Status ↔ Stars）

• r 更新

• q 終了

MCP Server

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

Claude Desktop 設定（claude_desktop_config.json）：

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

Cursor 設定（~/.cursor/mcp.json）：上記と同様。

現在、MCP は stdio 転送のみをサポートしています。SSE リモートモードは将来のバージョンで提供予定です。

その他の CLI コマンド

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

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

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

非 Git ワークスペースのサポート

devbase は Git リポジトリだけでなく、マークされた任意のディレクトリも管理可能です：

競合分析

devbase は Git クライアントでも AI コーディングアシスタントでもなく、両者を接続するインフラストラクチャです。

36項目の完全な競合分析は docs/competitive-analysis.md を参照してください。

依存関係

• Rust 2024 edition

• SQLite (rusqlite 経由でバンドル)

• tokei (コード統計)

• ripgrep（オプション、リポジトリ横断検索用）

• オプション：clarity-core（LLM駆動のリポジトリ要約生成用）

プライバシーとセキュリティ

devbase は**ローカルファースト（Local-First）**原則に従います：

• コードがローカルマシンから出ることはありません。Registry、インデックス、ログはすべてユーザーディレクトリ内の SQLite に保存されます。

• MCP Server は stdio ローカルプロセス通信のみを行い、ネットワークポートをリッスンしません。

• GitHub Token / LLM API Key はローカルの config.toml に保存されます。このファイルはユーザー設定ディレクトリにあり、Git リポジトリには含まれません。

• .gitignore は *.db、.devbase/、*.log、.env* などの機密ファイルをカバーしており、誤ってコミットされるのを防ぎます。

認証情報管理のベストプラクティス

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

[llm]
# api_key = "<YOUR_LLM_API_KEY>"

設定

設定ファイルは以下にあります：

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

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

初回実行時にコメント付きのデフォルトテンプレートが自動生成されます。

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

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

cache.ttl_seconds = 3600 # Stars 缓存 TTL

ライセンス

MIT

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers