What problem does it solve?
AI coding agents frequently lose awareness of a project's file tree and exported symbols across sessions, forcing repeated rescans and causing missed context; project-context solves this by maintaining a persistent, queryable snapshot of the project's structure and code summaries in a local SQLite cache.
Core Features & Use Cases
- Incremental init and sync that records file metadata (path, mtime, hash, category) into .cache/context.db without modifying source files.
- Query and validate capabilities to list module files, exported symbols, detect stale entries, and mark deleted files; dependency extraction for inter-file import graphs.
- Knowledge insertion for Deliver-stage extraction (knowledge_edges and knowledge_flows) and a phase guard integration for Plan→Execute→Validate→Deliver workflows.
- Use cases include orchestrator-driven context sensing before route selection, focused module inspection, project-wide dependency analysis, and restoring project awareness across agent sessions.
Quick Start
Run the init action to create a project snapshot and persist structure data to .cache/context.db.