https://github.com/ceedaragents/cyrus
Your Claude Code powered Linear agent that runs on any machine
https://github.com/ceedaragents/cyrus
agent ai claude claudecode engineer linear
Last synced: about 1 month ago
JSON representation
Your Claude Code powered Linear agent that runs on any machine
- Host: GitHub
- URL: https://github.com/ceedaragents/cyrus
- Owner: ceedaragents
- License: apache-2.0
- Created: 2025-04-19T18:53:49.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-21T19:56:28.000Z (3 months ago)
- Last Synced: 2026-01-21T20:51:49.382Z (3 months ago)
- Topics: agent, ai, claude, claudecode, engineer, linear
- Language: TypeScript
- Homepage: https://atcyrus.com
- Size: 9.87 MB
- Stars: 292
- Watchers: 2
- Forks: 46
- Open Issues: 92
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.internal.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Cyrus
[](https://discord.gg/prrtADHYTt)
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](https://app.atcyrus.com).
#### For self-hosted deployments
```bash
# Install Cyrus
npm install -g cyrus-ai
# Authenticate with your token (provided during onboarding)
cyrus auth
```
For Cyrus to create pull requests, configure Git and GitHub CLI. See **[Git & GitHub Setup](./docs/GIT_GITHUB.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).
---
### 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](./docs/SELF_HOSTING.md)**.
---
## 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
- **[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)