Add agents.txt v1.0 at repo root#4154
Open
barneywohl wants to merge 1 commit into
Open
Conversation
barneywohl
pushed a commit
to barneywohl/agentpress
that referenced
this pull request
May 13, 2026
…ypescript}, claude-code - modelcontextprotocol/servers#4154 - anthropics/anthropic-sdk-python#1539 - anthropics/anthropic-sdk-typescript#1043 - anthropics/claude-code#58801 All 5 friendly-seed PRs (per LAUNCH/TARGET_REPOS.md tier 1) now filed. Holding off on the 15 secondary targets per maintainer guidance: filing more in one day from the same account would look bot-shaped.
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
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.
Add
agents.txt(v1.0) at repo rootHey — first off, thanks for the work on this repo. We shipped
@agent_press/mcp-serveryesterday on top of the MCP TypeScript SDK, and a lot of what makes that possible is the clarity these reference implementations provide. This PR is meant in that spirit: a small, peer contribution from a project that builds on MCP.What this PR adds
A single file:
agents.txtat the repository root.agents.txtis a new open standard (v1.0, shipped this week) that lets a repository declare, in a machine-readable INI format, what autonomous AI agents are permitted to do when interacting with the project. It sits in the same lineage asrobots.txt,sitemap.xml, andllms.txt— advisory, static, no runtime component. Spec: https://github.com/barneywohl/agentpress/blob/main/docs/AGENTSTXT_SPEC.mdThe version proposed here is intentionally conservative for a monorepo of reference implementations:
allowed_actionscovers reading, running tests in CI, opening PRs, and commenting on issuesprohibited_actionscovers merging, publishing packages, modifyingSECURITY.md/LICENSE/CODE_OF_CONDUCT.md, adding new reference servers, and any protocol-spec changesrequires_human_approvalflags anything undersrc/**,.github/workflows/**, dependency changes, and behavior changes to documented tool schemasentry_pointspoints to existingREADME.md,CONTRIBUTING.md, andCLAUDE.mdscopemirrors CONTRIBUTING.md's existing preference for small, focused PRs and explicitly marks new servers and protocol changes as out of scopeWhat this PR does not do
CONTRIBUTING.md,SECURITY.md, or any existing fileagents.txtis purely a repo-level declarationCaveats I want to flag
agents.txtat the root of a monorepo has real subtleties — different subdirectories have different test commands, different maintainers, and different risk profiles. The version here errs on the side of being restrictive (broadrequires_human_approvalpatterns, conservativescopelimits) rather than precise. Per-serveragents.txtfiles could be added later if useful, but that's out of scope for this PR.Happy to iterate on wording, tighten the
prohibited_actionslist, or close this if it's not a fit for the repo's direction.