skills.rest
ceedaragents
ceedaragentsOFFICIAL
Explore all skills by this author →
GitHub

cyrus-setup-repository

Registers Git repositories with Cyrus so it can process issues from those codebases.

794|163|Updated Apr 19, 2025
Search Tags:#Git#CLI#linear#repository setup#Configuration#issue automation#cyrus
One-click install
npx skills add https://github.com/ceedaragents/cyrus --skill cyrus-setup-repository
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cyrus-setup-repository
Source: https://github.com/ceedaragents/cyrus/tree/main/skills/cyrus-setup-repository
Command: npx skills add https://github.com/ceedaragents/cyrus --skill cyrus-setup-repository

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cyrus can only work on issues from repositories it knows about. This Skill walks you through adding Git repositories to your Cyrus configuration so the agent can clone them, create worktrees, and process issues from those codebases.

Core Features & Use Cases

  • Repository Registration: Runs cyrus self-add-repo <url> to clone a repository into ~/.cyrus/repos/ and register it with the Linear workspace.
  • Existing Config Inspection: Checks ~/.cyrus/config.json to show which repositories are already configured before adding new ones.
  • Multi-Workspace Support: Prompts for a workspace name when multiple Linear workspaces are configured.
  • Use Case: After installing Cyrus, you want it to handle issues from your team's backend and frontend repos. Use this Skill to add both Git URLs, verify registration, and confirm the configuration.

Quick Start

Ask the agent to add your Git repository URL to Cyrus so it can start processing issues from that repo.

Frequently Asked Questions about cyrus-setup-repository

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

FAQPage Schema
How do I add a repository to Cyrus?▼

Run `cyrus self-add-repo <git-url>` from the terminal or ask your AI agent to do it. The command clones the repository into ~/.cyrus/repos/ and registers it with your Linear workspace so Cyrus can process its issues.

How do I add a repository to a specific Linear workspace in Cyrus?▼

Pass the workspace name as a second argument: `cyrus self-add-repo <url> "<workspace name>"`. This is only needed when multiple workspaces are configured; otherwise the default workspace is used.

How can I check which repositories Cyrus already has configured?▼

Inspect ~/.cyrus/config.json with `cat ~/.cyrus/config.json` to list registered repositories. The Skill checks this file first and reports existing repos before adding new ones to avoid duplicates.

Where does Cyrus clone repositories when adding them?▼

Cyrus clones added repositories into the ~/.cyrus/repos/ directory on the machine running the agent. Each registered repo is then used to create isolated Git worktrees when processing issues.

Why should I avoid reading the Cyrus .env file directly?▼

The ~/.cyrus/.env file contains secrets and tokens that must never enter the AI conversation context. The Skill enforces using only Bash commands like grep or printf to interact with env files, never Read, Edit, or Write tools.

Related Skills

Explore More Software Engineering Skills→
jzallenjzallen

linear-cyrus

Automate Linear workflows for proposals, projects, milestones, tasks, and reviews.

Community
Advanced
wuyuxiangXwuyuxiangX

yux-linear-start

Create isolated git worktrees for Linear issues and update issue states.

Community
Intermediate
webbotywebboty

qodo-pr-resolver

Fetch and resolve Qodo PR review issues for the current branch's open pull request.

Community
Advanced
Xipher-LabsXipher-Labs
6

forgejo-cli

Manage Forgejo repositories, issues, pull requests, and releases via the tea CLI.

Official
Intermediate