@gobi-ai/cli 2.0.4 → 2.0.6

package/skills/gobi-core/SKILL.md

@@ -1,20 +1,20 @@
 ---
 name: gobi-core
 description: >-
-  Core Gobi CLI: authentication (login/logout/status), vault initialization
-  (gobi init), space selection (gobi space warp/list), CLI updates (gobi
-  update), and session management (list/get/reply to conversations). Use when
-  the user needs to set up Gobi, authenticate, manage sessions, or update the
-  CLI. File sync is in the gobi-vault skill.
+  Core Gobi CLI: authentication (login/logout/status), space selection (gobi
+  space warp/list), CLI updates (gobi update), and session management
+  (list/get/reply to conversations). Use when the user needs to authenticate,
+  manage sessions, or update the CLI. Vault setup is in the gobi-vault skill;
+  file sync is also in gobi-vault.
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.0"
+  version: "2.0.6"
 ---
 
 # gobi-core
 
-Core CLI commands for the Gobi collaborative knowledge platform (v2.0.0).
+Core CLI commands for the Gobi collaborative knowledge platform (v2.0.6).
 
 ## Prerequisites
 
@@ -44,43 +44,24 @@ brew tap gobi-ai/tap && brew install gobi
 - **Space**: A shared community knowledge area. A user can be a member of one or more spaces; each space contains posts, replies, sessions, and connected vaults.
 - **Draft**: A unit of standing guidance authored by an agent during chat. Each draft carries 0–3 AI-suggested actions the user picks from. The top 5 pending drafts feed the agent's system prompt every turn.
 
-## First-Time Setup
+## Setup steps (run only what you need)
 
-The CLI requires three setup steps: authentication, vault initialization, and space selection.
+There is **no `gobi init`** command — each setup step is its own command, and you only run the ones the workflow demands.
 
-### Step 1: Initialize (Login + Vault)
+| Step | Command | Unlocks |
+|------|---------|---------|
+| 1. Log in | `gobi auth login` | All authenticated commands |
+| 2. Configure a vault for this directory | `gobi vault init` | Every `gobi vault …` command + lets `global create-post` default to this vault |
+| 3. Pick an active space for this directory | `gobi space warp` | Every `gobi space …` post/reply/feed command without needing `--space-slug` |
 
-```bash
-gobi init
-```
-
-This is an **interactive** command that:
-1. Logs in automatically if not already authenticated (opens a browser URL for Google OAuth)
-2. Prompts the user to select an existing vault or create a new one
-3. Writes `.gobi/settings.yaml` in the current directory with the chosen vault slug
-4. Creates a `PUBLISH.md` file if one doesn't exist
-
-### Step 2: Select a Space
-
-```bash
-gobi space warp
-```
-
-This is an **interactive** command that prompts the user to select a space from their available spaces, then saves it to `.gobi/settings.yaml`.
+After step 2 + step 3, `.gobi/settings.yaml` looks like:
 
-After both steps, `.gobi/settings.yaml` will contain:
 ```yaml
 vaultSlug: brave-path-zr962w
 selectedSpaceSlug: cmds
 ```
 
-### Standalone Login
-
-If the user only needs to log in (without vault setup):
-
-```bash
-gobi auth login
-```
+`gobi vault init` and `gobi space warp` are both **interactive** — they prompt the user, so an agent can't run them silently. Send the user the command and let them complete the prompt.
 
 Check auth status anytime:
 
