Menu
Work with Cohub spaces, chats, files, saves, labels, search, tasks, scheduled prompts, and cross-space run.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Generate or transform images, video, and music with Cohub multimodal models via `cohub generate`. Use when the user asks to create, edit, restyle, animate, or remove backgrounds from media, or generate songs.
Publish files, directory sites, or sandbox ports as public Cohub Works and return shareable Work URLs.
Publish files from the runtime to the public share directory and return direct public URLs.
| name | cohub |
| description | Work with Cohub spaces, chats, files, saves, labels, search, tasks, scheduled prompts, and cross-space run. |
Use the Cohub CLI for platform operations, and use file tools for normal file work.
Prefer simple, explicit commands. Use --json when reading output for decisions, extracting IDs, or chaining commands.
Most commands can target the current Cohub sandbox context. If a command needs a target Space, add -s "$COHUB_SPACE_ID" or an explicit Space ID.
For command details, use -h:
cohub -h
cohub spaces -h
cohub spaces prompt -h
npm install -g @neta-art/cohub-cli
cohub --help
| Product UI | CLI / API |
|---|---|
| Chat | Session |
| Save | Checkpoint |
| Tasks | Task runs |
| Scheduled prompt | spaces prompt schedule |
| Recurring scheduled prompt | Cron job |
When talking to users, prefer product UI terms: Chat, Save, Tasks, and Scheduled prompt.
Use spaces prompt for sends and schedules. Use tasks and cron-jobs for inspection and management.
COHUB_SPACE_ID
COHUB_SESSION_ID
Use them as defaults when the user has not specified a target.
env | grep '^COHUB_'
Do not guess IDs. If no target is available and the command cannot infer context, ask the user.
Use spaces prompt for all sends: immediate, delayed, one-time scheduled, recurring scheduled, new Chat, or existing Chat. Target another Space with -s <spaceId>.
cohub spaces prompt "message"
cohub -s <spaceId> spaces prompt "message"
cat prompt.md | cohub spaces prompt
cohub spaces prompt --session <sessionId> "message"
cohub spaces prompt --title "<chat title>" "message"
cohub spaces prompt --model <model> --provider <provider> "message"
List LLM models with cohub models ls. For multimodal generation, use the cohub-generate skill.
Useful options:
cohub spaces prompt --read-only "message"
cohub spaces prompt --steer "message"
cohub spaces prompt --label Bug --label Area/Frontend "message"
cohub spaces prompt --image ./shot.png "message"
cohub spaces prompt --env KEY=value "message"
Schedule:
cohub spaces prompt --delay-ms 600000 "message"
cohub spaces prompt --at "2026-05-12T09:00:00+08:00" "message"
cohub spaces prompt \
--cron "0 9 * * 1-5" \
--timezone "Asia/Shanghai" \
--title "Daily reminder" \
"message"
Scheduling rules:
--delay-ms, --at, or --cron.--cron requires --timezone.cohub spaces prompt -h
Target another Space with -s <spaceId>.
cohub spaces sessions ls
cohub -s <spaceId> spaces sessions ls
cohub spaces sessions create "<title>"
cohub spaces sessions get <sessionId>
cohub spaces sessions rename <sessionId> "<new title>"
Inspect turns:
cohub spaces sessions turns ls <sessionId>
cohub spaces sessions turns get <sessionId> <turnId>
Send to a Chat with spaces prompt --session <sessionId>.
cohub spaces sessions -h
Prefer file tools for normal inspection and edits. For cross-space work, prefer file tools with space_id when supported; otherwise use CLI with -s <spaceId>.
Use CLI file commands when tools are unavailable, or for platform-side upload, move, rename, delete, or diff.
cohub spaces files ls [path]
cohub -s <spaceId> spaces files ls [path]
cohub spaces files cat <path>
cohub spaces files write <path> -c "<content>"
cohub spaces files upload <files...> --dir <dir>
cohub spaces files mkdir <path>
cohub spaces files mv <from> <to>
cohub spaces files rm <path>
cohub spaces files rm -r <path>
cohub spaces files diff
cohub spaces files diff <path>
Confirm before deleting files or directories.
cohub spaces files -h
A labelRef may be nested, e.g. Bug or Area/Frontend.
Resource types: session, checkpoint, file.
cohub spaces labels ls
cohub spaces labels create <labelRef>
cohub spaces labels items <labelRef>
cohub spaces labels attach <labelRef> <resourceType> <resourceRef>
cohub spaces labels detach <labelRef> <resourceType> <resourceRef>
cohub spaces labels set <resourceType> <resourceRef> [labelRefs...]
cohub spaces labels patch <resourceType> <resourceRef> --add a,b --remove c
When sending, attach labels with spaces prompt --label <ref>.
cohub spaces labels -h
cohub spaces checkpoints ls
cohub spaces checkpoints get <checkpointId>
cohub spaces checkpoints create "<description>"
cohub spaces checkpoints diff <checkpointId>
cohub spaces checkpoints ls-tree <checkpointId> [path]
cohub spaces checkpoints show <checkpointId> <path>
Create a Save after meaningful milestones or when the user asks to save progress.
cohub spaces checkpoints -h
The product UI shows Tasks. In the CLI, these are task runs.
cohub tasks ls --space "$COHUB_SPACE_ID"
cohub tasks get <taskRunId>
Do not create scheduled sends through task commands. Use spaces prompt scheduling flags instead.
cohub tasks -h
Create with spaces prompt scheduling flags. Manage recurring ones with cron-jobs:
cohub cron-jobs ls "$COHUB_SPACE_ID"
cohub cron-jobs get <cronJobId>
cohub cron-jobs runs <cronJobId>
cohub cron-jobs update <cronJobId>
cohub cron-jobs toggle <cronJobId> on
cohub cron-jobs toggle <cronJobId> off
cohub cron-jobs delete <cronJobId>
Confirm before enabling, disabling, updating, or deleting recurring scheduled prompts.
cohub cron-jobs -h
For publishing files, directory sites, or sandbox ports as shareable Works, use the cohub-works-share skill.
For Works with stronger capabilities (Cohub agent, generation, etc.), use the @neta-art/cohub SDK — install a fresh copy and read its README before writing any SDK code.
Discover existing Works:
cohub works ls
cohub works get <workId>
cohub works -h
Use Cohub search for product-level discovery. Use file tools for workspace file search.
cohub search "query"
cohub search "query" --space-id <spaceId>
cohub search "query" --types turn,session,space
cohub search --types label --label-ref Bug
Run a one-off shell command in a Space workspace:
cohub -s <spaceId> run -- git status
cohub -s <spaceId> run --command "pnpm test"
cohub spaces ls
cohub spaces get <spaceId>
cohub spaces create --name "<name>" --description "<description>"
cohub spaces rename <spaceId> "<new name>"
cohub spaces update <spaceId> --slug <space-slug>
cohub spaces avatar <path>
cohub spaces config <spaceId>
cohub spaces -h
cohub spaces config -h
cohub profile avatar <path>
env | grep '^COHUB_'
cohub spaces get "$COHUB_SPACE_ID"
cohub spaces sessions ls
cohub spaces files diff
cohub spaces prompt --title "<chat title>" "<message>"
cohub spaces files diff
cohub spaces checkpoints create "<description>"
cohub -s <spaceId> run -- git status
Less common management — use -h for details:
cohub spaces members -h
cohub spaces access -h
cohub spaces sessions access -h
cohub spaces mods -h
cohub spaces commerce -h
cohub spaces usage -h
cohub references -h
cohub me -h
cohub channels -h
cohub auth -h
cohub sandbox -h
Confirm before: