RelayRunner docs: Set up with an agent Page: https://relayrunner.app/docs/get-started/agents Markdown: https://relayrunner.app/docs/get-started/agents.md All pages: https://relayrunner.app/docs/llms.txt Other pages (Markdown): - Changelog: https://relayrunner.app/docs/changelog.md - CLI changelog: https://relayrunner.app/docs/changelog/cli.md - CI traces in your observability tool: https://relayrunner.app/docs/changelog/opentelemetry-traces.md - Platform changelog: https://relayrunner.app/docs/changelog/platform.md - Retries, queueing and provider usage: https://relayrunner.app/docs/changelog/retries-queueing-and-provider-usage.md - Optimized checks: https://relayrunner.app/docs/concepts/optimized-checks.md - Principles: https://relayrunner.app/docs/concepts/principles.md - Routing: https://relayrunner.app/docs/concepts/routing.md - Runner order: https://relayrunner.app/docs/concepts/runner-order.md - Add a provider: https://relayrunner.app/docs/contribute/add-provider.md - Feedback: https://relayrunner.app/docs/contribute/feedback.md - Activity and history: https://relayrunner.app/docs/dashboard/activity.md - Performance: https://relayrunner.app/docs/dashboard/performance.md - Remove RelayRunner: https://relayrunner.app/docs/dashboard/remove.md - Signals: https://relayrunner.app/docs/dashboard/signals.md - Telemetry: https://relayrunner.app/docs/dashboard/telemetry.md - Usage and savings: https://relayrunner.app/docs/dashboard/usage.md - Workspaces and members: https://relayrunner.app/docs/dashboard/workspaces.md - Set up with an agent: https://relayrunner.app/docs/get-started/agents.md (this page) - How it works with GitHub Actions: https://relayrunner.app/docs/get-started/github-actions.md - Install the CLI: https://relayrunner.app/docs/get-started/install.md - Move your workflows over: https://relayrunner.app/docs/get-started/move-over.md - Route GitHub Actions jobs to any runner: https://relayrunner.app/docs/get-started/overview.md - Quickstart: https://relayrunner.app/docs/get-started/quickstart.md - Keep up with coding agents: https://relayrunner.app/docs/guides/agent-surge.md - Run CI on your laptop while you work: https://relayrunner.app/docs/guides/laptop-ci.md - macOS and iOS builds on your Mac: https://relayrunner.app/docs/guides/mac-builds.md - Spend controls: https://relayrunner.app/docs/guides/spend-controls.md - Share your team's machines: https://relayrunner.app/docs/guides/team-machines.md - RelayRunner API: https://relayrunner.app/docs/reference/api.md - CLI: https://relayrunner.app/docs/reference/cli.md - Errors: https://relayrunner.app/docs/reference/errors.md - FAQ: https://relayrunner.app/docs/reference/faq.md - GitHub App: https://relayrunner.app/docs/reference/github-app.md - Runner labels: https://relayrunner.app/docs/reference/labels.md - MCP server: https://relayrunner.app/docs/reference/mcp.md - Data and privacy: https://relayrunner.app/docs/reference/privacy.md - relay.yml inputs: https://relayrunner.app/docs/reference/relay-inputs.md - Repo config: https://relayrunner.app/docs/reference/repo-config.md - Security: https://relayrunner.app/docs/reference/security.md - Troubleshooting: https://relayrunner.app/docs/reference/troubleshooting.md - GitHub-hosted: https://relayrunner.app/docs/runners/github.md - Hosted providers: https://relayrunner.app/docs/runners/hosted.md - Providers: https://relayrunner.app/docs/runners/providers.md - Your machines: https://relayrunner.app/docs/runners/self-hosted.md --- # Set up with an agent > Letting a coding agent set up RelayRunner and route your jobs for you. ## Install the skills Give your agent RelayRunner's skills, so it knows the CLI, how to route jobs and how to read your CI: ```sh npx skills add relayrunner/relayrunner ``` It works with Claude Code, Codex, Cursor and most other coding agents, and asks which ones to install for. You get three skills: | Skill | What your agent can do with it | | ------------------------- | -------------------------------------------------------------------------------------------------- | | `relayrunner` | Sign a machine in, put it online, size and isolate jobs on a Mac, set up `relayrunner.yml`. | | `relayrunner-route-jobs` | Route a repo's jobs with `relayrunner init`, and explain the jobs it skips. | | `relayrunner-ci-insights` | Answer questions about your runners, runs and usage through the [MCP server](/docs/reference/mcp). | Run `npx skills update` now and then to get the latest. ## Set up with one prompt Without the skills, your agent can still do the whole setup: sign the machine in, pick which jobs to route, edit the workflows and show you the diff. Paste this into your agent, inside the repo's checkout: ```text Set up relayrunner in this checkout using https://raw.githubusercontent.com/relayrunner/relayrunner/main/docs/agent-install.md ``` The [agent guide](https://github.com/relayrunner/relayrunner/blob/main/docs/agent-install.md) tells the agent to: 1. Check the machine is supported and install the CLI. 2. Sign the machine in with `relayrunner login`. You approve it in the browser. 3. Run `relayrunner init --plan --json` and go over which jobs can be routed, and why some are skipped. 4. Route the jobs you pick with `relayrunner init --apply`, then show you `git diff`. It doesn't commit or push unless you ask. 5. Put the machine online with `relayrunner connect`, ideally in your own terminal so it keeps running after the agent's session ends. Every CLI command the agent uses has a `--json` flag, and every step is safe to retry. ## Let the agent see your CI Agents can also read your workspace through the RelayRunner MCP server: runners, recent runs, where each job ran, and usage. It's read-only. See [MCP server](/docs/reference/mcp) to connect one. ## These docs, for agents Every docs page is also available as Markdown. Add `.md` to a page's URL, or ask for it with `Accept: text/markdown`. [llms.txt](/llms.txt) lists every page, and [llms-full.txt](/llms-full.txt) has them all in one file.