@@ -88,7 +69,24 @@ Check auth status anytime:
 gobi auth status
 ```
 
-**Important for agents**: Before running any `space` command, check whether `.gobi/settings.yaml` exists in the current directory with both `vaultSlug` and `selectedSpaceSlug`. If the vault is missing, guide the user through `gobi init`. If only the space is missing, guide the user through `gobi space warp`. These commands require user input (interactive prompts), so the agent cannot run them silently. For one-off calls, every command also accepts an explicit `--vault-slug` / `--space-slug` override.
+## Pre-reqs by command family
+
+| Command family | Needs vault in `.gobi`? | Needs space in `.gobi`? | Per-call override |
+|----------------|------------------------|------------------------|-------------------|
+| `auth …`, `update`, `session …`, `saved …`, `draft …`, `media …`, `sense …` | no | no | – |
+| `vault publish` / `unpublish` / `sync` | **yes** | no | none — must run `gobi vault init` first |
+| `vault init` | no (it sets it up) | no | – |
+| `space list` / `warp [slug]` / `get [slug]` | no | no | – |
+| `space list-topics` / `feed` / `list-posts` / `get-post` / `create-post` / `edit-post` / `delete-post` / `create-reply` / `edit-reply` / `delete-reply` / `list-topic-posts` | no | **yes** | parent `--space-slug <slug>` |
+| `global feed` / `list-posts` / `get-post` / `delete-post` / `create-reply` / `edit-reply` / `delete-reply` | no | no | – |
+| `global create-post` | optional¹ | no | command-level `--vault-slug <slug>` |
+| `global edit-post` | optional² | no | command-level `--vault-slug <slug>` |
+
+¹ `global create-post` accepts `--vault-slug` and `--auto-attachments`, both optional. With neither flag and no `vaultSlug` in `.gobi`, the post is created with no `authorVaultSlug` (vault-less personal post) — same as a Space post that isn't attributed to any vault. Set `--vault-slug` (or have `vaultSlug` in `.gobi` plus pass `--auto-attachments`) to attribute it.
+
+² `global edit-post` only consults `--vault-slug` when you pass it explicitly. Use `--vault-slug ""` to detach an existing attribution; non-empty re-attaches.
+
+When a command needs vault or space and neither `.gobi` nor an override flag provides it, the CLI prints a one-line warning before the command runs (e.g. `Vault not set. Run 'gobi vault init' first, or pass --vault-slug.`). The warning is suppressed under `--json`.
 
 ## Important: JSON Mode
 
@@ -106,29 +104,27 @@ JSON responses have the shape `{ "success": true, "data": ... }` on success or `
   - `gobi auth login` — Log in to Gobi. Opens a browser URL for Google OAuth, then polls until authentication is complete.
   - `gobi auth status` — Check whether you are currently authenticated with Gobi.
   - `gobi auth logout` — Log out of Gobi and remove stored credentials.
-- `gobi init` — Log in (if needed) and select or create the vault for the current directory.
 - `gobi space list` — List spaces you are a member of.
 - `gobi space warp` — Select the active space. Pass a slug to warp directly, or omit for interactive selection.
 - `gobi session` — Session commands (get, list, reply).
   - `gobi session get` — Get a session and its messages (paginated).
   - `gobi session list` — List all sessions you are part of, sorted by most recent activity.
-  - `gobi session reply` — Send a human reply to a session you are a member of.
+  - `gobi session create-reply` — Send a human reply to a session you are a member of.
 - `gobi update` — Update gobi-cli to the latest version.
 
-> File sync (`gobi vault sync`) lives in the **gobi-vault** skill.
+> Vault setup (`gobi vault init`) and file sync (`gobi vault sync`) live in the **gobi-vault** skill.
 
 ## Confirm before mutating
 
-`gobi session reply` posts a human-attributed message into a chat session — the message becomes part of the user's permanent chat history and triggers the agent to respond. Before running it, confirm with the user — show the exact session id and the message text. This applies even when running autonomously.
+`gobi session create-reply` posts a human-attributed message into a chat session — the message becomes part of the user's permanent chat history and triggers the agent to respond. Before running it, confirm with the user — show the exact session id and the message text. This applies even when running autonomously.
 
-`auth login` / `auth logout` and `init` are explicit user-driven commands; they prompt the user themselves and don't need an extra confirmation layer. `update` upgrades the CLI binary — fine to run without extra confirmation.
+`auth login` / `auth logout` are explicit user-driven commands; they prompt the user themselves and don't need an extra confirmation layer. `update` upgrades the CLI binary — fine to run without extra confirmation.
 
 Read-only commands (`auth status`, `session list`, `session get`, `space list`) run without confirmation.
 
 ## Reference Documentation
 
 - [gobi auth](references/auth.md)
