# AgentSky developer docs

> Long-lived agents over HTTP: /v1 management plus a streaming conversation plane, the sky CLI, and the agent.toml declarative format.

Every page below is also available as markdown at the listed .md URL.
The machine-readable OpenAPI spec is at https://api.agentsky.dev/v1/openapi.json.

## Docs

- [Overview](https://platform.agentsky.dev/docs/overview.md): Run agents through one API, with a browser UI included. Learn what you can build and how agents, sessions, and the UI work together.
- [Developer quickstart](https://platform.agentsky.dev/docs/index.md): Launch a long-lived agent from your terminal in two commands, then talk to it over a streaming API.
- [API reference](https://platform.agentsky.dev/docs/api.md): Every /v1 endpoint with schemas, the error contract, and the stream event catalog.
- [API Gateway](https://platform.agentsky.dev/docs/gateway.md): One AgentSky key in front of the Anthropic and OpenAI wires plus run endpoints: base URLs, model ids, provider routing and failover, cost in the response.
- [Capabilities reference](https://platform.agentsky.dev/docs/capabilities.md): Every built-in capability action agents can call — inputs, outputs, limits, and pricing units for web, image, video, and voice.
- [CLI reference — sky](https://platform.agentsky.dev/docs/cli.md): Every sky command: auth, launch/deploy, agent, universe, and secrets.
- [agent.toml reference](https://platform.agentsky.dev/docs/agent-toml.md): The declarative agent file — everything the create wizard can set, in a fly.toml-style file.
- [Skills](https://platform.agentsky.dev/docs/skills.md): Reusable instruction + script bundles your agents load on demand — upload once, attach by reference with pinned revisions, or load straight from a GitHub repo.
- [Routines](https://platform.agentsky.dev/docs/routines.md): Run agents on a schedule — a cron-fired routine starts a fresh session per run or sends a turn into a long-lived session, with per-run budgets, a runs ledger, and webhooks.
- [Channels](https://platform.agentsky.dev/docs/channels.md): Put your agent in Telegram, Slack, Discord, iMessage, and WhatsApp — one normalized API for connections, threads, and events.
- [Channels quickstart](https://platform.agentsky.dev/docs/channels/quickstart.md): Five minutes from a BotFather token to your agent replying on Telegram, under your bot's identity.
- [Channel routing](https://platform.agentsky.dev/docs/channels/routing.md): Bindings and precedence, webhook mode, re-binding, proactive deliveries, and the hosted connect flow.
- [Channel webhooks](https://platform.agentsky.dev/docs/channels/webhooks.md): The channel event reference — signatures, retries, idempotency, and the SSE mirror for local development.
- [Telegram guide](https://platform.agentsky.dev/docs/channels/guides/telegram.md): Your BotFather bot on the channels API — registration, connect links, and rendering.
- [Slack guide](https://platform.agentsky.dev/docs/channels/guides/slack.md): Your Slack app on the channels API — registration, event URLs, per-agent channels.
- [Discord guide](https://platform.agentsky.dev/docs/channels/guides/discord.md): Your Discord bot on the channels API — we hold the gateway socket for you.
- [WhatsApp guide](https://platform.agentsky.dev/docs/channels/guides/whatsapp.md): Your WhatsApp business number on the channels API, via Meta's Cloud API.
- [iMessage guide](https://platform.agentsky.dev/docs/channels/guides/imessage.md): Your Linq iMessage number on the channels API — coming soon.

## Full content

- [llms-full.txt](https://platform.agentsky.dev/docs/llms-full.txt): every page in one document