Cyrus Setup Endpoint

This sets up the public webhook endpoint so Linear and other services can talk to your self-hosted Cyrus instance. It walks you through three options: ngrok (with proper static domain setup using the free tier), Cloudflare Tunnel, or your own URL. The skill is careful about secrets, using clipboard-to-file commands instead of reading tokens into context. It also writes the port config and enables direct webhook verification for Linear, Slack, and GitHub. Run this once when you're first getting Cyrus running locally and need webhooks to reach your machine.

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

View on GitHub

Install

$ npx -y skills add ceedaragents/cyrus --skill cyrus-setup-endpoint --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.

Setup Endpoint

Configures a public URL so Linear (and other integrations) can send webhooks to your Cyrus instance.

Step 1: Check Existing Configuration

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

If CYRUS_BASE_URL is already set, inform the user:

Webhook endpoint already configured: <value> To reconfigure, remove CYRUS_BASE_URL from ~/.cyrus/.env and re-run this skill.

Skip to Step 4 (write port/webhooks if missing).

Step 2: Choose Endpoint Method

Ask the user:

How will you expose Cyrus to the internet for webhooks?

ngrok (recommended — every free account includes one static domain that persists across restarts)

Cloudflare Tunnel (permanent, requires Cloudflare account)

Own URL (you already have a public URL/domain)

SKILL.md on GitHub