Cyrus Setup Repository

This handles the initial setup for Cyrus by registering Git repositories to your config so it can start processing issues from those codebases. It walks you through checking what's already configured, then adds new repos by running `cyrus self-add-repo` which clones them to `~/.cyrus/repos/` and registers them with your Linear workspace. Worth noting the strong security guidance here: it enforces bash-only interactions with config files to keep secrets out of conversation context, which is the right approach for anything touching credentials. You'll use this once per repo when getting Cyrus connected to your projects, and it supports multi-workspace setups if you need that.

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

View on GitHub

Install

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

Adds Git repositories to Cyrus so it knows which codebases to work with.

Step 1: Check Existing Repositories

cat ~/.cyrus/config.json 2>/dev/null | grep -o '"url"' | wc -l

If repositories are already configured, list them:

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

Inform the user which repos are already added.

Step 2: Add a Repository

Ask the user:

What is the Git URL of the repository you want Cyrus to work with? (e.g., https://github.com/yourorg/yourrepo.git)

Run:

cyrus self-add-repo <url>

This clones the repo to ~/.cyrus/repos/ and registers it with the Linear workspace.

If multiple workspaces are configured, ask which workspace to use:

cyrus self-add-repo <url> "<workspace name>"

Verify the repo was added:

cat ~/.cyrus/config.json | grep "<repo-name>"

Step 3: Add More?

Ask the user:

SKILL.md on GitHub

Details

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

More from ceedaragents/cyrus

All 14