Skip to content

Latest commit

 

History

History
82 lines (49 loc) · 2.86 KB

File metadata and controls

82 lines (49 loc) · 2.86 KB

Cyrus

Discord

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.

Building from Source

Want to build and run Cyrus from the repository instead of installing the published package?

Follow the Building from Source Guide.


Documentation


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: