@yxiaoer/soaring-cli

Soaring 任务管理命令行工具

安装完成后，可在任意终端 / Agent 中直接执行 soaring 查看与管理任务。

推荐：让 Agent 安装（网页生成提示词）

1. 打开 Soaring 网页 → 设置 → CLI 工具
2. 生成新 Key
3. 复制弹窗中的 「给 Agent 的安装提示词」（已含密钥、安装步骤、Skill）
4. 粘贴到 Codex / Cursor / Claude Code，让 Agent 执行

装好后可直接说：

• 「我有哪些待处理任务」
• 「看下蚁小二延期的迭代」

Skill 源文件：cli-package/skill/soaring-cli/SKILL.md、.agents/skills/soaring-cli/SKILL.md。

手动安装

npm install -g @yxiaoer/soaring-cli@latest
soaring install --token=soar_cli_xxx
soaring auth whoami

已全局安装时

soaring install
# 或
soaring install --token=soar_cli_xxx

仅更新命令

npm install -g @yxiaoer/soaring-cli@latest

本机调试

soaring install --token=soar_cli_xxx --api-url=http://localhost:3001

本地后端默认端口 3001。

配置说明

• 网页 设置 → CLI 工具 生成密钥（soar_cli_...）
• 配置文件：~/.config/soaring/config.json
• 优先级：--token / --api-url > 环境变量 > 配置文件 > 默认正式环境

常用命令

soaring products list
soaring products list --keyword=蚁小二
soaring users search 张三
soaring tasks list --assignee=me --status=待处理
soaring tasks list --product-id=1 --assignee=me
soaring iterations list --product-id=1

# 评论 CRUD
soaring comments list --module=work_item --target-id=1
soaring comments task-list 1
soaring comments create --module=work_item --target-id=1 --content="进度如何？"
soaring comments task-create 1 --content="进度如何？"
soaring comments update 12 --content="已跟进"
soaring comments delete 12

soaring --help

输出

{ "success": true, "data": {} }
{ "success": false, "error": "..." }

开发

cd cli-package
pnpm install
pnpm run build
npm link
soaring --help