Skip to main content
Glama

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があなたのローカルコードベースを理解するための唯一の入り口となります。


一言で言うと

あなたの役割

devbase が提供するもの

人間(開発者)

devbase tui でターミナルダッシュボードを開き、50個のリポジトリのGit状態を一目で確認。s キーで一括安全同期

AI エージェント

MCP を通じて devkit_vault_search を呼び出し、ノートやリポジトリを検索・読み書き可能に。ブラックボックスを解消


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 機能一覧 (Human Mode)

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

キー

機能

↑/↓

リポジトリリストのナビゲーション

PgUp/PgDn

ページ送り

Home/End

リストの先頭/末尾へ移動

/

リポジトリ横断コード検索 — Tantivy によるセマンティック検索 / ripgrep によるコード検索(Ctrl+R でモード切替)

Enter

gitui / lazygit を起動してリポジトリごとの詳細操作(自動検知してターミナルを一時停止/再開)

s

Safe Sync Preview(ドライラン)の生成

S

安全な同期の実行

t

選択したリポジトリにタグ付け

o

ソートモード切替:Status ↔ Stars

Tab / Shift+Tab

詳細パネルのタブ切替:Overview ↔ Health ↔ Insights

r

リポジトリリストの更新

h / ? / F1

ショートカットヘルプの表示

q / Esc

終了 / ダイアログを閉じる

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ストリーミング)の両モードをサポート。

Tool

機能

クエリ例

devkit_scan

ディレクトリをスキャンしてワークスペースに登録

"~/projects をスキャンして"

devkit_health

健全性チェック(全リポジトリの状態)

"同期が必要なローカルプロジェクトは?"

devkit_sync

一括同期(デフォルトはドライラン)

"これらのリポジトリを同期するとどうなるかプレビューして"

devkit_query_repos

構造化クエリ(言語/タグ/状態)

"dirty な Rust プロジェクトをすべてリストアップして"

devkit_code_metrics

コード統計(行数、ファイル数、言語)

"一番大きなプロジェクトはどれ?"

devkit_module_graph

Rust モジュール/ターゲット構造

"devbase にはどんなバイナリターゲットがある?"

devkit_natural_language_query

自然言語クエリ

"show dirty rust repos with more than 100 stars"

devkit_index

リポジトリの要約とモジュール構造のインデックス化

"全リポジトリの知識インデックスを作成して"

devkit_query

ナレッジベース検索(tantivy)

"sync policy に関する知識を検索して"

devkit_note

リポジトリへのノート追加

"devbase プロジェクトにノートを追加して"

devkit_digest

日次ナレッジレポートの生成

"今日の知識日報を作成して"

devkit_github_info

GitHub メタデータの照会

"devbase プロジェクトのスター数は?"

devkit_paper_index

PDF 論文のインデックス化

"~/papers ディレクトリをインデックス化して"

devkit_experiment_log

実験実行の記録

"今回の実験設定を記録して"

devkit_vault_search

Vault ノートの検索

"API 設計に関するノートを検索して"

devkit_vault_read

Vault ノートの内容読み取り

"01-Projects/devbase.md を読んで"

devkit_vault_write

Vault ノートの作成/更新

"リファクタリングに関する新しいノートを作成して"

devkit_vault_backlinks

ノートのバックリンク照会

"どのノートが devbase にリンクしている?"

devkit_project_context

統合プロジェクトコンテキスト

"devbase プロジェクトの repo + vault + assets の全体像を取得して"

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


なぜ devbase なのか?

代替ではなく、接続

ツール

位置付け

devbase の役割

lazygit

単一リポジトリTUI、人間による操作

devbase はマルチリポジトリの入り口 — lazygit の前に「どのリポジトリに注目すべきか」を教え、Enter で即座に詳細操作へ移行

gitui

軽量 Rust TUI

devbase の詳細操作パートナー — 一括管理後の細かい操作は gitui に委任

5ire / Claude Code

AI アシスタント、対話型プログラミング

devbase はコードベースの知識源 — AI にローカルワークスペースの構造化コンテキストを与え、「盲人象を撫でる」状態を解消

GitHub Desktop

GUI Git クライアント

devbase は TUI 代替案 — 30倍軽量、SSH環境でも動作、一括操作対応

GitHub / GitLab

リモートコードホスティング

devbase はローカルミラーの管理者 — リモート同期の一括管理、dirty/diverged の自動保護

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

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


安全な同期戦略 (Safe Sync)

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

戦略

動作

適用シーン

TUI カラー

Mirror

fetch のみ、ローカルブランチは変更しない

参照用リポジトリ、サードパーティ依存

🔵 Blue

Conservative

fast-forward のみ、diverged は自動スキップ

日常開発、安全第一

🟡 Yellow

Rebase

ローカルコミットをリモートブランチに自動リベース

個人ブランチ、履歴を線形に保つ

🟢 Green

Merge

リモート変更を自動マージ

共同作業ブランチ、マージ履歴を保持

🟣 Magenta

同期前に自動プレチェック: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 リポジトリだけでなく、マークされた任意のディレクトリも管理可能です:

マークファイル

ワークスペースタイプ

変更検知

.git/

git

git2 ahead/behind/dirty

SOUL.md / .claude/

openclaw

blake3 ハッシュスナップショット

MEMORY.md / .devbase

generic

blake3 ハッシュスナップショット


競合分析

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

競合

カテゴリ

関係

lazygit

単一リポジトリ Git TUI

補完 — devbase はマルチリポジトリの入り口、lazygit は単一リポジトリの詳細操作

gitui

単一リポジトリ Git TUI

補完 — 同上

GitHub Desktop

Git GUI

無関係 — ターゲットユーザーが異なる、devbase は TUI ソリューション

5ire

AI アシスタント + ナレッジベース

競合・協力 — 5ire は MCP Client、devbase は MCP Server

Claude Code

AI コーディングアシスタント

上下流 — Claude が devbase を呼び出してローカルコンテキストを取得

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

A
license - permissive license
-
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
2dRelease cycle
13Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    B
    maintenance
    Local-first, file-based memory layer for AI agents — one shared Markdown vault across Claude, Codex, Gemini, Cursor and any MCP client. Provides read/write memory tools with an audit trail, per-agent trust levels, and Git sync; no cloud and no lock-in.
    Last updated
    2
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Local-first dev memory: indexes Git commits, PRs, Jira/Linear tickets, Confluence docs, Slack threads, and Calendar events into a local SQLite/FTS5/ONNX index, and exposes them as MCP tools so Claude Code, Cursor, and Codex can search and cite your past work.
    Last updated
    17
    3
    MIT
  • A
    license
    -
    quality
    B
    maintenance
    Local-first code intelligence and safety layer for AI coding agents. MCP server exposes dependency graph, impact analysis, and AST-compressed repo context, backed by typed local memory, patch-scope safety gates, and git-independent transaction rollback.
    Last updated
    MIT

View all related MCP servers

Related MCP Connectors

  • User-owned memory for AI agents, Copilot, Claude, IDEs, CLIs, and chat apps over remote MCP.

  • Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.

  • The project brain for AI coding agents — memory, decisions, sprints, knowledge base via MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/juice094/devbase'

If you have feedback or need assistance with the MCP directory API, please join our Discord server