Terminal UI (TUI)

Recommended Approach

The TUI is the most user-friendly way to interact with Codegenome. It provides a visual, interactive dashboard to manage your workspace, monitor live evolution, and start MCP servers, making it our highly recommended primary interface.

Launch

codegenome tui

Run this from a directory that already has a graph, or use the TUI controls to point at a workspace and trigger analyze.

Features & Controls

Workspace Info Page: View tracked folders, file extensions, and discovered .gitignore/.genomeignore rules before running scans.
Live Evolve Controls: Launch Live Evolve (Local) or Live Evolve (LAN) directly from the dashboard.
MCP HTTP Modes: Start the MCP HTTP server bound to localhost only or expose it to your LAN with one click.
Fast visual feedback without opening a browser.
Keyboard-driven navigation for large graphs.

Suggested workflow

codegenome tui in your project directory
Check the Workspace Info to verify your ignore patterns
Run analyze or trigger Live Evolve from the UI
Start MCP HTTP (Local or LAN) for your AI agents

Requires the textual dependency (installed automatically with codegenome).