de en es ja ko ru zh

devbase

Name: devbase
Author: juice094

by juice094

Overview Schema Source Related Servers Discussions Admin

Rust

Local

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityNo data

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

ainote B
io.github.seunghan91
Agent-native notes, tasks, dev-docs, vaults, sync & handoffs. MCP + OpenAPI dual surface.
Note Taking Developer Tools Knowledge & Memory
353
innernetOAuth
live.innernet
Your versioned memory across every AI tool — context maps, personal memory, and tasks over MCP.
Knowledge & Memory Project Management
2
memsprout AOAuth
com.memsprout
shared AI-context layer for teams — persistent memory your agents search and update over MCP
Knowledge & Memory RAG Systems
2
ctlsurf B
com.ctlsurf
System-of-record notebook for AI coding agents: pages, datastores, tasks, skills over MCP.
Autonomous Agents Developer Tools Knowledge & Memory
482

Related MCP Servers

agent-memory
Knowledge & Memory Developer Tools
xChuCx
A
license
A
quality
A
maintenance
Local, searchable project memory for AI coding agents. Markdown source of truth, MCP interface, safe structured updates
Updated a day ago (2026-09-25 12:51 UTC)
3
11
Apache 2.0
auxly-memory-cli
Knowledge & Memory File Systems
Tzamun-Arabia-IT-Co
A
license
Not graded
quality
A
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.
Updated 2 days ago (2026-09-25 06:45 UTC)
2
MIT
devrecall
Knowledge & Memory Search Version Control
pavelpilyak
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.
Updated 16 days ago (2026-09-10 23:20 UTC)
17
4
MIT
GPTkms
Knowledge & Memory File Systems
sc28249782
A
license
Not graded
quality
B
maintenance
Local-first Knowledge Management System that exposes markdown-based durable memory as MCP tools for Codex and ChatGPT, enabling search, read, write, and promotion workflows with project and global scopes.
Updated 2 months ago (2026-07-17 11:14 UTC)
MIT

Appeared in Searches

GitHub repository for litopys-dev/litopys project

devbase

一言で言うと

バイモーダル・アーキテクチャ (Bimodal Architecture)

TUI 機能一覧 (Human Mode)

TUI パネル

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

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

なぜ devbase なのか？

代替ではなく、接続

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

安全な同期戦略 (Safe Sync)

機能リスト

クイックスタート

インストール

初期化

TUI

MCP Server

その他の CLI コマンド

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

競合分析

依存関係

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

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

設定

ライセンス

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

agent-memory

auxly-memory-cli

devrecall

GPTkms

Appeared in Searches