Cyrus Setup Linear

Automates creating a Linear OAuth app and wiring it into Cyrus so your agent can respond to issues and receive webhooks. It'll preflight your existing config, then either drive the browser directly (via claude-in-chrome or agent-browser) or walk you through manual setup with exact field values. Critically, it never reads secrets into context,you copy credentials yourself into the env file, and it just verifies they're present. Ends by running the OAuth flow so your workspace is authorized. Good first step if you're self-hosting Cyrus and want Linear integration without fumbling through API docs.

skills.sh installs: 260
GitHub stars: 615
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add ceedaragents/cyrus --skill cyrus-setup-linear --agent claude-code

Installs into .claude/skills of the current project.

Files

CRITICAL: Never use Read, Edit, or Write tools on ~/.cyrus/.env or any file inside ~/.cyrus/. Use only Bash commands (grep, printf >>, etc.) to interact with env files — secrets must never be read into the conversation context. Never scrape, extract, or read secret values from web pages — guide the user to copy them manually.

Setup Linear

Creates a Linear OAuth application and configures credentials so Cyrus can receive webhooks and respond to issues.

Step 1: Check Existing Configuration

grep -E '^LINEAR_CLIENT_ID=' ~/.cyrus/.env 2>/dev/null

If LINEAR_CLIENT_ID is already set, check if OAuth is also complete:

grep -q '"workspaces"' ~/.cyrus/config.json 2>/dev/null && echo "configured" || echo "not configured"

If both are set, inform the user:

Linear is already configured. Skipping this step. To reconfigure, remove LINEAR_CLIENT_ID, LINEAR_CLIENT_SECRET, and LINEAR_WEBHOOK_SECRET from ~/.cyrus/.env and re-run.

Skip to completion.

Step 2: Get CYRUS_BASE_URL

Read the base URL from the env file (set by setup-endpoint):

grep '^CYRUS_BASE_URL=' ~/.cyrus/.env | cut -d= -f2-

SKILL.md on GitHub

Details

Repository: github.com/ceedaragents/cyrus
First seen: Jun 3, 2026

More from ceedaragents/cyrus

All 14