cyrus-setup-repository

SkillAI & models

This skill lets your agent add one or more Git repositories to Cyrus configuration. Once a repository is added, Cyrus can process and work on issues from that repository. Use it to point Cyrus at the repos whose issues you want handled.

Available today. Use it from your connected AI after setup.

After adding this skill, tell your agent which Git repositories Cyrus should follow. It will add them to the configuration so issues from those repos start getting processed.

Then ask your AI: use the cyrus-setup-repository skill

What your AI can do with it

  • Add one or more Git repositories to Cyrus
  • Save repository settings in your Cyrus configuration
  • Process issues from each repository you add
  • Work on issues from the connected repositories

What this skill tells your AI

The instructions your AI receives, as published by cyrusagents/cyrus in skills/cyrus-setup-repository/SKILL.md and read by ahel’s review.

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:

Would you like to add another repository? (y/n)

If yes, repeat Step 2. If no, continue.

Completion

✓ Repository added: <url> (repeat for each added repo)

Signals

GitHub stars
807
Forks
165
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
cyrus-setup-repository
Source
github.com/cyrusagents/cyrus