cyrus-ai
v0.2.68
Published
AI-powered Linear issue automation using Claude
Maintainers
Readme
cyrus-ai
AI development agent for Linear powered by Claude Code.
Installation
npm install -g cyrus-aiUsage
Start the agent
cyrusAvailable Commands
cyrus- Start the edge worker (default)cyrus add-repository- Add a new repository configurationcyrus check-tokens- Check the status of all Linear tokenscyrus refresh-token- Refresh a specific Linear token
Adding Repositories
After initial setup, you can add additional repositories without restarting Cyrus:
cyrus add-repositoryThis 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 totrueto allow external connections (listens on0.0.0.0instead oflocalhost). Default:false- Use this when running in Docker containers or when you need external access to the webhook server
- When
true: Server listens on0.0.0.0(all interfaces) - When
falseor unset: Server listens onlocalhost(local access only)
LINEAR_ALLOWED_TOOLS- Comma-separated list of tools allowed for Linear-triggered sessions. OverrideslinearAllowedToolsin~/.cyrus/config.jsonwhen set.DISALLOWED_TOOLS- Comma-separated list of tools disallowed across all sessions. OverridesdefaultDisallowedToolsin~/.cyrus/config.jsonwhen set.
