Skip to main content

Crate cbmman

Crate cbmman 

Source
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-mcp process + 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 the codebase-memory-mcp binary (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§

App
JobResult
ProcInfo
Project

Functions§

cbm_bin
format_mcp
Format a cli --json MCP response into display lines. Robust to any leading noise (the binary prints level=info diagnostics 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.