Verified:GitHub

cyrus-setup

Automates end-to-end installation and configuration of the Cyrus agent across Linear, GitHub, GitLab, and Slack.

794|163|Updated Apr 19, 2025

Search Tags:#linear #Slack #Automation #Browser Automation #gitHub #Setup #cyrus

One-click install

npx skills add https://github.com/ceedaragents/cyrus --skill cyrus-setup

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: cyrus-setup
Source: https://github.com/ceedaragents/cyrus/tree/main/skills/cyrus-setup
Command: npx skills add https://github.com/ceedaragents/cyrus --skill cyrus-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up a self-hosted Cyrus agent requires many manual steps: installing prerequisites, configuring Claude authentication, exposing a webhook endpoint, creating Linear/GitHub/GitLab/Slack apps, and connecting repositories. This Skill orchestrates the entire onboarding flow so you can get Cyrus running as a background agent without following a lengthy manual guide.

Core Features & Use Cases

Orchestrated Sub-Skills: Runs nine ordered sub-skills (prerequisites, Claude auth, endpoint, Linear, GitHub, GitLab, Slack, repository, launch) with skip-if-done logic so re-runs are safe.
Browser Automation: Uses claude-in-chrome MCP tools or the agent-browser CLI to navigate web UIs, fill forms, and scrape credentials, with a manual guided fallback.
Secret-Safe Configuration: Never reads or writes ~/.cyrus/.env directly; secrets are handled only through user-approved shell commands.
Use Case: A developer wants Cyrus to monitor Linear issues and open GitHub PRs. They run /cyrus-setup, answer a few questions about agent name, surfaces, and package manager, and the agent completes the full installation and launch.

Quick Start

Ask your AI coding agent to run the cyrus-setup skill to install and configure Cyrus end-to-end for your chosen platforms.

Frequently Asked Questions about cyrus-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I set up Cyrus as a self-hosted agent?▼

Run the /cyrus-setup command in an AI coding agent after installing the skill with npx skills add ceedaragents/cyrus. The orchestrator walks through prerequisites, authentication, endpoint configuration, integrations, repositories, and launch in order.

How do I automate Linear and Slack app creation during setup?▼

The skill uses browser automation, preferring claude-in-chrome MCP tools if available, otherwise the agent-browser CLI with a fresh Chrome profile. If neither exists, it falls back to step-by-step manual guided instructions.

Can I re-run cyrus-setup without breaking my configuration?▼

Yes, every sub-skill checks existing state first and skips completed steps. Re-running /cyrus-setup is safe and can be used to add new integrations or fix configuration later.

Does cyrus-setup support GitLab and Slack in addition to Linear and GitHub?▼

Yes, during Step 0 you select which surfaces to configure: Linear, GitHub, GitLab, or Slack. Only the selected integration sub-skills run, and Slack app creation always uses the manifest-based flow.

How does cyrus-setup handle API keys and secrets?▼

The agent never reads or writes ~/.cyrus/.env directly with file tools. Secrets are scraped via browser automation or written through user-approved shell commands, keeping credentials out of the conversation context.