akadmin/headroom
1
0
Fork 0
mirror of https://github.com/headroomlabs-ai/headroom.git synced 2026-08-27 14:17:10 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Make code graph opt-in (--code-graph), update README

Browse source 
Change codebase-memory-mcp from default to opt-in:
- --no-code-graph → --code-graph (explicit enable)
- No regression risk: code graph only activates when user wants it
- With Claude Code's MCP Tool Search, tool tax is ~200 tokens
  when enabled (lazy-loaded, not all 14 tools in every prompt)

Update README wrap examples to show --code-graph flag.
This commit is contained in:
chopratejas 2026-04-11 10:43:16 -07:00
parent b0ed0de37c
commit 331e59cf8d
2 changed files with 20 additions and 15 deletions
Download patch file Download diff file Expand all files Collapse all files

3
README.md
View file

@ -151,9 +151,10 @@ headroom wrap cursor # Starts proxy + prints Cursor config
headroom wrap openclaw # Installs + configures OpenClaw plugin
headroom wrap claude --memory # With persistent cross-agent memory
headroom wrap codex --memory # Shares the same memory store
headroom wrap claude --code-graph # With code graph intelligence (codebase-memory-mcp)
```
Headroom starts a proxy, points your tool at it, and compresses everything automatically. Add `--memory` for persistent memory that's shared across agents.
Headroom starts a proxy, points your tool at it, and compresses everything automatically. Add `--memory` for persistent memory that's shared across agents. Add `--code-graph` for code intelligence via [codebase-memory-mcp](https://github.com/DeusData/codebase-memory-mcp) — indexes your codebase into a knowledge graph for call-chain traversal, impact analysis, and architectural queries.
In Docker-native mode, Headroom still runs in Docker while wrapped tools run on the host. `wrap claude`, `wrap codex`, `wrap aider`, `wrap cursor`, and OpenClaw plugin setup (`wrap openclaw` / `unwrap openclaw`) are host-managed through the installed wrapper.

32
headroom/cli/wrap.py
View file

@ -537,7 +537,7 @@ def _launch_tool(
*,
learn: bool = False,
agent_type: str = "unknown",
no_code_graph: bool = False,
code_graph: bool = False,
backend: str | None = None,
anyllm_provider: str | None = None,
region: str | None = None,
@ -566,7 +566,7 @@ def _launch_tool(
region=region,
)
if not no_code_graph:
if code_graph:
_setup_code_graph(verbose=False)
click.echo()
@ -857,7 +857,9 @@ def unwrap() -> None:
@click.option("--port", "-p", default=8787, type=int, help="Proxy port (default: 8787)")
@click.option("--no-rtk", is_flag=True, help="Skip rtk installation and hook registration")
@click.option(
"--no-code-graph", is_flag=True, help="Skip code graph indexing (codebase-memory-mcp)"
"--code-graph",
is_flag=True,
help="Enable code graph indexing via codebase-memory-mcp (optional)",
)
@click.option("--no-proxy", is_flag=True, help="Skip proxy startup (use existing proxy)")
@click.option(
@ -869,7 +871,7 @@ def unwrap() -> None:
def claude(
port: int,
no_rtk: bool,
no_code_graph: bool,
code_graph: bool,
no_proxy: bool,
learn: bool,
verbose: bool,
@ -887,7 +889,7 @@ def claude(
headroom wrap claude # Start everything
headroom wrap claude --resume <id> # Resume a session
headroom wrap claude -- -p # Claude in print mode
headroom wrap claude --no-code-graph # Skip code graph
headroom wrap claude --code-graph # With code graph intelligence
headroom wrap claude --no-rtk # Skip rtk (proxy only)
"""
if prepare_only:
@ -922,10 +924,8 @@ def claude(
elif verbose:
click.echo(" Skipping rtk (--no-rtk)")
if not no_code_graph:
if code_graph:
_setup_code_graph(verbose=verbose)
elif verbose:
click.echo(" Skipping code graph (--no-code-graph)")
click.echo()
click.echo(" Launching Claude Code (API routed through Headroom)...")
@ -1106,7 +1106,9 @@ def copilot(
@click.option("--port", "-p", default=8787, type=int, help="Proxy port (default: 8787)")
@click.option("--no-rtk", is_flag=True, help="Skip rtk installation and AGENTS.md injection")
@click.option(
"--no-code-graph", is_flag=True, help="Skip code graph indexing (codebase-memory-mcp)"
"--code-graph",
is_flag=True,
help="Enable code graph indexing via codebase-memory-mcp (optional)",
)
@click.option("--no-proxy", is_flag=True, help="Skip proxy startup (use existing proxy)")
@click.option(
@ -1131,7 +1133,7 @@ def copilot(
def codex(
port: int,
no_rtk: bool,
no_code_graph: bool,
code_graph: bool,
no_proxy: bool,
learn: bool,
backend: str | None,
@ -1197,7 +1199,7 @@ def codex(
env_vars_display=[f"OPENAI_BASE_URL=http://127.0.0.1:{port}/v1"],
learn=learn,
agent_type="codex",
no_code_graph=no_code_graph,
code_graph=code_graph,
backend=backend,
anyllm_provider=anyllm_provider,
region=region,
@ -1213,7 +1215,9 @@ def codex(
@click.option("--port", "-p", default=8787, type=int, help="Proxy port (default: 8787)")
@click.option("--no-rtk", is_flag=True, help="Skip rtk installation and conventions injection")
@click.option(
"--no-code-graph", is_flag=True, help="Skip code graph indexing (codebase-memory-mcp)"
"--code-graph",
is_flag=True,
help="Enable code graph indexing via codebase-memory-mcp (optional)",
)
@click.option("--no-proxy", is_flag=True, help="Skip proxy startup (use existing proxy)")
@click.option("--learn", is_flag=True, help="Enable live traffic learning")
@ -1228,7 +1232,7 @@ def codex(
def aider(
port: int,
no_rtk: bool,
no_code_graph: bool,
code_graph: bool,
no_proxy: bool,
learn: bool,
backend: str | None,
@ -1288,7 +1292,7 @@ def aider(
],
learn=learn,
agent_type="aider",
no_code_graph=no_code_graph,
code_graph=code_graph,
backend=backend,
anyllm_provider=anyllm_provider,
region=region,