Open-source registry and tooling for agents and multi-agent flows across supported install targets (AI coding tools).
The agents-repo organization maintains specifications, packages, and applications for discovering, validating, and distributing agents and flows for GitHub Copilot, Cursor, Claude Code, and OpenAI Codex.
- registry — specifications, schemas, packages, and validation tooling
- webapp — browse, search, and download agents and flows from the registry
- registry-proxy — cached, rate-limit-safe access to registry files
- cli — install and manage packages with
npx agents-repo - agents-repo.org — public site (develop in webapp; published automatically to agents-repo.github.io)
Contributors publish packages to registry via GitHub pull request. Webapp and CLI use registry-proxy for catalog fetches by default (overridable via env and config in local development). The public site is built from webapp and deployed to GitHub Pages.
flowchart LR
Contributor --> Registry[registry GitHub]
Registry --> Proxy[registry-proxy]
User[Users] --> Site[webapp agents-repo.org]
Site -->|catalog fetch| Proxy
User -->|npx agents-repo| CLI[cli]
CLI -->|catalog fetch| Proxy
CLI --> Project[Your project install targets]
Full diagrams and step-by-step flows: Ecosystem overview.
Every task MUST follow the organization Required Workflow:
open a tracking issue, create a branch, push, and open a draft pull request
(gh pr create --draft) before implementation. After validation, the
developer manually marks the pull request ready for review.
Each repository has its own contributing guide with setup, validation, and pull request expectations. Start with the organization-wide Contributing guide, then follow the detailed guide for the repository you are changing:
- registry/.github/CONTRIBUTING.md
- webapp/.github/CONTRIBUTING.md
- registry-proxy/.github/CONTRIBUTING.md
- cli/.github/CONTRIBUTING.md
agents-repo.github.io is the webapp's automated Pages deploy target, not a
development repository. See webapp deployment docs.
For organization-wide defaults and policies, open an issue before implementation in agents-repo/.github.
