@gobi-ai/cli 2.0.4 → 2.0.6

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

@@ -6,28 +6,28 @@ Usage: gobi media [options] [command]
 Media generation commands (videos, images).
 
 Options:
-  -h, --help                           display help for command
+  -h, --help                               display help for command
 
 Commands:
-  upload <file>                        Upload a local file and return its media ID.
-  avatars                              List available avatars.
-  voices                               List available voices.
-  video-create [options]               Create an avatar video generation job.
-  video-list                           List all videos.
-  video-get <id>                       Get video metadata.
-  video-status [options] <id>          Poll video generation status.
-  video-download [options] <id>        Download a completed video (or get its URL).
-  cinematic-create [options]           Create a cinematic video from a text prompt.
-  avatar-design [options]              Start a design-your-avatar job.
-  avatar-confirm [options]             Confirm avatar variant(s) after design.
-  avatar-from-selfie [options]         Create an avatar from a selfie (instant or enhanced with prompt).
-  avatar-job-status [options] <jobId>  Check avatar job status.
-  image-generate [options]             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
-  image-edit [options]                 Edit an existing image with a prompt (image-to-image).
-  image-inpaint [options]              Inpaint an image region using a mask.
-  image-status [options] <jobId>       Check image generation job status.
-  image-download [options] <jobId>     Download a generated image.
-  help [command]                       display help for command
+  upload <file>                            Upload a local file and return its media ID.
+  list-avatars                             List available avatars.
+  list-voices                              List available voices.
+  create-video [options]                   Create an avatar video generation job.
+  list-videos                              List all videos.
+  get-video <videoId>                      Get video metadata.
+  get-video-status [options] <videoId>     Get video generation status.
+  download-video [options] <videoId>       Download a completed video (or get its URL).
+  create-cinematic [options]               Create a cinematic video from a text prompt.
+  design-avatar [options]                  Start a design-your-avatar job.
+  confirm-avatar [options]                 Confirm avatar variant(s) after design.
+  design-avatar-from-selfie [options]      Design an avatar from a selfie (instant or enhanced with prompt).
+  get-avatar-job-status [options] <jobId>  Get avatar job status.
+  generate-image [options]                 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
+  edit-image [options]                     Edit an existing image with a prompt (image-to-image).
+  inpaint-image [options]                  Inpaint an image region using a mask.
+  get-image-status [options] <jobId>       Get image generation job status.
+  download-image [options] <jobId>         Download a generated image.
+  help [command]                           display help for command
 ```
 
 ## upload
@@ -41,10 +41,10 @@ Options:
   -h, --help  display help for command
 ```
 
-## avatars
+## list-avatars
 
 ```
-Usage: gobi media avatars [options]
+Usage: gobi media list-avatars [options]
 
 List available avatars.
 
@@ -52,10 +52,10 @@ Options:
   -h, --help  display help for command
 ```
 
-## voices
+## list-voices
 
 ```
-Usage: gobi media voices [options]
+Usage: gobi media list-voices [options]
 
 List available voices.
 
@@ -63,10 +63,10 @@ Options:
   -h, --help  display help for command
 ```
 
-## video-create
+## create-video
 
 ```
-Usage: gobi media video-create [options]
+Usage: gobi media create-video [options]
 
 Create an avatar video generation job.
 
@@ -81,10 +81,10 @@ Options:
   -h, --help              display help for command
 ```
 
-## video-list
+## list-videos
 
 ```
-Usage: gobi media video-list [options]
+Usage: gobi media list-videos [options]
 
 List all videos.
 
@@ -92,10 +92,10 @@ Options:
   -h, --help  display help for command
 ```
 
-## video-get
+## get-video
 
 ```
-Usage: gobi media video-get [options] <id>
+Usage: gobi media get-video [options] <videoId>
 
 Get video metadata.
 
@@ -103,12 +103,12 @@ Options:
   -h, --help  display help for command
 ```
 
-## video-status
+## get-video-status
 
 ```
-Usage: gobi media video-status [options] <id>
+Usage: gobi media get-video-status [options] <videoId>
 
-Poll video generation status.
+Get video generation status.
 
 Options:
   --wait               Poll until a terminal state is reached
@@ -116,10 +116,10 @@ Options:
   -h, --help           display help for command
 ```
 
