AGENTS.md is the emerging standard for telling AI coding agents how to work in your repo — and this tool generates one for any public GitHub repository in seconds, using Claude AI.
Live: agents-md-generator.davidcjw.com
Paste a GitHub URL → get a concise, accurate AGENTS.md (≤200 lines) covering only the sections that have real evidence in the repo:
- Installation / Setup
- Executable Commands
- Folder Structure
- Testing Instructions
- Linting
- Deployment
- PR Instructions
- Coding Guidelines
- Do-Not Rules
- Styling Guide
Output is editable in the browser and can be copied or downloaded.
/api/githubfetches key files from the repo in priority order (README → package.json → lint/test configs → CI workflows etc.), capped at 24k characters- The context is sent to
claude-haiku-4-5-20251001with a structured prompt - Claude generates only sections backed by real evidence — no generic filler
- Output is hard-capped to 200 lines
- Node.js 18+
- An Anthropic API key
git clone https://github.com/davidcjw/agents-md-generator
cd agents-md-generator
npm install
cp .env.example .env.local # add your ANTHROPIC_API_KEY
npm run devOpen http://localhost:3000.
Set the ANTHROPIC_API_KEY environment variable in your Vercel project settings.
Expand "Private repo? Add GitHub token" in the UI and provide a GitHub personal access token with repo scope.
- Next.js (App Router)
- Tailwind CSS
- Anthropic SDK —
claude-haiku-4-5-20251001
Contributions are welcome! Please open an issue first to discuss what you'd like to change.
- Fork the repo
- Create a feature branch (
git checkout -b feature/your-feature) - Commit your changes (
git commit -m 'feat: describe change') - Push and open a pull request
Please make sure tests pass before submitting a PR.
This project follows the Contributor Covenant v2.1. By participating you agree to uphold a welcoming, harassment-free environment.
Distributed under the MIT License. See LICENSE for details.