cyrus
The Claude Code background agent for Linear, Slack, Github, GitLab etc. you deploy anywhere. Supports Codex, Cursor, Gemini, and Opencode harnesses too.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/cyrusagents/cyrus with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/cyrusagents/cyrus'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/cyrusagents-cyrus)HTML
<a href="/listings/cyrusagents-cyrus"><img src="/api/listings/cyrusagents-cyrus/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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](./docs/SELF_HOSTING.md)** if you prefer.
---
Pro & Team Plans
Configure Cyrus through the dashboard at [app.atcyrus.com](https://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](./docs/GIT_GITHUB.md)** or **[Git & GitLab Setup](./docs/GIT_GITLAB.md)**.
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](./docs/SELF_HOSTING.md#running-as-a-service)
For cloud-hosted deployments
No installation required. Everything is managed through [app.atcyrus.com](https://app.atcyrus.com).
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 90 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # Cyrus
- <div>
- <a href="https://github.com/ceedaragents/cyrus/actions">
- <img src="https://github.com/ceedaragents/cyrus/actions/workflows/ci.yml/badge.svg" alt="CI">
- </a>
- </div>
- [](https://discord.gg/prrtADHYTt)
- 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.
- ```bash
- 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](./docs/SELF_HOSTING.md)** if you prefer.
- ---
- ### Pro & Team Plans
- Configure Cyrus through the dashboard at [app.atcyrus.com](https://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.
- ```bash
- # 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](./docs/GIT_GITHUB.md)** or **[Git & GitLab Setup](./docs/GIT_GITLAB.md)**.
- 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](./docs/SELF_HOSTING.md#running-as-a-service)
- #### For cloud-hosted deployments
- No installation required. Everything is managed through [app.atcyrus.com](https://app.atcyrus.com).
- ---
- ## More Documentation
- - **[End-to-End Community Guide](./docs/SELF_HOSTING.md)** - Complete community manual setup
- - **[Git & GitHub Setup](./docs/GIT_GITHUB.md)** - Git and GitHub CLI configuration for PRs
- - **[Git & GitLab Setup](./docs/GIT_GITLAB.md)** - Git and GitLab CLI configuration for MRs
- - **[Zulip Setup](./docs/ZULIP.md)** - Answer @mentions in Zulip topics and DMs
- - **[Plane Setup](./docs/PLANE.md)** - Take work from Plane work items (cloud or self-hosted)
- - **[Configuration Reference](./docs/CONFIG_FILE.md)** - Detailed config.json options
- - **[Cloudflare Tunnel Setup](./docs/CLOUDFLARE_TUNNEL.md)** - Expose your local instance
- - **[Setup Scripts](./docs/SETUP_SCRIPTS.md)** - Repository and global initialization scripts
- ---
- ## License
- This project is licensed under the Apache 2.0 license - see the [LICENSE](LICENSE) file for details.
- ## Credits
- This project builds on the technologies built by the awesome teams at Linear, and Claude by Anthropic:
- - [Linear API](https://linear.app/developers)
- - [Anthropic Claude Code](https://www.claude.com/product/claude-code)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.