An automated agent designed to integrate Linear issue tracking with AI-powered code processing using Claude Code. It targets developers and teams seeking to automate task management, code generation, and issue resolution, offering benefits like reduced manual effort and faster development cycles through AI assistance.

How It Works

Cyrus monitors Linear issues assigned to it, automatically creating isolated Git worktrees for each task. It then invokes Claude Code sessions to process the issue's requirements, potentially generating code or performing other AI-driven actions. Activity updates, including rich interactions like dropdown selects and approval prompts, are streamed back to Linear. The system can also create pull requests upon successful completion, automating a significant portion of the development workflow.

Quick Start & Requirements

• Installation: For self-hosted deployments, install via npm: npm install -g cyrus-ai. Cloud-hosted options are managed through app.atcyrus.com.
• Prerequisites: Requires Node.js (implied by npm). Authentication is handled via a provided token (cyrus auth). Git and GitHub CLI must be configured for pull request creation. Crucially, users must supply their own Claude Code API keys and manage associated billing. The "Community" plan requires hosting your own Linear OAuth application.
• Running: Self-hosted instances require a persistent process manager like tmux, pm2, or systemd.
• Links: app.atcyrus.com (Pro/Team plans), End-to-End Self-Hosting Guide, Git & GitHub Setup, Configuration Reference, Cloudflare Tunnel Setup, Setup Scripts.

Highlighted Details

• Direct integration with Linear for issue tracking and Claude Code for AI-driven processing.
• Automated creation of isolated Git worktrees per issue for clean task management.
• Streams detailed agent activity and rich interactive elements back to Linear.
• Offers multiple deployment models: self-hosted (Pro, Team, Community) and cloud-hosted (Pro, Team).
• The "Community" plan provides a zero-cost, end-to-end self-hosted option.

Maintenance & Community

The provided README does not detail specific maintenance practices, notable contributors, sponsorships, or community channels (e.g., Discord, Slack).

Licensing & Compatibility

Licensed under the GNU General Public License v3.0 (GPLv3). This copyleft license may impose restrictions on linking with proprietary or closed-source software.

Limitations & Caveats

Users must provide their own Claude Code API keys and manage billing. The "Community" (end-to-end self-hosted) option requires significant setup effort, including hosting the Linear OAuth application.