LLMs.txt
What is LLMs.txt?
Section titled “What is LLMs.txt?”We support LLMs.txt files for making the Aptos documentation available to large language models (LLMs). This feature helps AI tools better understand the Aptos blockchain, its Move language, SDKs, and development patterns.
Available Routes
Section titled “Available Routes”We provide the following LLMs.txt routes to help AI tools access our documentation:
- llms.txt - A compact routing file that points AI tools to the most useful Aptos docs and machine-readable exports
- llms-small.txt - A curated low-token subset of the most useful Aptos documentation for IDE assistants and smaller context windows
- llms-full.txt - The full rendered Aptos documentation corpus for large-context ingestion
Well-known URL: Some tools look for https://aptos.dev/.well-known/llms.txt. That URL permanently redirects to /llms.txt (same content).
The llms.txt index also lists structured API assets that are not prose docs—for example the Aptos Fullnode OpenAPI spec (JSON) and the REST API reference (HTML) generated from that spec.
It also surfaces agent tooling (Aptos MCP, Agent Skills, Explorer, GitHub org) and key Markdown deep links (AI hub, standards, Indexer GraphQL reference) so models can fetch the right surface without guessing URLs.
Discovery endpoints, the MCP Server Card, and WebMCP tools are documented on the AI tools overview.
Per-Page Markdown Access
Section titled “Per-Page Markdown Access”Every documentation page is also available as rendered Markdown by appending .md to the URL:
| Page URL | Markdown URL |
|---|---|
https://aptos.dev/build/guides/first-transaction | https://aptos.dev/build/guides/first-transaction.md |
https://aptos.dev/build/sdks/ts-sdk | https://aptos.dev/build/sdks/ts-sdk.md |
https://aptos.dev/zh/build/guides/first-transaction | https://aptos.dev/zh/build/guides/first-transaction.md |
You can also send Accept: text/markdown to the HTML URL. This is useful for AI tools that need to fetch individual pages with minimal tokens, rather than ingesting the full documentation. The llms.txt file acts as a compact router, while llms-small.txt and llms-full.txt provide curated and comprehensive corpus exports.
Usage with AI Tools
Section titled “Usage with AI Tools”Claude Code
Section titled “Claude Code”Add Aptos documentation context to Claude Code projects:
- Add
https://aptos.dev/llms.txtto your project’sCLAUDE.mdorAGENTS.mdfile as a reference - Claude Code will read the index and fetch relevant pages via
.mdURLs as needed - For on-chain tools, see Aptos MCP for Claude Code
Cursor
Section titled “Cursor”Cursor’s @Docs index was removed. Point Agent at the feeds instead:
- Add
https://aptos.dev/llms.txtto the projectAGENTS.md(or a project rule) - Paste a feed URL in chat when you need a one-off fetch — Agent can retrieve it directly
- For on-chain tools, see Aptos MCP for Cursor
GitHub Copilot
Section titled “GitHub Copilot”In Copilot Chat, fetch a feed for the current session:
#fetch https://aptos.dev/llms.txtFor standing project context, add the URLs to .github/copilot-instructions.md:
https://aptos.dev/llms.txthttps://aptos.dev/llms-small.txthttps://aptos.dev/llms-full.txtOpenAI Codex
Section titled “OpenAI Codex”Add https://aptos.dev/llms.txt to AGENTS.md, then start Codex. For on-chain tools, see Aptos MCP for Codex.
Devin Desktop (formerly Windsurf)
Section titled “Devin Desktop (formerly Windsurf)”Devin Desktop reads AGENTS.md and .devin/rules/ (legacy .windsurfrules still works). Put https://aptos.dev/llms.txt in the project AGENTS.md.
Read more about AGENTS.md in Devin Desktop
Claude.ai
Section titled “Claude.ai”Add Aptos documentation as project knowledge in Claude Projects:
- Open Claude.ai and create or open a Project
- Add project knowledge / content
- Paste
https://aptos.dev/llms-full.txtas a URL source - Claude will now have Aptos documentation context in conversations within that Project
ChatGPT
Section titled “ChatGPT”Reference the Aptos docs directly in ChatGPT conversations:
- Paste
https://aptos.dev/llms-full.txtinto your message and ask ChatGPT to read it before answering Aptos questions - For custom GPTs: add
https://aptos.dev/llms.txtas a knowledge source
Other AI Tools
Section titled “Other AI Tools”Any AI tool that supports LLMs.txt can use these routes to better understand Aptos. Simply point your tool to any of the routes above.