-- [gobi init](references/init.md)
 - [gobi session](references/session.md)
 - [gobi update](references/update.md)
 - [gobi space (list/warp)](references/space.md)

package/skills/gobi-core/references/session.md

@@ -3,16 +3,16 @@
 ```
 Usage: gobi session [options] [command]
 
-Session commands (get, list, reply).
+Session commands (get, list, create-reply).
 
 Options:
-  -h, --help                   display help for command
+  -h, --help                          display help for command
 
 Commands:
-  get [options] <sessionId>    Get a session and its messages (paginated).
-  list [options]               List all sessions you are part of, sorted by most recent activity.
-  reply [options] <sessionId>  Send a human reply to a session you are a member of.
-  help [command]               display help for command
+  get [options] <sessionId>           Get a session and its messages (paginated).
+  list [options]                      List all sessions you are part of, sorted by most recent activity.
+  create-reply [options] <sessionId>  Send a human reply to a session you are a member of.
+  help [command]                      display help for command
 ```
 
 ## get
@@ -23,7 +23,7 @@ Usage: gobi session get [options] <sessionId>
 Get a session and its messages (paginated).
 
 Options:
-  --limit <number>   Messages per page (default: "20")
+  --limit <number>   Items per page (default: "20")
   --cursor <string>  Pagination cursor from previous response
   -h, --help         display help for command
 ```
@@ -41,15 +41,15 @@ Options:
   -h, --help         display help for command
 ```
 
-## reply
+## create-reply
 
 ```
-Usage: gobi session reply [options] <sessionId>
+Usage: gobi session create-reply [options] <sessionId>
 
 Send a human reply to a session you are a member of.
 
 Options:
-  --content <content>     Reply content (markdown supported)
+  --content <content>     Reply content (markdown supported, use "-" for stdin)
   --rich-text <richText>  Rich-text JSON array (e.g. [{"type":"text","text":"hello"}])
   -h, --help              display help for command
 ```

package/skills/gobi-core/references/space.md

@@ -6,12 +6,12 @@ Usage: gobi space [options] [command]
 Space commands (posts, replies). Space and member admin is web-UI only.
 
 Options:
-  --space-slug <slug>                     Space slug (overrides .gobi/settings.yaml)
+  --space-slug <spaceSlug>                Space slug (overrides .gobi/settings.yaml)
   -h, --help                              display help for command
 
 Commands:
   list                                    List spaces you are a member of.
-  get [spaceSlug]                         Get details for a space. Pass a slug or omit to use the current space (from .gobi/settings.yaml or --space-slug).
+  get [options] [spaceSlug]               Get details for a space. Pass a slug or omit to use the current space (from .gobi/settings.yaml or --space-slug).
   warp [spaceSlug]                        Select the active space. Pass a slug to warp directly, or omit for interactive selection.
   list-topics [options]                   List topics in a space, ordered by most recent content linkage.
   list-topic-posts [options] <topicSlug>  List posts tagged with a topic in a space (cursor-paginated).
@@ -19,11 +19,11 @@ Commands:
   get-post [options] <postId>             Get a post with its ancestors and replies (paginated).
   list-posts [options]                    List posts in a space (paginated).
   create-post [options]                   Create a post in a space.
-  edit-post [options] <postId>            Edit a post. You must be the author.
-  delete-post <postId>                    Delete a post. You must be the author.
+  edit-post [options] <postId>            Edit a post you authored in a space.
+  delete-post [options] <postId>          Delete a post you authored in a space.
   create-reply [options] <postId>         Create a reply to a post in a space.
