devbase

Sistema operativo de espacio de trabajo para desarrolladores bimodal

Los humanos usan TUI para una visión general, la IA usa MCP para una visión completa de los repositorios locales. Un panel para humanos. Una API para agentes.

devbase es un sistema operativo de espacio de trabajo bimodal local-first: es tanto un panel TUI multi-repositorio diseñado para desarrolladores humanos, como una puerta de entrada de conocimiento estructurado del código para agentes de IA. Hoy en día, cuando la IA no puede reconocer tu GUI ni percibir tu sistema de archivos local, devbase es la única puerta de entrada para que la IA comprenda tu base de código local.

Introducción en una frase

Arquitectura bimodal (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 迁移快照 │
└─────────────────────────────────────────────────────────────┘

Resumen de funciones TUI (Modo humano)

Interfaz de terminal basada en ratatui, diseñada específicamente para escenarios multi-repositorio:

Paneles TUI

• Izquierda 35%: Lista de repositorios, iconos de estado (⏳ cargando / ● sucio / ◆ divergente / ▼ detrás / ▲ delante / ✓ normal / ○ sin remoto)

• Derecha 65%: Panel de detalles de tres pestañas

  • Overview: Estado Git, HEAD, SyncPolicy, etiquetas, lenguaje, upstream, última sincronización

  • Health: Informe de salud completo (sucio / detached / divergente / delante / detrás)

  • Insights: Perspectivas inteligentes de IA + Sparkline de tendencia de Stars (historial de los últimos 30 fetch)

Matriz de herramientas MCP (Modo IA)

Interfaz estandarizada basada en Model Context Protocol. Soporta modo dual stdio (comunicación de proceso local) y SSE (streaming HTTP).

Guía de integración para asistentes de IA

• Integración con Claude Code

• Integración con 5ire

¿Por qué devbase?

No es un reemplazo, es una conexión

La IA no puede reconocer tu GUI

Tu IDE, gestor de archivos e incluso la interfaz de lazygit son cajas negras invisibles para la IA. devbase traduce el estado, la estructura y la salud de tus repositorios locales a datos estructurados que la IA puede entender mediante un servidor MCP — esta es la infraestructura para que la IA intervenga en el flujo de trabajo de desarrollo local.

Estrategia de sincronización segura (Safe Sync)

La sincronización de devbase no es un git pull --all agresivo, sino una estrategia segura por niveles:

Pre-verificación automática antes de sincronizar: los espacios de trabajo sucios, ramas divergentes y ramas protegidas se omiten y registran en el OpLog, nunca destruyendo tu trabajo sin permiso.

Sugerencias de sincronización inteligente: En la ventana de Sync Preview, debajo de cada repositorio se mostrará una sugerencia generada por IA, por ejemplo:

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

Lista de funciones

• Escaneo y registro de espacios de trabajo: Descubrimiento automático de repositorios Git y espacios de trabajo no Git marcados con SOUL.md / MEMORY.md / .devbase, persistidos en SQLite

• Seguimiento de GitHub Stars: Visualización, caché, actualización TTL, gráfico de tendencias históricas

• Estadísticas de código: Integración con tokei, conteo de líneas, archivos y distribución de lenguajes (calculado automáticamente al escanear)

• Grafo de módulos Rust: Extracción de objetivos bin/lib/test mediante cargo metadata

• Comprobación de salud: Seguimiento de estados dirty / ahead / behind en repositorios Git, y detección de cambios mediante instantáneas hash blake3 para espacios no Git

• Resumen diario de conocimiento: Generación de informes basados en el estado de salud y resúmenes de repositorios

• Interfaz TUI: Resumen de salud multi-repositorio, ordenamiento por etiquetas, ordenamiento por Stars, búsqueda de código entre repositorios /, panel de Insights de IA, sparkline de tendencias, inicio rápido de gitui/lazygit, sugerencias de sincronización inteligente

• Servidor MCP: 19 herramientas (incluyendo 5 herramientas de vault), transporte dual stdio / SSE

• Consulta en lenguaje natural: La IA puede consultar repositorios mediante lenguaje natural

• Copia de seguridad del registro: export/import/backups/clean, instantánea automática antes de migración de esquema

• Registro de operaciones (OpLog): Registro automático de scan/sync/health, auditable

• i18n: Soporte bilingüe chino / inglés

• Clasificación de datos: Tres niveles: public / cooperative / private, para controlar los límites de sincronización

Inicio rápido

Instalación

Instalación con un clic (recomendado)

# 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

Construir desde el código fuente

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

Inicialización

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

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

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

# 生成知识日报
devbase digest

TUI

# 启动 TUI 仪表盘
devbase tui

Atajos comunes:

• ↑/↓ Navegar repositorios

• / Buscar código entre repositorios

• Enter Iniciar gitui/lazygit (si está instalado)

• s Previsualizar sincronización

• S Ejecutar sincronización

• t Etiquetar

• o Cambiar orden (Status ↔ Stars)

• r Actualizar

• q Salir

Servidor MCP

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

Configuración de Claude Desktop (claude_desktop_config.json):

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

Configuración de Cursor (~/.cursor/mcp.json): Igual que el anterior.

Actualmente, MCP solo soporta transporte stdio. El modo remoto SSE está planeado para futuras versiones.

Otros comandos CLI

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

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

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

Soporte para espacios de trabajo no Git

devbase no solo gestiona repositorios Git, sino también cualquier directorio marcado:

Análisis de la competencia

devbase no es un cliente Git, no es un asistente de codificación IA, es la infraestructura que conecta ambos.

El análisis completo de 36 competidores se encuentra en docs/competitive-analysis.md.

Dependencias

• Rust 2024 edition

• SQLite (incluido vía rusqlite)

• tokei (estadísticas de código)

• ripgrep (opcional, para búsqueda entre repositorios)

• Opcional: clarity-core (para generación de resúmenes de repositorios impulsada por LLM)

Privacidad y seguridad

devbase sigue el principio Local-First:

• Tu código nunca sale de tu máquina local. El registro, los índices y los registros se almacenan en SQLite dentro del directorio del usuario.

• El servidor MCP solo se comunica a través de procesos locales stdio, no escucha ningún puerto de red.

• GitHub Token / LLM API Key se almacenan localmente en config.toml, archivo ubicado en el directorio de configuración del usuario, y no se incluyen en el repositorio Git.

• .gitignore ya cubre *.db, .devbase/, *.log, .env* y otros archivos sensibles para evitar confirmaciones accidentales.

Mejores prácticas de gestión de credenciales

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

[llm]
# api_key = "<YOUR_LLM_API_KEY>"

Configuración

El archivo de configuración se encuentra en:

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

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

La primera ejecución generará automáticamente una plantilla predeterminada con comentarios.

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

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

cache.ttl_seconds = 3600 # Stars 缓存 TTL

Licencia

MIT

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers