Expand description
cbmman — interactive TUI manager for codebase-memory-mcp.
A terminal UI for indexing and querying codebase knowledge graphs without
hand-writing MCP JSON tool calls. Two implementations ship together:
cbmman.sh (bash + tuish) and the Rust
crate (ratatui + crossterm).
§Install
cargo install cbmman
cbmman§What it does
- Projects — list indexed projects (branch, nodes, edges, size, root
path), then run per-project actions: index status, architecture overview,
index coverage, git-diff impact (
detect_changes), re-scan, delete. - Scan / Index — add a repo (
moderate/full/fast/cross-repo), optional artifact persistence (.codebase-memory/graph.db.zst). - Graph server (UI) — start/stop the 3D UI, set port, open in browser.
- Processes & resources — live
codebase-memory-mcpprocess + artifact monitor (auto-refresh). - Configuration — edit persisted settings (
auto_index,ui_port, …). - Graph queries — search graph/code, get snippet, trace paths, Cypher, architecture, schema, ingest traces.
- ADR — manage architecture decision records; Maintenance — version, help, update, cache diagnostics.
§Crate API
The binary is the primary interface (cargo run). The library surface is
intentionally small — see App, Project, and the run_* helpers.
§Env
CBM_BIN— path to thecodebase-memory-mcpbinary (default: PATH).CBM_CACHE_DIR— cache dir for the process monitor.
§Website
https://handyutils.github.io/cbmman/
§Upstream
https://github.com/DeusData/codebase-memory-mcp https://github.com/handyutils/cbmman
Structs§
Functions§
- cbm_bin
- format_
mcp - Format a
cli --jsonMCP response into display lines. Robust to any leading noise (the binary printslevel=infodiagnostics on stderr, which we ignore, but also defensively skips non-JSON prefixes on stdout). - human_
size - main
- parse_
config - parse_
projects - run_app
- run_
tool - Run
cbm cli --json <tool> '<args>'and format the MCP response. - run_
tool_ raw - Run
cbm cli --json <tool> '<args>'and return the RAW stdout (as lines). The binary prints diagnostics on stderr, which is deliberately ignored.