Etoolio

AGENTS.md Generator

Free AGENTS.md generator. Paste a public GitHub repo URL and get a tailored AGENTS.md (and CLAUDE.md) that tells AI coding agents how to set up, build, test and work in your project. Copy or download.

We read the repo's README, manifests and structure, then draft an AGENTS.md that tells AI coding agents how to work in it.

What the AGENTS.md generator does

Paste a public GitHub repository URL and this tool drafts an AGENTS.md for it, the file that tells AI coding agents how to work in your project. It reads your README, package manifests (like package.json, requirements.txt, go.mod or Cargo.toml) and folder structure, then writes a tailored guide with real setup, build and test commands. It also produces a matching CLAUDE.md.

Why AGENTS.md matters

AI coding agents work far better when a repository tells them how it is built and run. AGENTS.md became the shared convention for exactly that in 2025-2026, adopted across many AI coding tools. Think of it as a README written for agents: setup steps, the commands to build and test, the project's structure, and the conventions to follow. A good AGENTS.md means fewer wrong guesses and cleaner contributions from any agent that reads it.

How to use it

  • Paste a public GitHub repo URL (for example github.com/owner/repo) and press Generate.
  • Review the draft under the AGENTS.md tab, and the companion CLAUDE.md under its tab.
  • Copy or download the file.
  • Commit it to your repo root as AGENTS.md (and CLAUDE.md if you use Claude Code).

AGENTS.md vs CLAUDE.md

  • AGENTS.md is the tool-agnostic file most AI agents look for. Keep your full project guide here.
  • CLAUDE.md is Claude Code's own guidance file. The tidy pattern, and the one this tool uses, is to make CLAUDE.md a short file that imports AGENTS.md with @AGENTS.md, so you maintain a single source of truth.

Good to know

  • The draft is generated from public repo signals, so always review and edit it before committing. Add the gotchas only you know.
  • It works on any public repository, so you can generate one for a project you are learning, not just your own.
  • Private repositories are not supported, the tool only uses the public GitHub API.

Good to know

AGENTS.md Generator, frequently asked questions

What is an AGENTS.md file?

AGENTS.md is a Markdown file at the root of a repository that tells AI coding agents how to work in that project, how to set it up, run it, build and test it, plus code style and conventions. It has become a widely adopted convention across AI coding tools in 2025-2026, a README written for agents rather than humans.

How do I create an AGENTS.md file?

Paste your public GitHub repository URL into Etoolio's AGENTS.md generator. It reads your README, package manifests and folder structure, then drafts a tailored AGENTS.md with real setup and test commands. Copy or download it, review the draft, and commit it to your repo root.

What is the difference between AGENTS.md and CLAUDE.md?

AGENTS.md is the tool-agnostic standard many AI agents read. CLAUDE.md is Claude Code's own guidance file. A common best practice is to keep the full guide in AGENTS.md and make CLAUDE.md a short file that imports it with '@AGENTS.md', so you maintain one source of truth. This tool generates both.

Does it work on private repositories?

No. It only reads public GitHub repositories through the public GitHub API. For a private repo, generate from a similar public one or write the file by hand using the structure this tool produces.

Should I edit the generated file?

Yes. The draft is built from public repo signals, README, manifests and structure, so it is a strong starting point, not a finished document. Review the commands, add project-specific gotchas, and remove anything that does not apply before committing.

Is the AGENTS.md generator free?

Yes, it is free with no signup. It uses the public GitHub API plus a free AI model to draft the file.