-  edit-reply [options] <replyId>          Edit a reply. You must be the author.
-  delete-reply <replyId>                  Delete a reply. You must be the author.
+  edit-reply [options] <replyId>          Edit a reply you authored in a space.
+  delete-reply [options] <replyId>        Delete a reply you authored in a space.
   help [command]                          display help for command
 ```
 

package/skills/gobi-draft/SKILL.md

@@ -10,12 +10,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.0"
+  version: "2.0.6"
 ---
 
 # gobi-draft
 
-Gobi draft commands for managing agent-authored drafts (v2.0.0).
+Gobi draft commands for managing agent-authored drafts (v2.0.6).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 
@@ -28,7 +28,7 @@ A draft is a unit of standing guidance authored by an agent (in-process during c
 - **actions** — 0–3 AI-suggested actions. Each action is `{ label, message? }`:
   - `label` — short button text (1–80 chars) the user sees, e.g. `"Apply"`, `"Skip"`.
   - `message` — optional (≤2000 chars). What the user is taken to be saying to the agent when they click that button. Falls back to `label` when omitted. Use this whenever the click should send something more specific than the button text — e.g. label `"Punch it up"`, message `"Tighten the opening paragraph and shorten the CTA"`.
-- **sessionId** — required; the chat session that produced the draft
+- **sessionId** — the chat session the draft is anchored to. Optional on create: when omitted, the server mints a fresh session anchored to the user's primary vault and seeds it with a tool-call entry representing the draft, so clicking an action later has somewhere to land.
 - **priority** — lower number = higher priority; default `100`
 - **status** — `pending` until the user picks an action, then `actioned`
 - **revision** — bumped each time the draft is revised
@@ -36,7 +36,7 @@ A draft is a unit of standing guidance authored by an agent (in-process during c
 
 The top 5 pending drafts (lowest priority first) are injected into the agent's system prompt every turn — that's how drafts turn into standing instructions.
 
-When invoked from inside an agent run, the runtime exports `GOBI_SESSION_ID` so `gobi draft add` picks it up automatically; otherwise pass `--session <uuid>`.
+When invoked from inside the Gobi agent runtime, `GOBI_SESSION_ID` is exported and `gobi draft add` picks it up automatically. Outside that runtime (e.g. local Claude Code, ad-hoc shells), you can either pass `--session <uuid>` to anchor to an existing chat session, or omit it entirely — the server will mint a new session and seed it with the draft so the action click lands somewhere coherent.
 
 ## Lifecycle
 

package/skills/gobi-draft/references/draft.md

@@ -10,9 +10,10 @@ Options:
 
 Commands:
   list [options]                        List drafts (priority ASC, then newest first).
-  get <draftId>                         Show one draft with its history and suggested actions.
-  add [options] <title> <content>       Add a draft. Pass '-' for content to read from stdin. Pass --action up to 3 times to attach AI-suggested actions. Requires a chat session — the agent runtime
-                                        exports GOBI_SESSION_ID automatically; outside that, pass --session.
+  get <draftId>                         Get one draft with its history and suggested actions.
+  add [options] <title> <content>       Add a draft. Pass '-' for content to read from stdin. Pass --action up to 3 times to attach AI-suggested actions. Session id is optional: the Gobi agent
+                                        runtime exports GOBI_SESSION_ID automatically and `--session` takes precedence; if neither is set, the server mints a new chat session anchored to your primary
+                                        vault and seeds it with the draft so clicking an action later has somewhere to land.
   delete <draftId>                      Delete a draft.
   prioritize <draftId> <priority>       Set priority (lower = higher). Top 5 feed the system prompt.
   action <draftId> <actionIndex>        Take one of the draft's suggested actions by 0-based index. Marks the draft 'actioned' and the client posts the synthesized message into the originating
@@ -30,7 +31,7 @@ Usage: gobi draft list [options]
 List drafts (priority ASC, then newest first).
 
 Options:
-  --limit <number>  Max drafts to return (1-200) (default: "50")
+  --limit <number>  Items per page (default: "20")
   -h, --help        display help for command
 ```
 
@@ -39,7 +40,7 @@ Options:
 ```
 Usage: gobi draft get [options] <draftId>
 
-Show one draft with its history and suggested actions.
+Get one draft with its history and suggested actions.
 
 Options:
   -h, --help  display help for command
@@ -50,11 +51,11 @@ Options:
 ```
 Usage: gobi draft add [options] <title> <content>
 