-## video-download
+## download-video
 
 ```
-Usage: gobi media video-download [options] <id>
+Usage: gobi media download-video [options] <videoId>
 
 Download a completed video (or get its URL).
 
@@ -128,10 +128,10 @@ Options:
   -h, --help           display help for command
 ```
 
-## cinematic-create
+## create-cinematic
 
 ```
-Usage: gobi media cinematic-create [options]
+Usage: gobi media create-cinematic [options]
 
 Create a cinematic video from a text prompt.
 
@@ -153,10 +153,10 @@ Options:
   -h, --help                          display help for command
 ```
 
-## avatar-design
+## design-avatar
 
 ```
-Usage: gobi media avatar-design [options]
+Usage: gobi media design-avatar [options]
 
 Start a design-your-avatar job.
 
@@ -173,25 +173,25 @@ Options:
   -h, --help                 display help for command
 ```
 
-## avatar-confirm
+## confirm-avatar
 
 ```
-Usage: gobi media avatar-confirm [options]
+Usage: gobi media confirm-avatar [options]
 
 Confirm avatar variant(s) after design.
 
 Options:
-  --job-id <jobId>     Job ID from avatar-design
+  --job-id <jobId>     Job ID from design-avatar
   --variant <variant>  Variant to confirm (1 or 2); omit to confirm both
   -h, --help           display help for command
 ```
 
-## avatar-from-selfie
+## design-avatar-from-selfie
 
 ```
-Usage: gobi media avatar-from-selfie [options]
+Usage: gobi media design-avatar-from-selfie [options]
 
-Create an avatar from a selfie (instant or enhanced with prompt).
+Design an avatar from a selfie (instant or enhanced with prompt).
 
 Options:
   --name <name>      Name for the avatar (auto-generated if omitted)
@@ -202,22 +202,22 @@ Options:
   -h, --help         display help for command
 ```
 
-## avatar-job-status
+## get-avatar-job-status
 
 ```
-Usage: gobi media avatar-job-status [options] <jobId>
+Usage: gobi media get-avatar-job-status [options] <jobId>
 
-Check avatar job status.
+Get avatar job status.
 
 Options:
   --wait      Poll until a terminal state is reached
   -h, --help  display help for command
 ```
 
-## image-generate
+## generate-image
 
 ```
-Usage: gobi media image-generate [options]
+Usage: gobi media generate-image [options]
 
 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
 
@@ -234,10 +234,10 @@ Options:
   -h, --help                          display help for command
 ```
 
-## image-edit
+## edit-image
 
 ```
-Usage: gobi media image-edit [options]
+Usage: gobi media edit-image [options]
 
 Edit an existing image with a prompt (image-to-image).
 
@@ -250,10 +250,10 @@ Options:
   -h, --help           display help for command
 ```
 
-## image-inpaint
+## inpaint-image
 
 ```
-Usage: gobi media image-inpaint [options]
+Usage: gobi media inpaint-image [options]
 
 Inpaint an image region using a mask.
 
@@ -267,22 +267,22 @@ Options:
   -h, --help           display help for command
 ```
 
-## image-status
+## get-image-status
 
 ```
-Usage: gobi media image-status [options] <jobId>
+Usage: gobi media get-image-status [options] <jobId>
 
-Check image generation job status.
+Get image generation job status.
 
 Options:
   --wait      Poll until a terminal state is reached
   -h, --help  display help for command
 ```
 
