Command reference
analyze
Tree-sitter scan, AST extraction, graph build, SQLite persistence.
codegenome analyze [PATH]
| Argument | Default | Description |
|---|---|---|
PATH | . | Workspace directory to analyze |
Example:
codegenome analyze . codegenome analyze /home/dev/my-app
export
Export the current graph store. Requires a prior analyze.
codegenome export --format FORMAT [--path PATH]
| Option | Required | Description |
|---|---|---|
--format | Yes | obsidian, html, cypher, json |
--path | No | Workspace (default .) |
codegenome export --format html --path . codegenome export --format obsidian --path .
mcp-start
Start MCP server with stdio or HTTP transport for the workspace database.
codegenome mcp-start [--path PATH] [--transport TRANSPORT] [--port PORT] [--lan]
| Option | Default | Description |
|---|---|---|
--path | . | Workspace directory to host |
--transport | stdio | Transport method: stdio or http |
--port | 7331 | HTTP port to bind (if using http) |
--lan | off | Bind HTTP to 0.0.0.0 for LAN access |
Note: --lan makes the MCP server available to other devices on the same network.
evolve
Initial build, optional WebSocket live mode, HTTP graph UI, file watcher for .py files.
codegenome evolve [--live] [--lan] [PATH]
| Flag | Description |
|---|---|
--live | Enable WebSocket broadcast on ws://127.0.0.1:8765 |
--lan | Share live graph over LAN (binds to 0.0.0.0) |
PATH | Workspace (default .) |
rules
Generate agent instruction files (Cursor rules, Copilot, AGENTS.md, etc.).
codegenome rules [--client CLIENT]... [--port PORT] [--dry-run] [PATH]
| Option | Default | Description |
|---|---|---|
--client | all | cursor, copilot, windsurf, agents, all (repeatable) |
--port | 7331 | MCP port embedded in templates |
--dry-run | off | Print paths without writing |
codegenome rules --client cursor --port 7331 . codegenome rules --client all --dry-run .
tui
Launch the Textual interactive dashboard.
codegenome tui
No arguments. See Terminal UI.