命令行
没有桌面的机器上加入团队;在脚本里触发定时任务、发起交接。
yihee 命令行有两个用处:
- 在没有桌面环境的机器上(服务器、CI)加入团队,同步项目和 Skill。这部分独立运行。
- 在自己电脑的终端里操作桌面应用里的定时任务和交接。这部分要求桌面应用正在运行。
安装
macOS 和 Linux:
curl -fsSL https://us.yihee.ai/updates/cli-install.sh | bash
装到 ~/.yihee/bin,之后会自己保持最新。
三个系统都可以用 npm(Windows 只能用这种):
npm install -g @linsoai/yihee
加入团队
yihee onboard --code TS-4F9A2C01B7
这一条命令会依次做四件事:加入团队、检查本机环境、同步项目、安装团队 Skill。
连自己部署的服务器时加 --server https://你的地址。
同步私有仓库前,本机要先 gh auth login(GitLab 用 glab auth login)。命令行不保存仓库凭据。
日常命令
| 命令 | 做什么 |
|---|---|
yihee whoami |
显示加入了哪些团队、你是谁 |
yihee status |
本机团队仓库的状态 |
yihee sync |
克隆缺的仓库,快进干净的仓库 |
yihee doctor |
检查本机环境和配置 |
yihee skill status |
团队 Skill 装没装、是不是最新 |
yihee skill install |
安装或更新团队 Skill |
yihee exclude add <仓库> |
不同步某个仓库 |
yihee schedule install |
装一条系统定时,每 15 分钟跑一次 yihee sync |
yihee update |
升级命令行本身 |
yihee logout |
退出团队 |
常用参数:
--json:输出机器可读的 JSON。所有命令都支持。-w <团队名或 ID>:加入了多个团队时,只对其中一个操作。--dry-run:只说会做什么,不真的做。sync和skill支持。--strict:有需要处理的仓库时以非零退出码结束。适合放在 CI 里。
yihee sync 的规则和桌面应用一样:不推送,不覆盖本地改动。
定时任务
这一组命令操作的是桌面应用里的定时任务,应用没开会直接报错。
yihee task list
yihee task run <任务 ID>
yihee task run <任务 ID> --note "部署刚完成,查一下错误率"
yihee task pause <任务 ID>
yihee task resume <任务 ID>
--note 带的那句话会一起发给 agent,适合在部署脚本、Git 钩子里用:出了某件事,就让某个任务马上跑一轮,并告诉它为什么。
task run 排上队就返回,不等这一轮跑完。
新建任务:
yihee task create \
--name "线上巡检" \
--prompt "检查线上各服务的错误率,和昨天比有没有明显变化" \
--every 1h \
--runtimes claude,codex \
--enabled
| 参数 | 意思 |
|---|---|
--cron / --every / --interval |
计划,三选一。--every 是固定间隔,--interval 是上一轮结束后再等这么久 |
--runtimes |
用哪些 agent,逗号分隔,按失败后的替补顺序 |
--working-dir |
在哪个目录里干活 |
--precheck |
开跑前检查脚本 |
--session-mode |
persistent(默认)、fresh、bound |
--max-rounds |
最多跑几轮 |
--max-run-ms |
每轮最长,毫秒 |
--enabled |
建好就启用。不带的话建出来是暂停的 |
团队任务不能用 task run 触发,要在桌面应用里点。
交接
同样要求桌面应用正在运行。
yihee handoff members # 能交给谁
yihee handoff sessions # 当前目录下有哪些会话可以交
yihee handoff send --to 小王 --note "测试还没跑完,先看 auth 模块"
yihee handoff inbox # 别人交给我的
yihee handoff outbox # 我交出去的
send 不指定会话时,交的是当前目录下最近活跃的那一条。要指定用 --session-id。
装了 yihee-session-handoff 这个 Skill 后,终端里的 agent 会替你运行这些命令,你只要对它说「交给小王」。
管理员
yihee admin invites create --role member --days 7
yihee admin members list
yihee admin projects add repo https://github.com/acme/api.git
yihee admin projects add github-org acme
yihee admin skill-source set acme/team-skills
退出码
写脚本时用得上:
| 退出码 | 意思 |
|---|---|
| 0 | 成功 |
| 1 | 其他错误,或者被拒绝(例如任务正忙) |
| 2 | 参数不对 |
| 3 | 没登录,或者不是管理员 |
| 4 | 找不到:团队、任务、成员、会话 |
| 5 | 网络或服务器错误 |
| 6 | 带了 --strict,并且有需要处理的仓库 |
| 7 | 缺依赖 |
| 8 | 桌面应用没在运行 |
| 9 | 等桌面应用响应超时 |