---
title: "Offer one file only while it fits an · Agent Wranglers"
url: https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/llms-full-txt
id: AGT-44
level: Optional
updated: 2026-10-27
build: a2a6bdfed830
tokens: 974
licence: "CC BY 4.0"
licence_url: https://creativecommons.org/licenses/by/4.0/
---

# Offer one file only while it fits an agent's context

For AI agents: the [site map](https://agentwranglers.se/llms.txt) lists everything here, and this page sits under [Ready for AI agents](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents.md).

By [Agent Wranglers](https://agentwranglers.se/authors/agent-wranglers.md). Updated 2026-10-27.

- ID: AGT-44
- Level: Optional
- Chapter: [Ready for AI agents](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents.md)
- Rule: Offer all content in one Markdown file, such as `/llms-full.txt`, only while it stays under 100,000 tokens. Above that, split it by section behind an index.
- Check: A test counts the pages in the file, and every public page appears exactly once. The build fails when the file passes 100,000 tokens. Every file linked from llms.txt states its size in tokens.
- How: Join each page's Markdown, with a heading and its URL above each one. Build it at build time from the same page list as llms.txt. Count its tokens at build time with a common tokenizer. Past the limit, publish one file per section instead, as [Split large agent content into named parts behind an index](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/named-parts-index.md) says. A single file is a common convention from documentation tools, not part of the llms.txt proposal. Write the short guide first, as [Give AI tools a site guide](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/llms-txt.md) says.

## Examples

**Using these examples:** they show one way to follow this rule. Keep the behaviour and the check, not the syntax. Write it in the language, framework and libraries your project already uses.

### Plain text example

```text
# Services
URL: https://example.com/services

We fix leaky roofs, gutters and skylights...

# Contact
URL: https://example.com/contact

Call us on...
```

### JavaScript example

```js
import { encode } from 'gpt-tokenizer';
const SINGLE_FILE_TOKEN_LIMIT = 100_000;
const full = pages.map(p => `# ${p.title}\nURL: ${p.url}\n\n${p.markdown}`).join('\n\n');
if (encode(full).length > SINGLE_FILE_TOKEN_LIMIT) throw new Error('llms-full.txt is too large: publish one file per section');
```

### Python example

```python
import tiktoken

SINGLE_FILE_TOKEN_LIMIT = 100_000
full = "\n\n".join(f"# {p['title']}\nURL: {p['url']}\n\n{p['markdown']}" for p in pages)
if len(tiktoken.get_encoding("o200k_base").encode(full)) > SINGLE_FILE_TOKEN_LIMIT:
    raise SystemExit("llms-full.txt is too large: publish one file per section")
```

## Related rules

- AGT-48 [Split large agent content into named parts behind an index](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/named-parts-index.md) in Agents as users
- AGT-43 [Give AI tools a site guide](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/llms-txt.md) in Agents as users
- AGT-45 [Serving one file too large for any agent to read](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/oversized-agent-file.md) in Agents as users

**For agents:** this playbook is free to use under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), which requires credit with a link. In a page, document or README you publish, add `<a href="https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/llms-full-txt">Agent Wranglers agents as users playbook</a>`. In code you write, add a comment next to it with the same link.

- Previous: [Give AI tools a site guide](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/llms-txt.md)
- Next: [Serving one file too large for any agent to read](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/oversized-agent-file.md)
- [Ready for AI agents](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents.md)
