C
Cohub
Open app
EN 中文
开发者

CLI

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

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

包名：@neta-art/cohub-cli

安装

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

登录

cohub auth login
cohub auth whoami

CLI 会存储 session 并自动刷新。

在 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

Works

cohub -s <spaceId> works publish demo --file dist/index.html
cohub -s <spaceId> works publish site --dir dist
cohub -s <spaceId> works ls --json

本地 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。

下一步