命令行

没有桌面的机器上加入团队;在脚本里触发定时任务、发起交接。

yihee 命令行有两个用处:

  1. 在没有桌面环境的机器上(服务器、CI)加入团队,同步项目和 Skill。这部分独立运行。
  2. 在自己电脑的终端里操作桌面应用里的定时任务和交接。这部分要求桌面应用正在运行。

安装

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 等桌面应用响应超时