-Add a draft. Pass '-' for content to read from stdin. Pass --action up to 3 times to attach AI-suggested actions. Requires a chat session — the agent runtime exports GOBI_SESSION_ID automatically;
-outside that, pass --session.
+Add a draft. Pass '-' for content to read from stdin. Pass --action up to 3 times to attach AI-suggested actions. Session id is optional: the Gobi agent runtime exports GOBI_SESSION_ID automatically
+and `--session` takes precedence; if neither is set, the server mints a new chat session anchored to your primary vault and seeds it with the draft so clicking an action later has somewhere to land.
 
 Options:
-  --session <sessionId>        Originating chat session UUID. Falls back to $GOBI_SESSION_ID when set.
+  --session <sessionId>        Originating chat session UUID. Falls back to $GOBI_SESSION_ID; if unset, the server creates a new session.
   --priority <number>          Priority (lower = higher), default 100
   --action <label[::message]>  Suggested action (repeatable, max 3). `label` is the button text; an optional `::message` suffix is what the user is taken to be saying to the agent on click. Without
                                the suffix, the message falls back to the label. (default: [])

package/skills/gobi-media/SKILL.md

@@ -10,12 +10,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.0"
+  version: "2.0.6"
 ---
 
 # gobi-media
 
-Gobi media generation commands (v2.0.0).
+Gobi media generation commands (v2.0.6).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 
@@ -24,7 +24,7 @@ Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
 
 ```bash
-gobi --json media image-generate --prompt "a sunset over mountains"
+gobi --json media generate-image --prompt "a sunset over mountains"
 ```
 
 ## Typical Workflow (Image Generation)
@@ -32,7 +32,7 @@ gobi --json media image-generate --prompt "a sunset over mountains"
 Single command — generate and download in one step:
 
 ```bash
-gobi --json media image-generate --prompt "<PROMPT>" --aspect-ratio "<RATIO>" -o media/<NAME>.png
+gobi --json media generate-image --prompt "<PROMPT>" --aspect-ratio "<RATIO>" -o media/<NAME>.png
 ```
 
 Replace `<NAME>` with a short descriptive slug derived from the prompt (e.g., `happy-family`, `sunset-mountains`).
@@ -52,25 +52,25 @@ Do NOT use markdown image syntax `![](...)` or `gobi://` URLs. Always use `![[me
 - Replace `<NAME>` with a descriptive slug — NEVER use example names like `sunset.png` literally.
 - `--name` is **optional** — auto-derived from prompt if omitted.
 - Do NOT use the `downloadUrl` from the response — it is a frontend path, not a direct download link.
-- `image-download` takes a **positional** jobId (NOT `--job-id`): `gobi media image-download <jobId>`
-- The `jobId` (or `id`) field is what you pass to `image-download` / `image-status` — NOT `mediaId`.
+- `download-image` takes a **positional** jobId (NOT `--job-id`): `gobi media download-image <jobId>`
+- The `jobId` (or `id`) field is what you pass to `download-image` / `get-image-status` — NOT `mediaId`.
 
 ## Typical Workflow (Video Generation)
 
 Single command — create and download in one step:
 
 ```bash
-gobi --json media video-create --avatar-id "<AVATAR_ID>" --voice-id "<VOICE_ID>" --script "<SCRIPT>" -o media/<NAME>.mp4
+gobi --json media create-video --avatar-id "<AVATAR_ID>" --voice-id "<VOICE_ID>" --script "<SCRIPT>" -o media/<NAME>.mp4
 ```
 
-`--name` is optional (auto-generated if omitted). Replace `<NAME>` with a short descriptive slug. Use `gobi media avatars` and `gobi media voices` to list available IDs.
+`--name` is optional (auto-generated if omitted). Replace `<NAME>` with a short descriptive slug. Use `gobi media list-avatars` and `gobi media list-voices` to list available IDs.
 
 The `-o` flag implies `--wait` and downloads the video when done.
 
 To use a custom image as the **background** of a video, pass it directly as `--background <file>` (auto-uploaded):
 
 ```bash
