|
1 | 1 | <!doctype html> |
2 | 2 | <html lang="en"> |
3 | 3 | <head> |
4 | | -<meta charset="utf-8"> |
5 | | -<title>AgentPress machine entrypoint</title> |
6 | | -<link rel="canonical" href="https://barneywohl.github.io/agentpress/llms.txt"> |
7 | | -<link rel="alternate" type="text/plain" href="./llms.txt"> |
8 | | -<link rel="alternate" type="application/json" href="./.well-known/agentpress-machine-entrypoints.json"> |
9 | | -<meta http-equiv="refresh" content="0; url=./llms.txt"> |
| 4 | + <meta charset="utf-8" /> |
| 5 | + <meta name="viewport" content="width=device-width, initial-scale=1" /> |
| 6 | + <title>AgentPress — agents.txt for any repo</title> |
| 7 | + <meta name="description" content="Tell autonomous AI agents what they're allowed to do on your repo, in 60 seconds. Open standard, MIT licensed, no signup." /> |
| 8 | + <meta property="og:title" content="AgentPress — agents.txt for any repo" /> |
| 9 | + <meta property="og:description" content="robots.txt for crawlers. llms.txt for LLMs. agents.txt for autonomous agents." /> |
| 10 | + <meta property="og:type" content="website" /> |
| 11 | + <meta property="og:url" content="https://agentpress.dev/" /> |
| 12 | + <meta name="twitter:card" content="summary_large_image" /> |
| 13 | + <link rel="canonical" href="https://agentpress.dev/" /> |
| 14 | + <link rel="alternate" type="text/plain" href="./agents.txt" title="agents.txt" /> |
| 15 | + <link rel="alternate" type="text/plain" href="./llms.txt" title="llms.txt" /> |
| 16 | + <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Ctext x='0' y='14' font-size='14'%3E📜%3C/text%3E%3C/svg%3E" /> |
| 17 | + <style> |
| 18 | + :root { |
| 19 | + --bg: #0b0d10; |
| 20 | + --bg-card: #14171c; |
| 21 | + --fg: #e5e7eb; |
| 22 | + --fg-dim: #9ca3af; |
| 23 | + --accent: #2563eb; |
| 24 | + --accent-soft: rgba(37, 99, 235, 0.12); |
| 25 | + --green: #16a34a; |
| 26 | + --orange: #ea580c; |
| 27 | + --red: #dc2626; |
| 28 | + --border: #1f2630; |
| 29 | + --mono: ui-monospace, "Berkeley Mono", "JetBrains Mono", "Menlo", monospace; |
| 30 | + --serif: "Spectral", "Fraunces", Georgia, serif; |
| 31 | + --sans: "Inter", "IBM Plex Sans", system-ui, -apple-system, sans-serif; |
| 32 | + } |
| 33 | + @media (prefers-color-scheme: light) { |
| 34 | + :root { --bg: #fafafa; --bg-card: #ffffff; --fg: #0b0d10; --fg-dim: #525864; --border: #e5e7eb; --accent-soft: rgba(37, 99, 235, 0.08); } |
| 35 | + } |
| 36 | + * { box-sizing: border-box; } |
| 37 | + html, body { margin: 0; padding: 0; background: var(--bg); color: var(--fg); font-family: var(--sans); -webkit-font-smoothing: antialiased; line-height: 1.5; } |
| 38 | + a { color: var(--accent); text-decoration: none; } |
| 39 | + a:hover { text-decoration: underline; } |
| 40 | + code, pre { font-family: var(--mono); } |
| 41 | + .container { max-width: 880px; margin: 0 auto; padding: 5rem 1.25rem 6rem; } |
| 42 | + nav.top { display: flex; justify-content: space-between; align-items: center; padding: 1.25rem 0 3rem; } |
| 43 | + nav.top .brand { font-family: var(--serif); font-weight: 600; font-size: 1.1rem; color: var(--fg); } |
| 44 | + nav.top .brand .dot { color: var(--accent); } |
| 45 | + nav.top .links { display: flex; gap: 1.5rem; font-size: 0.875rem; } |
| 46 | + nav.top .links a { color: var(--fg-dim); } |
| 47 | + nav.top .links a:hover { color: var(--fg); } |
| 48 | + |
| 49 | + .hero h1 { font-family: var(--serif); font-size: 3rem; line-height: 1.05; margin: 0 0 1.5rem; font-weight: 600; letter-spacing: -0.02em; } |
| 50 | + .hero h1 em { font-style: normal; color: var(--accent); } |
| 51 | + .hero p.lede { font-size: 1.25rem; color: var(--fg-dim); margin: 0 0 2.5rem; max-width: 38em; } |
| 52 | + .hero p.lede strong { color: var(--fg); font-weight: 500; } |
| 53 | + .hero .lineage { font-family: var(--mono); font-size: 0.9rem; line-height: 1.8; padding: 1.5rem; background: var(--bg-card); border: 1px solid var(--border); border-radius: 12px; margin: 0 0 2rem; color: var(--fg-dim); } |
| 54 | + .hero .lineage .arrow { color: var(--accent); font-weight: 600; } |
| 55 | + .hero .lineage .new { color: var(--fg); font-weight: 600; } |
| 56 | + .ctas { display: flex; gap: 0.75rem; flex-wrap: wrap; margin: 2rem 0 0; } |
| 57 | + .cta { padding: 0.75rem 1.5rem; border-radius: 10px; font-weight: 500; font-size: 0.95rem; text-decoration: none; transition: all 120ms; border: 1px solid transparent; } |
| 58 | + .cta.primary { background: var(--accent); color: white; } |
| 59 | + .cta.primary:hover { background: #1d4ed8; text-decoration: none; } |
| 60 | + .cta.ghost { border-color: var(--border); color: var(--fg); } |
| 61 | + .cta.ghost:hover { border-color: var(--accent); text-decoration: none; } |
| 62 | + |
| 63 | + section { margin-top: 5rem; } |
| 64 | + h2 { font-family: var(--serif); font-size: 1.75rem; margin: 0 0 1rem; font-weight: 600; } |
| 65 | + h3 { font-family: var(--sans); font-size: 1.05rem; margin: 0 0 0.5rem; font-weight: 600; } |
| 66 | + |
| 67 | + .install pre { background: var(--bg-card); border: 1px solid var(--border); border-radius: 10px; padding: 1.25rem; overflow-x: auto; font-size: 0.95rem; line-height: 1.6; margin: 0 0 1rem; } |
| 68 | + .install .comment { color: var(--fg-dim); } |
| 69 | + .install .prompt { color: var(--accent); user-select: none; } |
| 70 | + |
| 71 | + .what-grid { display: grid; grid-template-columns: 1fr; gap: 1rem; margin-top: 1.5rem; } |
| 72 | + @media (min-width: 720px) { .what-grid { grid-template-columns: 1fr 1fr; } } |
| 73 | + .what-item { background: var(--bg-card); border: 1px solid var(--border); border-radius: 12px; padding: 1.25rem 1.5rem; } |
| 74 | + .what-item .num { font-family: var(--mono); color: var(--accent); font-size: 0.85rem; font-weight: 600; } |
| 75 | + .what-item h3 { margin: 0.5rem 0 0.5rem; font-size: 1rem; } |
| 76 | + .what-item p { margin: 0; color: var(--fg-dim); font-size: 0.95rem; } |
| 77 | + |
| 78 | + .pitch-grid { display: grid; grid-template-columns: 1fr; gap: 1rem; margin-top: 1.5rem; } |
| 79 | + @media (min-width: 720px) { .pitch-grid { grid-template-columns: 1fr 1fr 1fr; } } |
| 80 | + .pitch-item { padding: 1rem; border-left: 3px solid var(--border); } |
| 81 | + .pitch-item.allowed { border-color: var(--green); } |
| 82 | + .pitch-item.approval { border-color: var(--orange); } |
| 83 | + .pitch-item.prohibited { border-color: var(--red); } |
| 84 | + .pitch-item .label { font-size: 0.7rem; text-transform: uppercase; letter-spacing: 0.08em; color: var(--fg-dim); margin: 0 0 0.5rem; font-family: var(--mono); } |
| 85 | + .pitch-item h3 { font-size: 0.95rem; margin: 0; } |
| 86 | + .pitch-item p { margin: 0.25rem 0 0; color: var(--fg-dim); font-size: 0.875rem; } |
| 87 | + |
| 88 | + .surfaces { display: grid; grid-template-columns: 1fr; gap: 0.5rem; margin-top: 1.5rem; } |
| 89 | + @media (min-width: 600px) { .surfaces { grid-template-columns: repeat(2, 1fr); } } |
| 90 | + .surface { padding: 1rem 1.25rem; background: var(--bg-card); border: 1px solid var(--border); border-radius: 10px; transition: border-color 120ms; } |
| 91 | + .surface:hover { border-color: var(--accent); } |
| 92 | + .surface a { color: var(--fg); display: block; text-decoration: none; } |
| 93 | + .surface .name { font-weight: 500; font-size: 0.95rem; } |
| 94 | + .surface .desc { color: var(--fg-dim); font-size: 0.825rem; margin-top: 0.25rem; } |
| 95 | + .surface .badge { font-family: var(--mono); font-size: 0.7rem; padding: 0.15rem 0.5rem; background: var(--accent-soft); color: var(--accent); border-radius: 999px; margin-left: 0.5rem; vertical-align: middle; } |
| 96 | + |
| 97 | + footer { margin-top: 6rem; padding-top: 2.5rem; border-top: 1px solid var(--border); display: flex; justify-content: space-between; align-items: center; flex-wrap: wrap; gap: 1rem; font-size: 0.825rem; color: var(--fg-dim); } |
| 98 | + footer a { color: var(--fg); border-bottom: 1px dotted var(--fg-dim); } |
| 99 | + footer a:hover { text-decoration: none; } |
| 100 | + </style> |
10 | 101 | </head> |
11 | 102 | <body> |
12 | | -<main data-agent-entrypoint="true"> |
13 | | -<pre>{"primary":"./llms.txt","manifest":"./.well-known/agentpress.json","machine_entrypoints":"./.well-known/agentpress-machine-entrypoints.json","schemas":"./agentpress/schemas/index.json","feedback_protocol":"./agentpress/feedback/agent-feedback-protocol.json"}</pre> |
14 | | -<p><a href="./llms.txt">llms.txt</a></p> |
15 | | -</main> |
| 103 | + <div class="container"> |
| 104 | + <nav class="top"> |
| 105 | + <span class="brand">AgentPress<span class="dot">.</span></span> |
| 106 | + <div class="links"> |
| 107 | + <a href="https://github.com/barneywohl/agentpress/blob/main/docs/AGENTSTXT_SPEC.md">Spec</a> |
| 108 | + <a href="./registry/">Registry</a> |
| 109 | + <a href="https://github.com/barneywohl/agentpress">GitHub</a> |
| 110 | + </div> |
| 111 | + </nav> |
| 112 | + |
| 113 | + <header class="hero"> |
| 114 | + <h1><em>agents.txt</em><br />for any repo.</h1> |
| 115 | + <p class="lede"> |
| 116 | + Tell autonomous AI agents what they're allowed to do on your repo, in <strong>60 seconds</strong>. Open standard. MIT licensed. No signup. |
| 117 | + </p> |
| 118 | + |
| 119 | + <div class="lineage"> |
| 120 | + <code>robots.txt</code> told crawlers what to crawl.<br /> |
| 121 | + <code>sitemap.xml</code> told search engines what to index.<br /> |
| 122 | + <code>llms.txt</code> told LLMs what to read.<br /> |
| 123 | + <span class="arrow">→</span> <code class="new">agents.txt</code> <span class="new">tells autonomous agents what they're allowed to do.</span> |
| 124 | + </div> |
| 125 | + |
| 126 | + <div class="ctas"> |
| 127 | + <a class="cta primary" href="https://github.com/barneywohl/agentpress#install">Get started →</a> |
| 128 | + <a class="cta ghost" href="https://github.com/barneywohl/agentpress/blob/main/docs/AGENTSTXT_SPEC.md">Read the spec</a> |
| 129 | + </div> |
| 130 | + </header> |
| 131 | + |
| 132 | + <section class="install"> |
| 133 | + <h2>Install in one line</h2> |
| 134 | + <pre><span class="prompt">$</span> npm install -g @agent_press/agentpress |
| 135 | +<span class="prompt">$</span> agentpress init |
| 136 | +<span class="comment"># answer 5 questions, get an agents.txt at your repo root + GitHub Action + README badge</span></pre> |
| 137 | + <p style="color: var(--fg-dim); font-size: 0.875rem; margin: 0;">Python? <code>pip install agentpress-static</code></p> |
| 138 | + </section> |
| 139 | + |
| 140 | + <section> |
| 141 | + <h2>What an <code>agents.txt</code> declares</h2> |
| 142 | + <div class="pitch-grid"> |
| 143 | + <div class="pitch-item allowed"> |
| 144 | + <p class="label">Allowed</p> |
| 145 | + <h3>Agents may do these</h3> |
| 146 | + <p>Read code, run tests, file PRs, comment on issues.</p> |
| 147 | + </div> |
| 148 | + <div class="pitch-item approval"> |
| 149 | + <p class="label">Requires approval</p> |
| 150 | + <h3>Agents must pause and ask</h3> |
| 151 | + <p>Schema migrations, billing changes, production deploys.</p> |
| 152 | + </div> |
| 153 | + <div class="pitch-item prohibited"> |
| 154 | + <p class="label">Prohibited</p> |
| 155 | + <h3>Agents must refuse</h3> |
| 156 | + <p>Secret exfiltration, 2FA bypass, deceptive tracking, spam.</p> |
| 157 | + </div> |
| 158 | + </div> |
| 159 | + </section> |
| 160 | + |
| 161 | + <section> |
| 162 | + <h2>What you get on day one</h2> |
| 163 | + <div class="what-grid"> |
| 164 | + <div class="what-item"><span class="num">01</span><h3>The CLI</h3><p><code>agentpress init</code> drops a sensible <code>agents.txt</code> and supporting machine-readable surfaces in your repo.</p></div> |
| 165 | + <div class="what-item"><span class="num">02</span><h3>The GitHub Action</h3><p><code>agentpress/setup-action@v1</code> validates your contract on every PR, fails CI on misconfig, posts a step summary.</p></div> |
| 166 | + <div class="what-item"><span class="num">03</span><h3>The README badge</h3><p>One markdown line. Every adopter advertises the standard for free.</p></div> |
| 167 | + <div class="what-item"><span class="num">04</span><h3>The MCP server</h3><p><code>@agentpress/mcp-server</code> plugs into Claude Code, Cursor, Devin — agents respect contracts natively.</p></div> |
| 168 | + <div class="what-item"><span class="num">05</span><h3>The VS Code extension</h3><p>Syntax highlighting, snippets, on-save validation. The editor catches mistakes before you commit.</p></div> |
| 169 | + <div class="what-item"><span class="num">06</span><h3>The browser extension</h3><p>URL-bar badge when a repo or site has an <code>agents.txt</code>. Daily reminder of who's adopted.</p></div> |
| 170 | + </div> |
| 171 | + </section> |
| 172 | + |
| 173 | + <section> |
| 174 | + <h2>The agents.txt v1.0 surfaces</h2> |
| 175 | + <div class="surfaces"> |
| 176 | + <div class="surface"><a href="./agents.txt"><span class="name">agents.txt</span><span class="badge">live</span><div class="desc">Our own contract — eat-our-own-food</div></a></div> |
| 177 | + <div class="surface"><a href="https://github.com/barneywohl/agentpress/blob/main/docs/AGENTSTXT_SPEC.md"><span class="name">v1.0 specification</span><span class="badge">draft</span><div class="desc">Section reference, conformance, security</div></a></div> |
| 178 | + <div class="surface"><a href="https://www.npmjs.com/package/@agent_press/agentpress"><span class="name">@agent_press/agentpress</span><span class="badge">npm</span><div class="desc">The CLI: init, lint, doctor, receipt</div></a></div> |
| 179 | + <div class="surface"><a href="https://pypi.org/project/agentpress-static/"><span class="name">agentpress-static</span><span class="badge">pip</span><div class="desc">Python CLI mirror</div></a></div> |
| 180 | + <div class="surface"><a href="https://github.com/barneywohl/agentpress/tree/main/packages/core"><span class="name">@agentpress/core</span><span class="badge">npm</span><div class="desc">Zero-dep TypeScript parser library</div></a></div> |
| 181 | + <div class="surface"><a href="https://github.com/barneywohl/agentpress/tree/main/python-core"><span class="name">agentpress-core</span><span class="badge">pip</span><div class="desc">Mirror Python parser, stdlib only</div></a></div> |
| 182 | + <div class="surface"><a href="https://github.com/barneywohl/agentpress/tree/main/actions/setup-action"><span class="name">agentpress/setup-action</span><span class="badge">GH Action</span><div class="desc">CI lint with step-summary report</div></a></div> |
| 183 | + <div class="surface"><a href="https://github.com/barneywohl/agentpress/tree/main/extensions/vscode"><span class="name">VS Code extension</span><span class="badge">marketplace</span><div class="desc">Syntax + snippets + on-save lint</div></a></div> |
| 184 | + <div class="surface"><a href="https://github.com/barneywohl/agentpress/tree/main/extensions/browser"><span class="name">Browser extension</span><span class="badge">chrome + ff</span><div class="desc">URL-bar inspector for any site</div></a></div> |
| 185 | + <div class="surface"><a href="https://github.com/barneywohl/agentpress/tree/main/packages/mcp-server"><span class="name">@agentpress/mcp-server</span><span class="badge">npm</span><div class="desc">MCP server for Claude Code, Cursor, Devin</div></a></div> |
| 186 | + <div class="surface"><a href="./registry/"><span class="name">Registry</span><span class="badge">curated</span><div class="desc">Repos that publish an agents.txt</div></a></div> |
| 187 | + <div class="surface"><a href="https://github.com/barneywohl/agentpress/blob/main/docs/BADGE.md"><span class="name">README badge</span><span class="badge">free</span><div class="desc">Show your adoption</div></a></div> |
| 188 | + </div> |
| 189 | + </section> |
| 190 | + |
| 191 | + <footer> |
| 192 | + <span>MIT licensed. Spec is free to fork, embed, extend.</span> |
| 193 | + <span>Made by <a href="https://github.com/barneywohl">@barneywohl</a> · <a href="https://github.com/barneywohl/agentpress">contribute</a></span> |
| 194 | + </footer> |
| 195 | + </div> |
16 | 196 | </body> |
17 | 197 | </html> |
0 commit comments