-## image-download
+## download-image
 
 ```
-Usage: gobi media image-download [options] <jobId>
+Usage: gobi media download-image [options] <jobId>
 
 Download a generated image.
 

package/skills/gobi-saved/SKILL.md

@@ -2,67 +2,68 @@
 name: gobi-saved
 description: >-
   Gobi saved commands for the user's personal saved-knowledge collection:
-  saved notes (create/list/get/edit/delete) and saved posts (snapshot a
-  post/reply you bookmarked from feed/space; list/get/delete). Use when the
-  user wants to capture their own notes or bookmark/manage posts they've
-  saved.
+  notes (list/get/create/edit/delete) and bookmarked posts (snapshot a
+  post/reply from feed/space; list/get/delete). Use when the user wants to
+  capture their own notes or bookmark/manage posts they've saved.
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.0"
+  version: "2.0.6"
 ---
 
 # gobi-saved
 
-Gobi saved-knowledge commands (v2.0.0).
+Gobi saved-knowledge commands (v2.0.6).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 
 ## What is "saved"?
 
-`gobi saved` is the user's personal saved-knowledge collection. It has two subgroups:
+`gobi saved` is the user's personal saved-knowledge collection. It covers two kinds of items:
 
-- **`gobi saved note`** — User-authored notes (private, dated entries).
-- **`gobi saved post`** — Snapshots of posts (or replies) that the user has bookmarked from a space or the global feed.
+- **Notes** — user-authored notes (private, dated entries). Verbs: `list-notes`, `get-note`, `create-note`, `edit-note`, `delete-note`.
+- **Posts** — snapshots of posts (or replies) bookmarked from a space or the global feed. Verbs: `list-posts`, `get-post`, `create-post`, `delete-post`.
 
 Both are user-private — only the author can see/edit/delete their own items.
 
+> Naming note: `gobi saved create-post --source <id>` is a **bookmark** operation — it saves an existing post into your collection. It does *not* author a new post (use `gobi global create-post` or `gobi space create-post` for that).
+
 ## Timezone
 
-`gobi saved note list` and `gobi saved note create` need a timezone to compute the calendar day. The CLI auto-detects your system timezone via `Intl.DateTimeFormat().resolvedOptions().timeZone`. Override with `--timezone <iana-name>` (e.g. `America/Los_Angeles`).
+`gobi saved list-notes` and `gobi saved create-note` need a timezone to compute the calendar day. The CLI auto-detects your system timezone via `Intl.DateTimeFormat().resolvedOptions().timeZone`. Override with `--timezone <iana-name>` (e.g. `America/Los_Angeles`).
 
 ## Important: JSON Mode
 
 For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
 
 ```bash
-gobi --json saved note list --date 2026-04-27
+gobi --json saved list-notes --date 2026-04-27
 ```
 
 ## Available Commands
 
 ### Notes
-- `gobi saved note list` — List your notes. Without `--date`, returns recent notes via cursor pagination. With `--date YYYY-MM-DD`, returns all notes for that day.
-- `gobi saved note get <noteId>` — Get a single note by id.
-- `gobi saved note create --content <md>` — Create a note. Use `'-'` for stdin.
-- `gobi saved note edit <noteId>` — Edit a note. Provide `--content` and/or `--agent-id`.
-- `gobi saved note delete <noteId>` — Delete a note you authored.
-
-### Posts
-- `gobi saved post list` — List posts you have saved (paginated). Filter with `--type all|article|space-post`.
-- `gobi saved post get <postId>` — Get a saved post snapshot by post id.
-- `gobi saved post create --source <id>` — Save a post or reply by id. Records a snapshot in your saved-posts collection.
-- `gobi saved post delete <postId>` — Remove a post from your saved-posts collection.
+- `gobi saved list-notes` — List your notes. Without `--date`, returns recent notes via cursor pagination. With `--date YYYY-MM-DD`, returns all notes for that day.
+- `gobi saved get-note <noteId>` — Get a single note by id.
+- `gobi saved create-note --content <md>` — Create a note. Use `'-'` for stdin.
+- `gobi saved edit-note <noteId>` — Edit a note. Provide `--content` and/or `--agent-id`.
+- `gobi saved delete-note <noteId>` — Delete a note you authored.
+
+### Posts (bookmarks)
+- `gobi saved list-posts` — List posts you have bookmarked (paginated). Filter with `--type all|article|space-post`.
+- `gobi saved get-post <postId>` — Get a saved post snapshot by post id.
+- `gobi saved create-post --source <id>` — Bookmark a post or reply by id. Records a snapshot in your saved-posts collection.
+- `gobi saved delete-post <postId>` — Remove a post from your saved-posts collection.
 
 ## Confirm before mutating
 
 Saved items are the user's private collection but they still persist server-side and deletes are irreversible. Before running any write, confirm with the user — show the command and the note content / target id. This applies even when running autonomously.
 
-- `note create`, `note edit` — confirm the content (or content delta on edit).
-- `post create` (snapshotting a feed post) — confirm the source id you're about to bookmark.
-- `note delete`, `post delete` — irreversible. Flag that explicitly and confirm the target id before running.
+- `create-note`, `edit-note` — confirm the content (or content delta on edit).
+- `create-post` (bookmarking a feed post) — confirm the source id you're about to bookmark.
+- `delete-note`, `delete-post` — irreversible. Flag that explicitly and confirm the target id before running.
 
-Read-only commands (`note list`, `note get`, `post list`, `post get`) run without confirmation.
+Read-only commands (`list-notes`, `get-note`, `list-posts`, `get-post`) run without confirmation.
 
 ## Reference Documentation
 

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

@@ -3,50 +3,132 @@
 ```
 Usage: gobi saved [options] [command]
 
