TUI · codebase-memory-mcp

Manage your knowledge graphs
from the terminal.

cbmman is a human-friendly TUI for codebase-memory-mcp — index, query and monitor codebase graphs without hand-writing JSON tool calls. Two implementations: bash + tuish and Rust + ratatui.

Quick start → View on GitHub crates.io

Install (Rust)

cargo install cbmman

Run (bash)

./cbmman.sh

Run (Rust)

cbmman

Source

github.com/handyutils/cbmman

Latest release:

View on GitHub

Quick start

Make sure codebase-memory-mcp is installed and on your PATH (or set CBM_BIN).

codebase-memory-mcp --version
# Bash (tuish is vendored in ./tuish; auto-cloned if missing)
./cbmman.sh
# Rust
cargo install cbmman
cbmman

Non-interactive pass-through for scripting:

./cbmman.sh cli search_graph '{"project":"my-project","query":"order handler"}'
./cbmman.sh --version

Installation

Bash + tuish

bash 4+, python3
tuish vendored in tuish/ (1.3 MB) — no network on first run
Fallback: auto-clones from GitHub if tuish/ is deleted

git clone https://github.com/handyutils/cbmman
cd cbmman
./cbmman.sh

Rust + ratatui

Rust toolchain (cargo)
Crates: ratatui 0.29, crossterm 0.28

cargo install cbmman
cbmman
# or from source
cargo run --release

Binary also ships as ./cbmman next to cbmman.rs in ~/.scripts/codebase/.

Usage

↑↓ navigate · Enter select · 1–8, 0 jump · Esc back · q quit · Ctrl-C anywhere

Main menu has 8 items: Projects, Scan, Graph server, Processes, Configuration, Graph queries, ADR, Maintenance.

Commands

Every long-running operation runs in the background with a spinner — the UI never freezes. Search above filters this list.

No matches. Try a different query.

Configuration

Edited via the TUI (Configuration → SAVE ALL) or CLI: codebase-memory-mcp config set <key> <value>

Key	Default	Notes
auto_index	false	auto-index on connect
auto_index_limit	50000	file limit for auto-index
auto_watch	true	background re-index on changes
ui_enabled	true	graph UI server
ui_port	9749	http://localhost:9749
ui-lang	auto	UI language

Environment

Variable	Default	Purpose
CBM_BIN	codebase-memory-mcp	binary location
TUISH_DIR	./tuish	bash: tuish checkout dir
CBM_CACHE_DIR	~/.cache/codebase-memory-mcp	process & artifact monitor

CLI pass-through

For scripting, bypass the TUI:

./cbmman.sh cli search_graph '{"project":"p","query":"q"}'
./cbmman.sh cli index_status '{"project":"p"}'
./cbmman.sh --version
cbmman cli get_architecture '{"project":"p","aspects":["clusters"]}'

See codebase-memory-mcp for all tool names and args.

Manage your knowledge graphsfrom the terminal.