← Open Source
cyrusagents

cyrus

The Claude Code background agent for Linear, Slack, Github, GitLab etc. you deploy anywhere. Supports Codex, Cursor, Gemini, and Opencode harnesses too.

ApplicationsCodingProductivityTypeScript
Open on GitHub
Momentum
+1stars in 24 hours+0.1%
857
Stars
178
Forks
+7
This week
27
Contributors
Created 2025-04-19 · Updated 2026-10-16 · #6133 today
Top developers
README

Cyrus

Your (Claude Code|Codex|Cursor|Gemini|Opencode) powered (Linear|GitHub|GitLab|Slack) agent. Cyrus monitors (Linear|GitHub|GitLab|Slack) issues assigned to it, creates isolated Git worktrees for each issue, runs (Claude Code|Codex|Cursor|Gemini|Opencode) 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 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, Codex, 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 

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


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:

Nearby in the ranking
Similar items