tao-context-mode

What problem does it solve?

It solves the problem of overwhelming LLM context windows by forcing agents to choose between shallow repo awareness and expensive full-file reads.

Core Features & Use Cases

• Summary-indexing of repositories: Builds a compact CodebaseIndex with per-file summaries and lightweight symbols by walking the repo once.
• On-demand expansion via expand(path): Returns the full file contents only for paths explicitly needed for the current task.
• Deterministic, low-cost synopsis: Uses pure regex and first-comment synopsis to avoid LLM calls while supporting sha256-keyed invalidation for repeat runs.
• Operational use in TAO loops: Fits planner and agent iteration workflows by providing fast “where does X live?” lookups and reducing token pressure during successive iterations.

Quick Start

Ask your agent to build the index for your repo root and then expand the specific file path it needs for the current task (for example, expand("app/server/main.py")).