Add agents.txt v1.0 (lineage cross-link)#121
Open
barneywohl wants to merge 1 commit into
Open
Conversation
Adds a single `agents.txt` file at the repo root, in the v1.0 INI format from https://github.com/barneywohl/agentpress. The agents.txt v1.0 spec explicitly cites llms.txt as its lineage parent (robots.txt → sitemap.xml → llms.txt → agents.txt), so this PR is a courtesy cross-link rather than an ask. No CI changes, no doc changes, no upstream coupling. Content is tuned for this repo's actual shape (spec + docs + small Python helper); allowed_actions cover read/PR/issue-comment; prohibited_actions cover the obvious (no merging, no PyPI pushes, no force-pushes); spec text and the nbs/ source require human approval; entry_points point at nbs/index.qmd (source of truth) and llmstxt.org (rendered site).
barneywohl
pushed a commit
to barneywohl/agentpress
that referenced
this pull request
May 13, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Hi Jeremy 👋
agents.txt v1.0 shipped today, and its stated lineage is
robots.txt → sitemap.xml → llms.txt → agents.txt. llms.txt is explicitly cited as the immediate parent — the thing that made it normal to have a plain-text file at a known path aimed at non-human readers. So this PR is a courtesy cross-link, not an ask.What this adds
/agents.txtat the repo root, in the v1.0 INI format.That's it. It's tuned for what this repo actually is — a spec and docs project with a small Python helper — rather than copy-pasted boilerplate. Allowed actions are read/PR/issue-comment; prohibited actions cover the obvious (no merging, no PyPI pushes, no history rewrites); spec text and the
nbs/source require human approval; entry points point atnbs/index.qmdas source of truth andllmstxt.orgas the rendered site.What this doesn't do
Why bother
Agents are already crawling spec repos and occasionally opening low-signal PRs. Having an
agents.txtat the root gives them an unambiguous "here's what's allowed, here's what needs a human" surface — same idea as llms.txt, one layer up the stack.Full v1.0 spec for reference: https://github.com/barneywohl/agentpress/blob/main/docs/AGENTSTXT_SPEC.md
Totally fine to close this if it's not a fit — no hard feelings, and thanks for llms.txt either way.