cyrus-setup-prerequisites

Checks and installs Node.js, jq, gh CLI, and the cyrus-ai package for Cyrus setup.

794|163|Updated Apr 19, 2025
One-click install
npx skills add https://github.com/ceedaragents/cyrus --skill cyrus-setup-prerequisites
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cyrus-setup-prerequisites
Source: https://github.com/ceedaragents/cyrus/tree/main/skills/cyrus-setup-prerequisites
Command: npx skills add https://github.com/ceedaragents/cyrus --skill cyrus-setup-prerequisites

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up Cyrus requires several system dependencies (Node.js, jq, GitHub CLI) and the cyrus-ai npm package, and manually verifying each one across different operating systems and package managers is error-prone. This Skill automates the detection and installation of every prerequisite before onboarding begins.

Core Features & Use Cases

  • Dependency Detection: Runs version checks for Node.js (>= 18), jq, and the gh CLI, then reports pass/fail status for each.
  • Guided Installation: Detects the OS via uname and provides the correct install commands for macOS (Homebrew) or Linux/Ubuntu (apt), waiting for user confirmation before installing.
  • Package Manager Flexibility: Installs cyrus-ai globally using the user's preferred package manager — npm, pnpm, bun, or yarn — and verifies the installation with cyrus --version.
  • Use Case: A developer self-hosting Cyrus for the first time runs this Skill to confirm their machine has Node.js 22, jq, and gh installed, installs cyrus-ai via pnpm, and prepares the ~/.cyrus directory before configuring integrations.

Quick Start

Ask the agent to check and install all Cyrus prerequisites on this machine using your preferred package manager.

Frequently Asked Questions about cyrus-setup-prerequisites

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

FAQPage Schema
How do I install prerequisites for Cyrus self-hosting?

Run the cyrus-setup-prerequisites skill, which checks for Node.js >= 18, jq, and the gh CLI, then installs any missing tools using Homebrew on macOS or apt on Ubuntu. It finishes by installing the cyrus-ai package globally with your chosen package manager.

What dependencies does Cyrus require to run?

Cyrus requires Node.js version 18 or higher, jq for Claude Code output parsing, and the GitHub CLI (gh) for GitHub integration. The cyrus-ai npm package itself is installed globally, and agent-browser is an optional extra for automated app creation.

Can I install cyrus-ai with pnpm, bun, or yarn instead of npm?

Yes, the skill asks which package manager you prefer and supports npm, pnpm, bun, and yarn. It runs the matching global install command, such as pnpm install -g cyrus-ai or bun install -g cyrus-ai, then verifies with cyrus --version.

Is agent-browser required for Cyrus setup?

No, agent-browser is optional. It enables automated creation of Linear, GitHub, and Slack apps during onboarding, but without it the setup falls back to guided manual steps. You can install it anytime with npm install -g agent-browser.

Why does the skill avoid reading the ~/.cyrus/.env file?

The .env file contains secrets such as API tokens, so the skill forbids Read, Edit, or Write tool access to it. Only Bash commands like grep and printf >> are used, ensuring credentials never enter the conversation context.