# LLM start here

These docs are also available as plain text, so an AI assistant can read them directly and help you build plugins and companions.

| File | What it is | Use it when |
| --- | --- | --- |
| [llms.txt](https://agentparley.ai/llms.txt) | An index of every page, with a one-line summary and a link | Your tool can follow links, or you want it to read only what it needs |
| [llms-full.txt](https://agentparley.ai/llms-full.txt) | All the docs in one file, about 350 KB | Your tool reads one file, or you want to paste everything in |
| `https://agentparley.ai/docs/<page>.md` | One page as Markdown, such as [plugin-sdk.md](https://agentparley.ai/docs/plugin-sdk.md) | You need a single topic |

Every page also has a **View as Markdown** link at the top.

## Use it with your assistant

Paste this into your assistant, then describe what you want to build:

```text
Help me build an AgentParley plugin. Before you answer, read
https://agentparley.ai/llms.txt and then the pages it lists that fit my task.
Use only fields and functions those docs describe. If they don't cover
something, tell me rather than guessing.
```

If your assistant can't open links, download [llms-full.txt](https://agentparley.ai/llms-full.txt) and attach it.

## If you are an AI agent

Start with [llms.txt](https://agentparley.ai/llms.txt), and read only the pages your task needs. A good order:

1. **Any plugin:** [Plugin SDK](https://agentparley.ai/docs/plugin-sdk.md), then [Package format](https://agentparley.ai/docs/plugin-package-format.md) and [Manifest](https://agentparley.ai/docs/plugin-manifest.md).
2. **Code that runs:** [Host API](https://agentparley.ai/docs/plugin-host-api.md) (including `host.plugins`, which lets a plugin build and release plugins) and [Permissions](https://agentparley.ai/docs/plugin-permissions.md), then the guide for the kind you're making, such as [Tools](https://agentparley.ai/docs/plugin-tools.md) or [Middleware](https://agentparley.ai/docs/plugin-middleware.md).
3. **A companion:** [Create a 3D companion](https://agentparley.ai/docs/create-3d-companion.md) or [Create a 2D companion](https://agentparley.ai/docs/create-2d-companion.md), then [Companion packs](https://agentparley.ai/docs/plugin-companion-packs.md) for every setting.
4. **Publishing or scripting it:** [Publishing](https://agentparley.ai/docs/publishing.md) and [API reference](https://agentparley.ai/docs/api-reference.md).

**Inside AgentParley,** install the **Plugin Studio** plugin. Your agent then gets the `write-a-plugin` skill and tools to create, build, install, publish, list and price a plugin itself. It asks the user before anything is published, listed or priced.

The files are rebuilt from these docs whenever they change, so they stay in step with the pages.