-Saved-knowledge commands (notes and posts).
+Saved-knowledge commands (notes and bookmarked posts).
 
 Options:
-  -h, --help      display help for command
+  -h, --help                    display help for command
 
 Commands:
-  note            Personal saved notes (create, list, get, edit, delete).
-  post            Saved posts (snapshots of posts and replies you bookmark).
-  help [command]  display help for command
+  list-notes [options]          List your notes. Without --date, returns recent notes via cursor pagination. With --date, returns all notes for that day.
+  get-note <noteId>             Get a single note by id.
+  create-note [options]         Create a note. Provide --content (use '-' for stdin) and/or attachments.
+  edit-note [options] <noteId>  Edit a note. Provide --content and/or --agent-id.
+  delete-note <noteId>          Delete a note you authored.
+  list-posts [options]          List posts you have bookmarked (paginated).
+  get-post <postId>             Get a saved post snapshot by post id.
+  create-post [options]         Bookmark a post or reply by id. Records a snapshot in your saved-posts collection.
+  delete-post <postId>          Remove a post from your saved-posts collection.
+  help [command]                display help for command
 ```
 
-## note
+## list-notes
 
 ```
-Usage: gobi saved note [options] [command]
+Usage: gobi saved list-notes [options]
 
-Personal saved notes (create, list, get, edit, delete).
+List your notes. Without --date, returns recent notes via cursor pagination. With --date, returns all notes for that day.
 
 Options:
-  -h, --help               display help for command
+  --date <date>      Filter to a single day (YYYY-MM-DD)
+  --timezone <tz>    IANA timezone name (default: system timezone)
+  --limit <number>   Items per page (default: "20")
+  --cursor <string>  Pagination cursor from previous response
+  -h, --help         display help for command
+```
 
-Commands:
-  list [options]           List your notes. Without --date, returns recent notes via cursor pagination. With --date, returns all notes for that day.
-  get <noteId>             Get a single note by id.
-  create [options]         Create a note. Provide --content (use '-' for stdin) and/or attachments.
-  edit [options] <noteId>  Edit a note. Provide --content and/or --agent-id.
-  delete <noteId>          Delete a note you authored.
-  help [command]           display help for command
+## get-note
+
+```
+Usage: gobi saved get-note [options] <noteId>
+
+Get a single note by id.
+
+Options:
+  -h, --help  display help for command
 ```
 
-## post
+## create-note
 
 ```
-Usage: gobi saved post [options] [command]
+Usage: gobi saved create-note [options]
 
-Saved posts (snapshots of posts and replies you bookmark).
+Create a note. Provide --content (use '-' for stdin) and/or attachments.
 
 Options:
