mcpField
C
cyrus-setup-prerequisites

cyrus-setup-prerequisites

github.com/cyrusagentsDevelopment8791.0k installsUpdated today
Repository

About cyrus-setup-prerequisites

A prerequisite setup skill that checks dependencies and installs cyrus-ai. It guides users through package-manager selection, optional browser automation setup, and verification of the installed CLI.

Key features

  1. 01Checks Node.js, jq, and GitHub CLI
  2. 02Offers installation steps for missing dependencies
  3. 03Checks optional agent-browser availability
  4. 04Installs cyrus-ai with the chosen package manager
  5. 05Verifies the CLI and creates its config directory

Use cases

  1. 01Preparing a system for Cyrus setup
  2. 02Installing missing runtime and integration dependencies
  3. 03Installing or verifying cyrus-ai

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cyrusagents/cyrus --skill cyrus-setup-prerequisites

After installing, type/cyrus-setup-prerequisitesin Claude Code to confirm it loaded.

Details

From the project README

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 Prerequisites

Checks system prerequisites and installs cyrus-ai.

Step 1: Detect Package Manager

If the user hasn't already specified their preferred package manager, ask:

Which package manager do you prefer? npm, pnpm, bun, or yarn?

Store the answer for use in this and subsequent skills.

Step 2: Check System Dependencies

Run the following checks and report results:

# Node.js >= 18
node --version

# jq (required for Claude Code parsing)
jq --version

# GitHub CLI (required for GitHub integration)
gh --version

For each missing dependency, provide the install command:

DependencymacOSLinux/Ubuntu
Node.jsbrew install nodecurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs
jqbrew install jqsudo apt install -y jq
ghbrew install ghSee https://github.com/cli/cli/blob/trunk/docs/install_linux.md

If all dependencies are present, print a checkmark for each and continue.

If any are missing, offer to install them (detect OS via uname). Wait for user confirmation before installing.

Step 3: Check for agent-browser (Optional)

If the user selected any integration surface (Linear, GitHub, Slack), check for agent-browser:

which agent-browser

If installed, ensure it's up to date:

npm update -g agent-browser

If not found, inform the user:

agent-browser is optional but enables automated app creation for Linear/GitHub/Slack. Without it, you'll be guided through manual setup steps instead.

Install with: npm install -g agent-browser

Do NOT block on this — it's optional. Note whether it's available for downstream skills.

Step 4: Install cyrus-ai

Check if already installed:

which cyrus

If not found, install using the user's preferred package manager:

# npm
npm install -g cyrus-ai

# pnpm
pnpm install -g cyrus-ai

# bun
bun install -g cyrus-ai

# yarn
yarn global add cyrus-ai

Verify installation:

cyrus --version

Step 5: Ensure ~/.cyrus directory exists

mkdir -p ~/.cyrus

If ~/.cyrus/.env already exists, note it and inform the user that existing values will be preserved.

Completion

Print a summary:

Prerequisites:
  ✓ Node.js v22.x
  ✓ jq 1.7
  ✓ gh 2.x
  ✓ cyrus-ai installed
  ✓ agent-browser available (or: ⚠ not installed — manual setup mode)

Comments

Markdown supported