Read

Edit

Write

~/.cyrus/.env

~/.cyrus/

Bash

grep

printf >>

Setup Launch

Step 1: Gather Configuration

# Base URL
grep '^CYRUS_BASE_URL=' ~/.cyrus/.env 2>/dev/null | cut -d= -f2-

# Linear
grep -c '^LINEAR_CLIENT_ID=' ~/.cyrus/.env 2>/dev/null

# GitHub
gh auth status 2>&1 | head -1

# Slack
grep -c '^SLACK_BOT_TOKEN=' ~/.cyrus/.env 2>/dev/null

# Repositories
cat ~/.cyrus/config.json 2>/dev/null

# Claude auth
grep -c -E '^(ANTHROPIC_API_KEY|CLAUDE_CODE_OAUTH_TOKEN)=' ~/.cyrus/.env 2>/dev/null

Step 2: Print Summary

┌─────────────────────────────────────┐
│         Cyrus Setup Complete        │
├─────────────────────────────────────┤
│                                     │
│  Endpoint: https://your-url.com     │
│  Claude:   ✓ API key configured     │
│                                     │
│  Surfaces:                          │
│    Linear:  ✓ Workspace connected   │
│    GitHub:  ✓ CLI authenticated     │
│    Slack:   ✓ Bot configured        │
│                                     │
│  Repositories:                      │
│    • yourorg/yourrepo               │
│    • yourorg/another-repo           │
│                                     │
└─────────────────────────────────────┘

Step 3: Make Cyrus Persistent

AskUserQuestion

How would you like to keep Cyrus running in the background?

1. pm2 (recommended) — Node.js process manager. Simple to set up, auto-restarts on crash, log management built in. Best for most users.
2. systemd (Linux only) — OS-level service manager. Starts on boot automatically, managed with

   systemctl

   . Best for dedicated Linux servers.
3. Neither — just run

   cyrus

   in the foreground for now (you can set up persistence later).

Option 1: pm2

1. Check if pm2 is installed (

   which pm2

   ). If not, install it (

   npm install -g pm2

   ).
2. Start Cyrus:

   pm2 start cyrus --name cyrus

3. Save the process list:

   pm2 save

4. Run

   pm2 startup

   — this prints a system-specific command. The agent should run that output command too (it typically requires

   sudo

   ).

• pm2 logs cyrus

  — view logs

• pm2 restart cyrus

  — restart

• pm2 stop cyrus

  — stop

Option 2: systemd (Linux only)

1. Resolve the actual values for the service file:
   bash

   CYRUS_BIN=$(which cyrus)
   CYRUS_USER=$(whoami)

2. Write the service file:
   bash

   sudo tee /etc/systemd/system/cyrus.service > /dev/null << EOF
   [Unit]
   Description=Cyrus AI Agent
   After=network.target
   
   [Service]
   Type=simple
   User=$CYRUS_USER
   EnvironmentFile=/home/$CYRUS_USER/.cyrus/.env
   ExecStart=$CYRUS_BIN
   Restart=always
   RestartSec=10
   
   [Install]
   WantedBy=multi-user.target
   EOF

3. Enable and start:
   bash

   sudo systemctl daemon-reload
   sudo systemctl enable cyrus
   sudo systemctl start cyrus

• sudo systemctl status cyrus

  — check status

• sudo journalctl -u cyrus -f

  — view logs

• sudo systemctl restart cyrus

  — restart

Option 3: Foreground

cyrus

Step 4: Start ngrok (if applicable)

ngrok start cyrus

pm2 start "ngrok start cyrus" --name ngrok
pm2 save

Step 5: Verify Running

curl -s http://localhost:3456/status

{"status":"idle"}

Then try assigning a Linear issue to Cyrus, or @mentioning it in Slack, to verify the full pipeline works!

Completion

✓ Cyrus is running and ready. Assign a Linear issue or @mention in Slack to test it out!