Cyrus

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

Note: Cyrus requires you to bring your own keys/billing for tokens.

---

Getting Started

Pro & Team Plans

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

For self-hosted deployments

# Install Cyrus
npm install -g cyrus-ai

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

For Cyrus to create pull requests, configure Git and GitHub CLI. See Git & GitHub 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.

---

End-to-End Self-Hosted (Community)

Zero cost option. This requires hosting everything yourself, including your own Linear OAuth app.

Follow the complete End-to-End Community Guide.

---

Documentation

• End-to-End Community Guide - Complete community manual setup
• Git & GitHub Setup - Git and GitHub CLI configuration for PRs
• 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