-  -h, --help        display help for command
+  --content <content>  Note content (markdown supported, use "-" for stdin)
+  --timezone <tz>      IANA timezone name (default: system timezone)
+  --agent-id <number>  Optional agent id to associate with the note
+  -h, --help           display help for command
+```
 
-Commands:
-  list [options]    List posts you have saved.
-  get <postId>      Get a saved post snapshot by post id.
-  create [options]  Save a post or reply. Records a snapshot in your saved-posts collection.
-  delete <postId>   Remove a post from your saved-posts collection.
-  help [command]    display help for command
+## edit-note
+
+```
+Usage: gobi saved edit-note [options] <noteId>
+
+Edit a note. Provide --content and/or --agent-id.
+
+Options:
+  --content <content>  New note content (markdown supported, use "-" for stdin)
+  --agent-id <number>  New agent id, or "null" to clear the association
+  -h, --help           display help for command
+```
+
+## delete-note
+
+```
+Usage: gobi saved delete-note [options] <noteId>
+
+Delete a note you authored.
+
+Options:
+  -h, --help  display help for command
+```
+
+## list-posts
+
+```
+Usage: gobi saved list-posts [options]
+
+List posts you have bookmarked (paginated).
+
+Options:
+  --type <type>      Filter by type: all|article|space-post (default: "all")
+  --limit <number>   Items per page (default: "20")
+  --cursor <string>  Pagination cursor from previous response
+  -h, --help         display help for command
+```
+
+## get-post
+
+```
+Usage: gobi saved get-post [options] <postId>
+
+Get a saved post snapshot by post id.
+
+Options:
+  -h, --help  display help for command
+```
+
+## create-post
+
+```
+Usage: gobi saved create-post [options]
+
+Bookmark a post or reply by id. Records a snapshot in your saved-posts collection.
+
+Options:
+  --source <id>  Source post or reply id to bookmark (numeric)
+  -h, --help     display help for command
+```
+
+## delete-post
+
+```
+Usage: gobi saved delete-post [options] <postId>
+
+Remove a post from your saved-posts collection.
+
+Options:
+  -h, --help  display help for command
 ```

package/skills/gobi-sense/SKILL.md

@@ -1,18 +1,18 @@
 ---
 name: gobi-sense
 description: >-
-  Gobi sense commands for activity and transcription data: fetch activity
-  records and transcription records within a time range. Use when the user
-  wants to review their activities or transcriptions from Gobi Sense.
+  Gobi sense commands for activity and transcription data: list activity
+  records and list transcription records within a time range. Use when the
+  user wants to review their activities or transcriptions from Gobi Sense.
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.0"
+  version: "2.0.6"
 ---
 
 # gobi-sense
 
-Gobi sense commands for activity and transcription data (v2.0.0).
+Gobi sense commands for activity and transcription data (v2.0.6).
 
 Requires gobi-cli installed and authenticated. See the **gobi-core** skill for setup.
 
@@ -23,15 +23,15 @@ Activities and transcriptions are captured by Gobi Sense (the wearable) and the
 For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
 
 ```bash
-gobi --json sense activities --start-time 2026-04-01T00:00:00Z --end-time 2026-04-08T00:00:00Z
+gobi --json sense list-activities --start-time 2026-04-01T00:00:00Z --end-time 2026-04-08T00:00:00Z
 ```
 
 Times are ISO 8601 UTC.
 
 ## Available Commands
 
-- `gobi sense activities` — Fetch activity records within a time range.
-- `gobi sense transcriptions` — Fetch transcription records within a time range.
+- `gobi sense list-activities` — List activity records within a time range.
+- `gobi sense list-transcriptions` — List transcription records within a time range.
 
 ## Reference Documentation
 

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

@@ -6,20 +6,20 @@ Usage: gobi sense [options] [command]
 Sense commands (activities, transcriptions).
 
 Options:
-  -h, --help                display help for command
+  -h, --help                     display help for command
 
 Commands:
-  activities [options]      Fetch activity records within a time range.
-  transcriptions [options]  Fetch transcription records within a time range.
-  help [command]            display help for command
+  list-activities [options]      List activity records within a time range.
+  list-transcriptions [options]  List transcription records within a time range.
+  help [command]                 display help for command
 ```
 
-## activities
+## list-activities
 
 ```
-Usage: gobi sense activities [options]
+Usage: gobi sense list-activities [options]
 
-Fetch activity records within a time range.
+List activity records within a time range.
 
 Options:
   --start-time <iso>  Start of time range (ISO 8601 UTC, e.g. 2026-03-20T00:00:00Z)
@@ -27,12 +27,12 @@ Options:
   -h, --help          display help for command
 ```
 
-## transcriptions
+## list-transcriptions
 
 ```
-Usage: gobi sense transcriptions [options]
+Usage: gobi sense list-transcriptions [options]
 
-Fetch transcription records within a time range.
+List transcription records within a time range.
 
 Options:
   --start-time <iso>  Start of time range (ISO 8601 UTC, e.g. 2026-03-20T00:00:00Z)