Skip to content
Back to search

cyrus

SkillWorks with CodexGitHub

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cyrusagents-cyrus/badge.svg)](/listings/cyrusagents-cyrus)

HTML

<a href="/listings/cyrusagents-cyrus"><img src="/api/listings/cyrusagents-cyrus/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

  1. # Cyrus
  2. <div>
  3. <a href="https://github.com/ceedaragents/cyrus/actions">
  4. <img src="https://github.com/ceedaragents/cyrus/actions/workflows/ci.yml/badge.svg" alt="CI">
  5. </a>
  6. </div>
  7. [![Discord](https://img.shields.io/discord/1443747721910685792?label=Discord&logo=discord&logoColor=white)](https://discord.gg/prrtADHYTt)
  8. 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.
  9. **Note:** Cyrus is a BYOK platform (bring your keys / subscriptions) for tokens.
  10. ---
  11. ## Getting Started
  12. ### End-to-End Self-Hosted (Community)
  13. 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.
  14. ```bash
  15. npx skills add ceedaragents/cyrus -g
  16. ```
  17. Then in any AI coding agent (Claude Code, Codex, Cursor, etc.):
  18. ```
  19. /cyrus-setup
  20. ```
  21. Or follow the **[manual setup guide](./docs/SELF_HOSTING.md)** if you prefer.
  22. ---
  23. ### Pro & Team Plans
  24. Configure Cyrus through the dashboard at [app.atcyrus.com](https://app.atcyrus.com).
  25. #### For paid self-hosted deployments
  26. 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.
  27. ```bash
  28. # Install Cyrus
  29. npm install -g cyrus-ai
  30. # Authenticate with your token (provided during onboarding)
  31. cyrus auth <your-token>
  32. ```
  33. 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)**.
  34. Keep Cyrus running as a persistent process:
  35. - **tmux**: `tmux new -s cyrus` then run `cyrus` (Ctrl+B, D to detach)
  36. - **pm2**: `pm2 start cyrus --name cyrus`
  37. - **systemd**: See [Running as a Service](./docs/SELF_HOSTING.md#running-as-a-service)
  38. #### For cloud-hosted deployments
  39. No installation required. Everything is managed through [app.atcyrus.com](https://app.atcyrus.com).
  40. ---
  41. ## More Documentation
  42. - **[End-to-End Community Guide](./docs/SELF_HOSTING.md)** - Complete community manual setup
  43. - **[Git & GitHub Setup](./docs/GIT_GITHUB.md)** - Git and GitHub CLI configuration for PRs
  44. - **[Git & GitLab Setup](./docs/GIT_GITLAB.md)** - Git and GitLab CLI configuration for MRs
  45. - **[Zulip Setup](./docs/ZULIP.md)** - Answer @mentions in Zulip topics and DMs
  46. - **[Plane Setup](./docs/PLANE.md)** - Take work from Plane work items (cloud or self-hosted)
  47. - **[Configuration Reference](./docs/CONFIG_FILE.md)** - Detailed config.json options
  48. - **[Cloudflare Tunnel Setup](./docs/CLOUDFLARE_TUNNEL.md)** - Expose your local instance
  49. - **[Setup Scripts](./docs/SETUP_SCRIPTS.md)** - Repository and global initialization scripts
  50. ---
  51. ## License
  52. This project is licensed under the Apache 2.0 license - see the [LICENSE](LICENSE) file for details.
  53. ## Credits
  54. This project builds on the technologies built by the awesome teams at Linear, and Claude by Anthropic:
  55. - [Linear API](https://linear.app/developers)
  56. - [Anthropic Claude Code](https://www.claude.com/product/claude-code)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.