cyrus-setup-prerequisites

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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.

重要提示：切勿对
~/.cyrus/.env
或
~/.cyrus/
内的任何文件使用
Read
、
Edit
或
Write
工具。仅可使用Bash命令（如
grep
、
printf >>
等）与环境变量文件交互——绝不能将密钥读取到对话上下文中。

Setup Prerequisites

前置依赖设置

Checks system prerequisites and installs

cyrus-ai

检查系统前置依赖并安装

cyrus-ai

。

Step 1: Detect Package Manager

步骤1：检测包管理器

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.

如果用户尚未指定偏好的包管理器，请询问：

你偏好使用哪种包管理器？ npm、pnpm、bun还是yarn？

保存用户的回答，以便在本次及后续操作中使用。

Step 2: Check System Dependencies

步骤2：检查系统依赖

Run the following checks and report results:

bash

undefined

运行以下检查并报告结果：

bash

undefined

Node.js >= 18

node --version

jq (required for Claude Code parsing)

jq（Claude Code解析必需）

jq --version

GitHub CLI (required for GitHub integration)

GitHub CLI（GitHub集成必需）

gh --version


For each missing dependency, provide the install command:

| Dependency | macOS | Linux/Ubuntu |
|-----------|-------|--------------|
| Node.js | `brew install node` | `curl -fsSL https://deb.nodesource.com/setup_22.x \| sudo -E bash - && sudo apt install -y nodejs` |
| jq | `brew install jq` | `sudo apt install -y jq` |
| gh | `brew install gh` | See 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.

gh --version


对于缺失的依赖，提供对应的安装命令：

| 依赖项 | macOS | Linux/Ubuntu |
|-----------|-------|--------------|
| Node.js | `brew install node` | `curl -fsSL https://deb.nodesource.com/setup_22.x \| sudo -E bash - && sudo apt install -y nodejs` |
| jq | `brew install jq` | `sudo apt install -y jq` |
| gh | `brew install gh` | 查看 https://github.com/cli/cli/blob/trunk/docs/install_linux.md |

如果所有依赖均已存在，为每个依赖打印一个对勾并继续。

如果有任何依赖缺失，提供安装选项（通过`uname`检测操作系统）。在安装前等待用户确认。

Step 3: Check for agent-browser (Optional)

步骤3：检查agent-browser（可选）

If the user selected any integration surface (Linear, GitHub, Slack), check for

agent-browser

bash

which agent-browser

If installed, ensure it's up to date:

bash

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.

如果用户选择了任何集成平台（Linear、GitHub、Slack），检查

agent-browser

是否存在：

bash

which agent-browser

若已安装，确保其为最新版本：

bash

npm update -g agent-browser

若未找到，告知用户：

agent-browser
是可选工具，但它能为Linear/GitHub/Slack实现自动化应用创建。如果没有它，你将需要通过手动步骤完成设置。
安装命令：
npm install -g agent-browser

无需在此步骤阻塞——这是可选依赖。记录该工具是否可用，以便后续操作使用。

Step 4: Install cyrus-ai

步骤4：安装cyrus-ai

Check if already installed:

bash

which cyrus

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

bash

undefined

检查是否已安装：

bash

which cyrus

如果未找到，使用用户偏好的包管理器进行安装：

bash

undefined

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:

```bash
cyrus --version

yarn global add cyrus-ai


验证安装：

```bash
cyrus --version

Step 5: Ensure ~/.cyrus directory exists

步骤5：确保~/.cyrus目录存在

bash

mkdir -p ~/.cyrus

~/.cyrus/.env

already exists, note it and inform the user that existing values will be preserved.

bash

mkdir -p ~/.cyrus

如果

~/.cyrus/.env

已存在，记录该情况并告知用户现有值将被保留。

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)

打印总结信息：

前置依赖：
  ✓ Node.js v22.x
  ✓ jq 1.7
  ✓ gh 2.x
  ✓ cyrus-ai已安装
  ✓ agent-browser可用（或：⚠ 未安装——手动设置模式）