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)