Env
Environment variables that affect Codemap CLI and serve.
CLI flags override env when both exist. Prefer project config (Config) for durable settings.
| Variable | Role |
|---|---|
CODEMAP_ROOT |
Project root when --root omitted (also CODEMAP_TEST_BENCH) |
CODEMAP_STATE_DIR |
State directory (default .codemap/); --state-dir wins |
CODEMAP_WATCH |
0 / false opts out of default-ON watcher on mcp / serve |
CODEMAP_NO_WATCH |
1 — same opt-out as CODEMAP_WATCH=0 |
CODEMAP_FORCE_WATCH |
1 — override WSL /mnt/* auto-disable |
CODEMAP_MCP_TOOLS |
Comma-separated MCP tool allowlist (snake_case names) |
CODEMAP_PARSE_TIMEOUT_MS |
Fixed per-file parse budget (ms); unset = 10s + size scaling (cap 30s) |
CODEMAP_PARSE_WORKERS |
Worker pool size (positive integer, max 32) |
CODEMAP_WORKER_RECYCLE_EVERY |
Recycle workers after N files (default 250) |
HTTP serve auth uses --token (not an env default). Watcher / git-hooks guidance: Index lifecycle · Agents & MCP.