cyrus-ai

cyrus-ai

AI development agent for Linear powered by Claude Code.

Installation

npm install -g cyrus-ai

Usage

Start the agent

cyrus

Available Commands

• cyrus - Start the edge worker (default)
• cyrus add-repository - Add a new repository configuration
• cyrus check-tokens - Check the status of all Linear tokens
• cyrus refresh-token - Refresh a specific Linear token

Adding Repositories

After initial setup, you can add additional repositories without restarting Cyrus:

cyrus add-repository

This command will:

• Check for existing Linear credentials and reuse them if available
• Start OAuth flow only if no credentials are found
• Guide you through configuring the new repository
• Save the updated configuration

The interactive wizard will prompt you for:

• Repository path (must be absolute)
• Base branch (defaults to 'main')
• Workspace directory for git worktrees
• Whether the repository is active

Configuration

Environment Variables

• CYRUS_HOST_EXTERNAL - Set to true to allow external connections (listens on 0.0.0.0 instead of localhost). Default: false
  • Use this when running in Docker containers or when you need external access to the webhook server
  • When true: Server listens on 0.0.0.0 (all interfaces)
  • When false or unset: Server listens on localhost (local access only)