-gobi --json media video-create --avatar-id "<AVATAR_ID>" --voice-id "<VOICE_ID>" --script "<SCRIPT>" --background media/bg.png -o media/<NAME>.mp4
+gobi --json media create-video --avatar-id "<AVATAR_ID>" --voice-id "<VOICE_ID>" --script "<SCRIPT>" --background media/bg.png -o media/<NAME>.mp4
 ```
 
 ## Typical Workflow (Cinematic Video)
@@ -78,7 +78,7 @@ gobi --json media video-create --avatar-id "<AVATAR_ID>" --voice-id "<VOICE_ID>"
 Generate a cinematic video from a text prompt (no avatar needed):
 
 ```bash
-gobi --json media cinematic-create --prompt "<PROMPT>" --aspect-ratio "<RATIO>" -o media/<NAME>.mp4
+gobi --json media create-cinematic --prompt "<PROMPT>" --aspect-ratio "<RATIO>" -o media/<NAME>.mp4
 ```
 
 Options: `--duration <4-8>`, `--resolution <720p|1080p>`, `--enhance-prompt`, `--generate-audio`, `--negative-prompt`, `--sample-count <1-4>`, `--first-frame <file>`, `--last-frame <file>`, `--reference-images <files>`.
@@ -88,7 +88,7 @@ Options: `--duration <4-8>`, `--resolution <720p|1080p>`, `--enhance-prompt`, `-
 Edit an existing image with a prompt — single command:
 
 ```bash
-gobi --json media image-edit --image media/source.png --prompt "<EDIT_INSTRUCTION>" -o media/<NAME>.png
+gobi --json media edit-image --image media/source.png --prompt "<EDIT_INSTRUCTION>" -o media/<NAME>.png
 ```
 
 All file arguments (`--image`, `--mask`, `--background`, `--photo`, `--audio`, `--reference-image`, `--first-frame`, `--last-frame`) accept local file paths and auto-upload them. No need to manually upload first.
@@ -100,31 +100,31 @@ Three ways to create custom avatars:
 ### 1. Design from scratch
 
 ```bash
-gobi --json media avatar-design --gender "<GENDER>" --age "<AGE>" --ethnicity "<ETHNICITY>" --outfit "<OUTFIT>" --background "<BACKGROUND>" --wait
+gobi --json media design-avatar --gender "<GENDER>" --age "<AGE>" --ethnicity "<ETHNICITY>" --outfit "<OUTFIT>" --background "<BACKGROUND>" --wait
 ```
 
 When `variants_ready`, confirm with:
 
 ```bash
-gobi --json media avatar-confirm --job-id "<JOB_ID>"
+gobi --json media confirm-avatar --job-id "<JOB_ID>"
 ```
 
 ### 2. From a selfie (instant)
 
 ```bash
-gobi --json media avatar-from-selfie --photo media/selfie.png
+gobi --json media design-avatar-from-selfie --photo media/selfie.png
 ```
 
 ### 3. From a selfie (enhanced with prompt)
 
 ```bash
-gobi --json media avatar-from-selfie --photo media/selfie.png --prompt "<ENHANCEMENT>" --wait
+gobi --json media design-avatar-from-selfie --photo media/selfie.png --prompt "<ENHANCEMENT>" --wait
 ```
 
 Check any avatar job status with:
 
 ```bash
-gobi --json media avatar-job-status <jobId> --wait
+gobi --json media get-avatar-job-status <jobId> --wait
 ```
 
 **IMPORTANT: After downloading, show the video using Obsidian wiki-link syntax EXACTLY like this:**
