Cyrus

Your Claude Code and Cursor powered Linear and GitHub agent. Cyrus monitors issues assigned to it, creates isolated Git worktrees for each issue, runs Claude Code or Cursor sessions to process them, and streams detailed agent activity updates back to Linear, along with rich interactions like dropdown selects and approvals.

Note: Cyrus is a BYOK platform (bring your keys / subscriptions) for tokens.

---

Getting Started

End-to-End Self-Hosted (Community)

Zero cost option — host everything yourself with your own Linear OAuth app, GitHub App, and Slack App. An AI-guided setup skill handles the entire onboarding: installing dependencies, configuring auth, creating integration apps, and connecting repositories — so you don't have to follow a manual guide.

npx skills add ceedaragents/cyrus -g

Then in any AI coding agent (Claude Code, Cursor, etc.):

/cyrus-setup

Or follow the manual setup guide if you prefer.

---

Pro & Team Plans

Configure Cyrus through the dashboard at app.atcyrus.com.

For paid self-hosted deployments

It is called 'self-hosted' because it uses a machine you control as the agent runtime. Networking layer and integrations are provided by the Cyrus cloud provider.

# Install Cyrus
npm install -g cyrus-ai

# Authenticate with your token (provided during onboarding)
cyrus auth <your-token>

For Cyrus to create pull requests or merge requests, configure Git and your hosting CLI. See Git & GitHub Setup or Git & GitLab Setup.

Keep Cyrus running as a persistent process:

• tmux: tmux new -s cyrus then run cyrus (Ctrl+B, D to detach)
• pm2: pm2 start cyrus --name cyrus
• systemd: See Running as a Service

For cloud-hosted deployments

No installation required. Everything is managed through app.atcyrus.com.

---

More Documentation

• End-to-End Community Guide - Complete community manual setup
• Git & GitHub Setup - Git and GitHub CLI configuration for PRs
• Git & GitLab Setup - Git and GitLab CLI configuration for MRs
• Configuration Reference - Detailed config.json options
• Cloudflare Tunnel Setup - Expose your local instance
• Setup Scripts - Repository and global initialization scripts

---

License

This project is licensed under the Apache 2.0 license - see the LICENSE file for details.

Credits

This project builds on the technologies built by the awesome teams at Linear, and Claude by Anthropic:

• Linear API
• Anthropic Claude Code