Skip to content

graff — a fast agentic coding harness in Zig: multi-provider, MCP, workflows, DGM evolution loop, TS/Python SDKs

Python
1.4 KB
Raw Blame

0013. Directory listing is a codedb subcommand, not a catalog tool

Status: accepted 2026-08-20

Context

grok-build's list_dir is a first-class tool: BFS, .gitignore, any folder, 10k-character cap, collapsed subtree summaries. graff already has codedb for structural nav and tells the model to prefer it over bash ls. A new always-on catalog entry would tax every turn — that is how the first #574 A/B lost.

codedb ls / tree are the index. They do not list an extra --add-dir root or an unindexed tree.

Decision

codedb list_dir <path> is implemented in-process in graff (PathConfine, including extra roots) and as a real codedb CLI/MCP command (github.com/justrach/codedb, issue #696 / PR #697). Same algorithm: BFS, gitignore, 10k-character cap. Graff keeps the in-process path so --add-dir and a missing binary still work. codedb ls / tree stay index queries.

Do not add a sibling graff list_dir catalog tool unless an A/B shows the extra schema bytes beat this subcommand.

Consequences

  • Folder listing no longer needs bash ls / find for confined trees.
  • codedb ls / tree stay index queries.
  • The model has to read the codedb description (or the prompt sentence) to find list_dir; that is the cost of not growing the catalog.

The in-process scan budget and partial-result contract are refined by 0184.