Repoctx

repoctx

[](https://go.dev/doc/install) [](https://github.com/SrIruma/repoctx/actions) [](https://github.com/SrIruma/repoctx/releases) [](https://github.com/SrIruma/repoctx/releases) [](LICENSE)

**Status:** pre-1.0 (0.x), active development. The machine contract (docs/contract.md) is documented but deliberately not frozen while the tool is validated in real use — validation against real repositories is part of the test suite, see [Validation](docs/validation.md). Feedback and issues are welcome.

repoctx keeps your AI coding-agent context files (`AGENTS.md`, `CLAUDE.md`) truthful. It scans a repository, extracts facts from the real code — build/test commands, module structure, dependencies — and uses them to regenerate the factual sections of your context files, preserving anything a human wrote.


Why

Context files rot. A README mentions a `make release` target that no longer exists; `AGENTS.md` lists `backend/` as a path that was renamed months ago. Agents read those files and act on stale information. repoctx is the source of truth for everything that can be derived from the repository itself.

Install

go install github.com/SrIruma/repoctx/cmd/repoctx@latest

Or build from source:

make build   # -> bin/repoctx
make install # -> $GOBIN/repoctx

Commands

Command	Description
repoctx info [dir]	Detect manifests and extract facts from a repository. Manifests that fail to parse are kept in the report with a ! warning (and an errors field in --json).
repoctx generate [dir]	Regenerate the code-derived