> ## Documentation Index
> Fetch the complete documentation index at: https://atcyrus.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cyrus

Cyrus is an intelligent agent that automates software development tasks by integrating Linear project management with Claude Code.

It monitors Linear issues assigned to it, creates isolated Git worktrees for each issue, runs Claude Code sessions to process them, and posts responses back to Linear as comments from the safety and security of your own computer, or a dedicated Virtual Private Server (VPS) managed by us.

## Key features

<Card title="Automated Issue Processing" icon="sparkles" horizontal>
  Cyrus automatically monitors your Linear workspace for issues assigned to it and processes them using Claude Code, creating pull requests and providing updates directly in Linear.
</Card>

<Card title="Concurrent tasks " icon="people-group" horizontal>
  Each issue is processed in its own Git worktree, preventing interference between concurrent tasks and maintaining a clean development environment.
</Card>

<Card title="Flexible Hosting Options" icon="computer" horizontal>
  Run Cyrus **self-hosted** (on your machine) or **cloud-hosted** (on our infrastructure). The Pro plan is self-hosted only, while the Team plan can run either self-hosted or cloud-hosted. Both options keep your code secure and let you bring your own Claude Code API keys.
</Card>

Cyrus is ideal for:

* **Development Teams** using Linear for project management
* **Solo Developers** who want AI assistance with their Linear workflow
* **Organizations** seeking to automate routine development tasks
* **Teams** wanting to leverage Claude Code in a structured, collaborative way

## How it works

<Steps>
  <Step title="Assign Issue to Cyrus">
    Cyrus actively watches for Linear issues assigned to it and will automatically begin understanding the issue.
  </Step>

  <Step title="Cyrus Processes Ticket">
    Cyrus will use the issue to creates an isolated Git worktree and runs Claude Code to address the issue, while providing a real time log of the workflow directly on linear.
  </Step>

  <Step title="Review and Deploy">
    Once complete, Cyrus will creates pull requests, posts final updates back to Linear. Ready for your review.
  </Step>
</Steps>

***

<Note>
  Cyrus requires you to bring your own Claude Code API keys and billing. Your API usage costs are separate from the Cyrus subscription.
</Note>

## Understanding API usage

Cyrus typically uses more tokens than running Claude Code locally (around 3-5x depending on task complexity). This is because Cyrus is designed to **verify its own work**:

1. **Self-verification loops**: After completing work, Cyrus checks its output against your issue's acceptance criteria and loops up to 3 times to fix any issues
2. **Autonomous iteration**: Rather than asking you to review and correct multiple times, Cyrus validates and iterates independently
3. **Higher quality output**: The trade-off is fewer back-and-forth corrections and more reliable results

To optimize token usage, provide clear [acceptance criteria](/writing-great-issues) in your issues so Cyrus can efficiently verify its work in fewer iterations.

## Ready to get started?

Head over to [Installation & Quick Start](/getting-started) to set up Cyrus in minutes.

## Join the Cyrus community

Where you can talk directly with the Cyrus Team, suggest features and share feedback. Join the conversation and lets all ship together!

<Card title="Cyrus Community" href="https://discord.com/invite/prrtADHYTt" img="https://mintcdn.com/ceedaraiinc/75NMRUlNh03-gDHX/images/cyrus-f1.png?fit=max&auto=format&n=75NMRUlNh03-gDHX&q=85&s=947d2de0018937ce613572349bc91f06" width="1120" height="928" data-path="images/cyrus-f1.png">
  Connect with builders on Discord and get support.
</Card>