C
Cohub
打开应用
EN 中文
开发者

CLI

安装 Cohub CLI，登录，并在终端运行主要 Space 工作流。

Cohub CLI 把同一套产品表面带到终端：Spaces、Chats、files、Saves、Apps、generation 等。

包名：@neta-art/cohub-cli

安装

npm install -g @neta-art/cohub-cli
cohub --help

登录

cohub auth login
cohub auth whoami

CLI 会存储 session 并自动刷新。CLI 自更新会在后台执行，不会阻塞命令；更新成功后从下一次调用开始生效。可设置 COHUB_CLI_AUTO_UPDATE=0 关闭自更新。

在 Sandbox 或 CI 中，可用 COHUB_EXECUTION_TOKEN 覆盖已存储鉴权，用于临时运行。

环境

默认是 production。

ENV=dev cohub auth login
ENV=dev cohub spaces ls

全局 flags

Flag 作用
-s, --space <id> 指定 space-scoped 命令的目标 Space
--json 机器可读输出
-h, --help 命令帮助

很多工作流需要 Space：

cohub -s <spaceId> spaces get
COHUB_SPACE_ID=<spaceId> cohub spaces get

术语

UI CLI
Chat Session
Save Checkpoint
Tasks Task runs
Scheduled prompt spaces prompt schedule / cron jobs

常见工作流

Spaces

cohub spaces ls --json
cohub spaces create --name "Demo" --json
cohub spaces get <spaceId> --json
cohub -s <spaceId> spaces files ls

向 Chat 发送 prompt

cohub -s <spaceId> spaces prompt "Fix the failing tests" --json
cohub -s <spaceId> spaces prompt --title "Planning" "Draft a launch plan" --json
cohub -s <spaceId> spaces prompt --session <sessionId> "Continue from the diff" --json

调度：

cohub -s <spaceId> spaces prompt --at "2026-07-20T09:00:00+08:00" "Weekly review" --json

在 Space 工作区运行命令

cohub -s <spaceId> run -- git status

Files

cohub -s <spaceId> spaces files ls
cohub -s <spaceId> spaces files cat README.md
cohub -s <spaceId> spaces files write notes.md --stdin < notes.md
cohub -s <spaceId> spaces files upload ./src
cohub -s <spaceId> spaces files diff

upload 把文件直接落在 --dir 下；目录入参的内容会直接展开（不多一层目录名），例如 upload dist --dir apps/demo 的结果是 apps/demo/index.html，而不是 apps/demo/dist/index.html。

Apps

--file 与 --dir 接收的是 Space 工作区内的相对路径——与 spaces files ls 看到的路径一致，而不是本地文件系统路径。

cohub -s <spaceId> apps publish demo --file dist/index.html
cohub -s <spaceId> apps publish site --dir dist
cohub -s <spaceId> apps ls --json
cohub apps stats <workId|url|username/space/work>

Realtime rooms 使用已发布 App 的 runtime 身份。请在 App 内使用 client.app.realtime；CLI 不提供房间命令。

操作 Cohub 界面

在 Space 中运行的 Agent 可以在发起该对话的 Cohub 标签页里打开 App 预览，并调用 App 自己暴露的方法。

cohub desktop open <appId|url|app://...|username/space/app|file://path>
cohub desktop open file://src/main.ts
cohub desktop open app://alice/studio/launch
cohub desktop open <app-or-file> --call selection.get
cohub desktop open <app> --call board.focus --data '{"nodeId":"n1"}'

打开预览是幂等的：重复执行只会重新激活同一个标签页。--call 会等待 App 声明就绪 后再调用方法。具体有哪些方法由 App 作者决定，通过 client.app.surface.handle(name, handler) 注册。

命令只会到达发起当前工作的那个前端实例，目标从请求 provenance 推导得出。它无法作用于 其他用户，也不提供 DOM 访问或脚本执行能力。

本地 Sandbox

把本地目录暴露为 Space Sandbox：

cohub sandbox up ./my-project
cohub sandbox status

Search 与 models

cohub search "release notes"
cohub models ls
cohub models ls --model-type multimodal
cohub generate "A calm lake at sunrise" --model <model> --output lake.png

输出约定

脚本或 Agent 需要串联命令时，使用 --json。

cohub spaces ls --json
cohub -s <spaceId> spaces sessions ls --json

交互使用可读输出即可；自动化优先 JSON。

下一步