# llms.txt

- **Status:** current on 2026-11-06, for version 0.
- **Related documents:** [Surface for agents](https://surface.solenovis.com/docs/ai.md), [MCP server](https://surface.solenovis.com/docs/mcp-server.md)

This website serves its documents as plain text for agents. A file is one request, so an agent with no MCP can read the documents too.

| Address | Content |
|---|---|
| [`/llms.txt`](https://surface.solenovis.com/llms.txt) | The list of the documents, with a link to each one and its summary, in the format of llmstxt.org |
| [`/llms-full.txt`](https://surface.solenovis.com/llms-full.txt) | All documents in one file |
| [`/llms-small.txt`](https://surface.solenovis.com/llms-small.txt) | A short form for a small context. It has the full text of getting started. Of each other document, it has the headings, the first paragraph under each heading, and the Surf samples |
| `/docs/<page>.md` | One document as Markdown, for example [`/docs/getting-started.md`](https://surface.solenovis.com/docs/getting-started.md) |
| [`/SKILLS.md`](https://surface.solenovis.com/SKILLS.md) | The list of the [skills](https://surface.solenovis.com/docs/skills.md) |
| [`/install.sh`](https://surface.solenovis.com/install.sh) | The install script of `surf` |

Each page of the documents has a link to its Markdown file.

---

## 1. Choose a file

- **The agent needs one feature.** Give it the Markdown file of that page. It is the smallest file.
- **The agent has a large context.** Give it `/llms-full.txt`.
- **The agent has a small context.** Give it `/llms-small.txt`, and the Markdown file of each page that the task needs.

The files and the MCP server have the same text. The MCP server also checks the code, so use it when the agent has MCP.

---

## 2. The source of the files

The build of the website writes the files. It reads the list `DOCUMENTS` of `crates/surf-mcp`, which is also the list of the MCP server. So the files, the pages and the server always have the same documents.