@@ -143,44 +143,43 @@ Do NOT use markdown image/link syntax `![](...)` or `gobi://` URLs. Always use `
 
 ### Avatars & Voices
 
-- `gobi media avatars` — List available avatars.
-- `gobi media voices` — List available voices.
+- `gobi media list-avatars` — List available avatars.
+- `gobi media list-voices` — List available voices.
 
 ### Videos
 
-- `gobi media video-create` — Create an avatar video generation job.
-- `gobi media cinematic-create` — Create a cinematic video from a text prompt.
-- `gobi media video-list` — List all videos.
-- `gobi media video-get` — Get video metadata.
-- `gobi media video-status` — Poll video generation status.
-- `gobi media video-download` — Download a completed video (`-o` to save to file).
+- `gobi media create-video` — Create an avatar video generation job.
+- `gobi media create-cinematic` — Create a cinematic video from a text prompt.
+- `gobi media list-videos` — List all videos.
+- `gobi media get-video` — Get video metadata.
+- `gobi media get-video-status` — Get video generation status.
+- `gobi media download-video` — Download a completed video (`-o` to save to file).
 
 ### Custom Avatars
 
-- `gobi media avatar-design` — Start a design-your-avatar job.
-- `gobi media avatar-confirm` — Confirm avatar variant(s) after design.
-- `gobi media avatar-from-selfie` — Create an avatar from a selfie (instant or enhanced).
-- `gobi media avatar-job-status` — Check avatar job status.
+- `gobi media design-avatar` — Start a design-your-avatar job.
+- `gobi media confirm-avatar` — Confirm avatar variant(s) after design.
+- `gobi media design-avatar-from-selfie` — Design an avatar from a selfie (instant or enhanced).
+- `gobi media get-avatar-job-status` — Get avatar job status.
 
 ### Images
 
-- `gobi media image-generate` — Generate an image from a text prompt. Types: image (default), thumbnail (YouTube-optimized), asset (logo/product). Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4
-- `gobi media image-edit` — Edit an existing image with a prompt (image-to-image).
-- `gobi media image-inpaint` — Inpaint an image region using a mask.
-- `gobi media image-status` — Check image generation job status.
-- `gobi media image-download` — Download a generated image.
-- `gobi media image-status` — Check image generation job status.
+- `gobi media generate-image` — Generate an image from a text prompt. Types: image (default), thumbnail (YouTube-optimized), asset (logo/product). Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4
+- `gobi media edit-image` — Edit an existing image with a prompt (image-to-image).
+- `gobi media inpaint-image` — Inpaint an image region using a mask.
+- `gobi media get-image-status` — Get image generation job status.
+- `gobi media download-image` — Download a generated image.
 
 ## Confirm before mutating
 
 Media generation jobs consume credits (real-world billable cost) and produce assets attached to the user's account. Videos and avatar work can take minutes per job. Before running any generation/upload command, confirm with the user — show the exact command and the prompt / script / source files / aspect ratio / duration. This applies even when running autonomously.
 
-- `image-generate`, `image-edit`, `image-inpaint` — quick but billable per job.
-- `video-create`, `cinematic-create` — slower and more expensive; confirm script, avatar/voice ids, and aspect ratio before submitting.
-- `avatar-design`, `avatar-confirm`, `avatar-from-selfie` — produce assets the user will see in their avatar list. Confirm the photo/prompt and that the user wants the variant locked in (`avatar-confirm` is the commit step).
+- `generate-image`, `edit-image`, `inpaint-image` — quick but billable per job.
+- `create-video`, `create-cinematic` — slower and more expensive; confirm script, avatar/voice ids, and aspect ratio before submitting.
+- `design-avatar`, `confirm-avatar`, `design-avatar-from-selfie` — produce assets the user will see in their avatar list. Confirm the photo/prompt and that the user wants the variant locked in (`confirm-avatar` is the commit step).
 - `upload` — adds to the user's media. Low-stakes but still a write; mention the file before uploading.
 
-Read-only commands (`avatars`, `voices`, `image-status`, `video-status`, `video-list`, `video-get`, `avatar-job-status`) and downloads (`image-download`, `video-download`) run without confirmation.
+Read-only commands (`list-avatars`, `list-voices`, `get-image-status`, `get-video-status`, `list-videos`, `get-video`, `get-avatar-job-status`) and downloads (`download-image`, `download-video`) run without confirmation.
 
 ## Reference Documentation