oo-cli
oo-cli 通过 oo 这个命令，把 OOMOL 账号、已发布 package、connector
action、cloud task 和受管 skill 统一接到终端里。
如果你正在 Codex、Claude Code 或普通 shell 环境里工作，应该先从这里开始，
而不是一上来就接更底层的 API 或 MCP。oo 是终端优先的使用路径，既适合快速
试用已发布能力，也适合处理认证、文件传输和 skill 管理这类运维动作。
oo-cli 适合做什么
- 登录、退出并切换 OOMOL 账号。
- 用一条自由文本查询同时搜索 package 和 connector action。
- 查看 package 元数据，然后创建并跟踪 Cloud Task。
- 直接在终端里调用需要认证的 connector action。
- 把内置或已发布的 skill 安装到 Codex 和 Claude Code。
- 上传输入文件，或下载工作流产出的结果文件。
安装
bun install -g @oomol-lab/oo-cli
快速开始
- 登录：
oo login
- 在 Codex 里直接使用内置的
ooskill：
$oo 帮我生成 OOMOL 字符串的二维码
oo login 和 oo logout 分别是 oo auth login 与 oo auth logout
的别名。
面向 AI 宿主的内置 Skill
第一次启动 oo 时，只要本机已存在受支持的宿主目录，CLI 就会自动安装内置
skill。
- Codex：
${CODEX_HOME:-~/.codex}/skills/oo和${CODEX_HOME:-~/.codex}/skills/oo-find-skills - Claude Code：
~/.claude/skills/oo和~/.claude/skills/oo-find-skills
这两个内置 skill 分工不同：
oo：优先通过已有的oopackage 或 connector action 来完成任务， 而不是临时拼一个本地实现oo-find-skills：搜索已发布的 OOMOL /ooskill 目录，并安装选中的 skill
如果你想手动安装，也可以直接执行：
oo skills install
oo skills install oo-find-skills
主要工作流
同时搜索 package 和 connector
当你的目标更像“我要完成什么”，而不是“我已经知道该走哪种执行路径”时，
优先使用 oo search。
oo search "generate a QR code"
这个命令会返回混合结果集。package 结果代表已发布的 OOMOL 能力，
connector 结果代表可以直接调用的外部服务 action。
直接运行 connector action
如果你已经明确知道自己要调用外部服务 action，就直接进入 connector 命名空间。
oo connector search "send an email"
oo connector run <serviceName> -a <action> -d @input.json
oo connector run 支持 --dry-run 做 payload 校验，也支持通过 --json
输出结构化结果。
查看 package 并把它跑成 cloud task
如果你要直接面向某个已发布 block 走 Cloud Function / Cloud Task 路径，就使用
packages 和 cloud-task 这两组命令。
oo packages search "generate a QR code"
oo packages info foo/bar@latest
oo cloud-task run foo/[email protected] -b main -d '{"text":"OOMOL"}'
oo cloud-task wait <taskId>
oo cloud-task result <taskId>
其中，oo cloud-task run 要求传入 PACKAGE_NAME@SEMVER，而
oo packages info 可以用 @latest 做信息查看。
在工作流和本地之间传文件
当任务需要输入文件，或你需要把远端产物拉回本地时，使用 file 命名空间。
oo file upload ./input.pdf
oo file download <url>
上传文件在服务端保留一天。下载默认写入已配置的
file.download.out_dir，如果未配置，则回落到 ~/Downloads。
命令分组速览
| 分组 | 关键命令 | 作用 |
|---|---|---|
| 认证 | oo auth ...、oo login、oo logout | 管理账号并校验当前 API Key |
| 配置 | oo config ... | 持久化 CLI 配置，例如语言和下载目录 |
| 搜索 | oo search、oo packages search、oo connector search | 搜索 package、connector 或两者混合结果 |
| 执行 | oo connector run、oo cloud-task ... | 调用 connector action，或创建并跟踪 cloud task |
| Skills | oo skills ... | 列出、搜索、安装、更新、卸载 oo 管理的 skill |
| 文件 | oo file ... | 上传本地输入文件，下载远端输出文件 |
| 日志 | oo log ...、--debug | 查看持久化 debug 日志 |
| 更新 | oo check-update | 检查是否有新的 CLI 版本 |
| Shell | oo completion <shell> | 生成 shell 补全脚本 |
什么时候用 CLI，什么时候用 API 或 MCP
如果你是直接在终端或 AI 编程宿主里操作，并且想尽快拿到结果，就用 CLI。
如果你要把 Cloud Function 调用嵌进自己的应用、后端、脚本或自动化服务，并且需要 直接控制任务创建、轮询和上传流程，请看 API 与 SDK。
如果你要把 OOMOL 能力暴露成可供外部 Agent 框架或 MCP 运行时调用的工具， 就应该使用 MCP。