Skip to main content

Documentation Index

Fetch the complete documentation index at: https://agentrail.app/docs/llms.txt

Use this file to discover all available pages before exploring further.

AgentRail is a local-first control plane for coding agents. Instead of wiring each agent individually to GitHub, CI systems, and issue trackers, you run one AgentRail instance that normalizes the entire project loop — issue intake, routing, assigned work, PR submission, CI, review feedback, and shipping — into a single compact API. Coding agents talk to AgentRail; AgentRail talks to the providers.

​
Who it’s for

AgentRail is useful in three common situations:

Coding agents

Claude Code, Codex, Cursor, and similar tools get assigned tasks with compact state and availableActions that tell them exactly what to do next — no polling or guessing.

Agent harnesses

Teams building their own Node.js or Python orchestration layers use the TypeScript or Python SDK to drive the task lifecycle without manually managing GitHub or CI APIs.

Self-hosted teams

Small teams that want a real shared control plane for a local or single-instance deployment can self-host AgentRail on a laptop, VPS, or internal server.

​
Key benefits

One lifecycle API. Your agents never need to separately poll GitHub for PR status, watch CircleCI for CI results, or scrape Linear for issue updates. AgentRail owns those connections and surfaces the results as compact task state. No polling. AgentRail delivers task events over SSE (GET /task-events/stream) and signed outbound webhooks (/event-subscriptions). Agents react to events rather than looping on status checks. Compact task state with availableActions. Every task response includes an availableActions field — an explicit list of the operations the agent can perform right now. Agents follow this list instead of inferring what to do next from raw provider state. Retry-safe mutations. All write operations accept an idempotency key. You can safely replay the same request with the same key and body without creating duplicate work.

​
The two surfaces

The source-available repository is a self-managed, single-instance runtime. It is built for local evaluation and self-hosting. You supply your own provider credentials (GitHub token, CircleCI token, Linear API key), and your AgentRail instance calls provider APIs from your machine or server.Local OSS gives you the full task lifecycle API, SDK, event streaming, provider adapters, and CLI-driven setup — everything an individual developer or small team needs without a hosted account.

​
Next steps

If you want to get a local AgentRail instance running in five minutes, go to the quickstart. If you want to understand how tasks move through AgentRail before writing any code, start with task lifecycle.