Skip to main content
Glama
deenesjakoruzh
juice094

devbase

by juice094
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Rust
Local

devbase

이중 모드 개발자 워크스페이스 OS — Bimodal Developer Workspace OS

인간은 TUI로 산을 조망하고, AI는 MCP로 로컬 저장소를 통찰한다. One dashboard for humans. One API for agents.

devbase는 로컬 우선 이중 모드 워크스페이스 운영체제입니다. 인간 개발자를 위한 다중 저장소 TUI 대시보드이자, AI 에이전트에게 구조화된 코드베이스 지식 입구를 제공합니다. AI가 당신의 GUI를 인식하지 못하고 로컬 파일 시스템을 감지할 수 없는 오늘날, devbase는 AI가 당신의 로컬 코드베이스를 이해하게 하는 유일한 입구입니다.

한 줄 소개

당신은 누구인가

devbase가 당신을 위해 하는 일

인간 개발자

devbase tui로 터미널 대시보드를 열어 50개 저장소의 Git 상태를 한눈에 파악하고, s를 눌러 일괄 안전 동기화

AI 에이전트

MCP를 통해 devkit_vault_search를 호출하여 AI가 당신의 노트와 저장소를 검색/읽기/쓰기 가능 — 더 이상 블랙박스가 아님

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 생성 (dry-run 미리보기)

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 Trend Sparkline (최근 30회 fetch 이력)

MCP Tool 매트릭스 (AI Mode)

Model Context Protocol 기반의 표준화된 인터페이스. stdio(로컬 프로세스 통신)와 SSE(HTTP 스트리밍) 이중 모드를 지원합니다.

도구

기능

예시 쿼리

devkit_scan

디렉토리 스캔 및 워크스페이스 등록

"~/projects 스캔"

devkit_health

상태 점검 (모든 저장소 상태)

"로컬 프로젝트 중 동기화가 필요한 것은?"

devkit_sync

일괄 동기화 (기본값 dry-run)

"이 저장소들을 동기화하면 어떻게 되는지 미리보기"

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

로컬 커밋을 원격 브랜치로 자동 rebase

개인 브랜치, 선형 이력 유지

🟢 Green

Merge

원격 변경 사항 자동 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 Trend sparkline

    • 원클릭 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

Related MCP Connectors

Related MCP Servers

  • auxly-memory-cli

    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.
    2
    MIT

  • devrecall

    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.
    17
    4
    MIT

  • GPTkms

    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.
    MIT

Appeared in Searches