@gobi-ai/cli 0.7.3 → 0.9.0

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

@@ -0,0 +1,48 @@
+# gobi space
+
+```
+Usage: gobi space [options] [command]
+
+Space commands (threads, replies).
+
+Options:
+  --space-slug <slug>                       Space slug (overrides .gobi/settings.yaml)
+  -h, --help                                display help for command
+
+Commands:
+  list                                      List spaces you are a member of.
+  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-threads [options] <topicSlug>  List threads tagged with a topic in a space (cursor-paginated).
+  get-thread [options] <threadId>           Get a thread and its replies (paginated).
+  list-threads [options]                    List threads in a space (paginated).
+  create-thread [options]                   Create a thread in a space.
+  edit-thread [options] <threadId>          Edit a thread. You must be the author.
+  delete-thread <threadId>                  Delete a thread. You must be the author.
+  create-reply [options] <threadId>         Create a reply to a thread 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.
+  help [command]                            display help for command
+```
+
+## list
+
+```
+Usage: gobi space list [options]
+
+List spaces you are a member of.
+
+Options:
+  -h, --help  display help for command
+```
+
+## warp
+
+```
+Usage: gobi space warp [options] [spaceSlug]
+
+Select the active space. Pass a slug to warp directly, or omit for interactive selection.
+
+Options:
+  -h, --help  display help for command
+```

package/skills/{gobi-dev-homepage → gobi-homepage}/SKILL.md

@@ -1,16 +1,16 @@
 ---
 name: gobi-homepage
 description: >-
-  Developer reference for building Gobi Applets — custom HTML pages hosted on
+  Developer reference for building Gobi Homepages — custom HTML pages hosted on
   webdrive and served as a vault's public homepage at gobispace.com/@{vaultSlug}.
-  Use when a developer wants to build or modify a vault homepage applet.
+  Use when a developer wants to build or modify a vault homepage.
 ---
 
-# Gobi Applet Developer Guide
+# Gobi Homepage Developer Guide
 
-A **Gobi Applet** is a custom HTML page hosted on a vault's webdrive and served as its public homepage at `https://gobispace.com/@{vaultSlug}`. Gobi injects a `window.gobi` bridge before any scripts run, giving the applet access to vault data, files, brain updates, and chat.
+A **Gobi Homepage** is a custom HTML page hosted on a vault's webdrive and served as its public homepage at `https://gobispace.com/@{vaultSlug}`. Gobi injects a `window.gobi` bridge before any scripts run, giving the homepage access to vault data, files, brain updates, and chat.
 
-> **Sandbox:** The applet runs in a sandboxed iframe with `origin: null`. Direct `fetch()` / `XMLHttpRequest` calls are blocked by CORS. All data access must go through `window.gobi.*`.
+> **Sandbox:** The homepage runs in a sandboxed iframe with `origin: null`. Direct `fetch()` / `XMLHttpRequest` calls are blocked by CORS. All data access must go through `window.gobi.*`.
 
 ---
 
@@ -20,9 +20,9 @@ A **Gobi Applet** is a custom HTML page hosted on a vault's webdrive and served
    ```bash
    gobi sync
    ```
-2. Set `homepagePath` in vault settings:
-   - `app/home.html` — Gobi sidebars visible alongside the applet
-   - `app/home.html?nav=false` — full-screen, no Gobi chrome
+2. Set `homepage` in BRAIN.md (homepage property):
+   - `homepage: "[[app/home.html]]"` — Gobi sidebars visible alongside the homepage
+   - `homepage: "[[app/home.html?nav=false]]"` — full-screen, no Gobi chrome
 
 ---
 

package/skills/gobi-media/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: gobi-media
+description: >-
+  Gobi media generation: generate images from text prompts (thumbnails,
+  assets, logos), edit and inpaint images, create avatar videos with voice
+  narration, list available avatars and voices, upload media files. Use when
+  the user wants to generate images, create videos, or manage media.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "0.8.0"
+---
+
+# gobi-media
+
+Gobi media generation commands (v0.8.0).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## Important: JSON Mode
+
+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"
+```
+
+## Available Commands
+
+### Upload
+
+- `gobi media upload-init` — Get a presigned upload URL for a media file.
+- `gobi media upload-finalize` — Confirm that a media upload is complete.
+
+### Avatars & Voices
+
+- `gobi media avatars` — List available avatars.
+- `gobi media voices` — List available voices.
+
+### Videos
+
+- `gobi media video-create` — Create an avatar video generation job.
+- `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` — Get the download URL for a completed video.
+
+### 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.
+
+## Reference Documentation
+
+- [gobi media](references/media.md)

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

@@ -0,0 +1,198 @@
+# gobi media
+
+```
+Usage: gobi media [options] [command]
+
+Media generation commands (videos, images).
+
+Options:
+  -h, --help                      display help for command
+
+Commands:
+  upload-init [options]           Get a presigned upload URL for a media file.
+  upload-finalize [options]       Confirm that a media upload is complete.
+  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 <id>             Get the download URL for a completed video.
+  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.
+  help [command]                  display help for command
+```
+
+## upload-init
+
+```
+Usage: gobi media upload-init [options]
+
+Get a presigned upload URL for a media file.
+
+Options:
+  --file-name <fileName>        Name of the file to upload
+  --content-type <contentType>  MIME type (e.g. image/png, video/mp4)
+  --file-size <fileSize>        File size in bytes
+  -h, --help                    display help for command
+```
+
+## upload-finalize
+
+```
+Usage: gobi media upload-finalize [options]
+
+Confirm that a media upload is complete.
+
+Options:
+  --media-id <mediaId>  Media ID from upload-init
+  -h, --help            display help for command
+```
+
+## avatars
+
+```
+Usage: gobi media avatars [options]
+
+List available avatars.
+
+Options:
+  -h, --help  display help for command
+```
+
+## voices
+
+```
+Usage: gobi media voices [options]
+
+List available voices.
+
+Options:
+  -h, --help  display help for command
+```
+
+## video-create
+
+```
+Usage: gobi media video-create [options]
+
+Create an avatar video generation job.
+
+Options:
+  --name <name>                              Name for the video
+  --avatar-id <avatarId>                     Avatar to use
+  --voice-id <voiceId>                       Voice to use
+  --script <script>                          Script for the avatar to read
+  --background-media-id <backgroundMediaId>  Background media ID (from upload)
+  --wait                                     Poll until generation completes
+  -h, --help                                 display help for command
+```
+
+## video-list
+
+```
+Usage: gobi media video-list [options]
+
+List all videos.
+
+Options:
+  -h, --help  display help for command
+```
+
+## video-get
+
+```
+Usage: gobi media video-get [options] <id>
+
+Get video metadata.
+
+Options:
+  -h, --help  display help for command
+```
+
+## video-status
+
+```
+Usage: gobi media video-status [options] <id>
+
+Poll video generation status.
+
+Options:
+  --wait      Poll until a terminal state is reached
+  -h, --help  display help for command
+```
+
+## video-download
+
+```
+Usage: gobi media video-download [options] <id>
+
+Get the download URL for a completed video.
+
+Options:
+  -h, --help  display help for command
+```
+
+## image-generate
+
+```
+Usage: gobi media 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
+
+Options:
+  --prompt <prompt>                        Text prompt for image generation
+  --name <name>                            Name for the generated image
+  --type <type>                            Generation type: image (default), thumbnail (YouTube-optimized), asset (logo/product)
+  --aspect-ratio <aspectRatio>             Aspect ratio (1:1, 16:9, 9:16, 4:3, 3:4)
+  --negative-prompt <negativePrompt>       Negative prompt
+  --seed <seed>                            Random seed for reproducibility
+  --reference-media-id <referenceMediaId>  Reference image media ID
+  --wait                                   Poll until generation completes
+  -h, --help                               display help for command
+```
+
+## image-edit
+
+```
+Usage: gobi media image-edit [options]
+
+Edit an existing image with a prompt (image-to-image).
+
+Options:
+  --media-id <mediaId>  Source image media ID
+  --prompt <prompt>     Edit instruction
+  --name <name>         Name for the edited image
+  --wait                Poll until generation completes
+  -h, --help            display help for command
+```
+
+## image-inpaint
+
+```
+Usage: gobi media image-inpaint [options]
+
+Inpaint an image region using a mask.
+
+Options:
+  --media-id <mediaId>           Source image media ID
+  --mask-media-id <maskMediaId>  Mask image media ID
+  --prompt <prompt>              Inpainting prompt
+  --name <name>                  Name for the inpainted image
+  --wait                         Poll until generation completes
+  -h, --help                     display help for command
+```
+
+## image-status
+
+```
+Usage: gobi media image-status [options] <jobId>
+
+Check image generation job status.
+
+Options:
+  --wait      Poll until a terminal state is reached
+  -h, --help  display help for command
+```

package/skills/gobi-sense/SKILL.md

@@ -0,0 +1,34 @@
+---
+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.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "0.8.0"
+---
+
+# gobi-sense
+
+Gobi sense commands for activity and transcription data (v0.8.0).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## Important: JSON Mode
+
+For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
+
+```bash
+gobi --json sense activities --from 2024-01-01 --to 2024-01-31
+```
+
+## Available Commands
+
+- `gobi sense activities` — Fetch activity records within a time range.
+- `gobi sense transcriptions` — Fetch transcription records within a time range.
+
+## Reference Documentation
+
+- [gobi sense](references/sense.md)

package/skills/gobi-space/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: gobi-space
+description: >-
+  Gobi space commands for community interaction: list/create/edit/delete
+  threads and replies, browse topics and topic threads, explore what's
+  happening in a space. Use when the user wants to read, write, or manage
+  threads and replies in their Gobi community spaces.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "0.8.0"
+---
+
+# gobi-space
+
+Gobi space commands for community interaction (v0.8.0).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## Gobi Space — Community Channel
+
+`gobi space` is the main interface for interacting with the user's Gobi community. When the user asks about what's happening, what others are discussing, or wants to engage with their community — use `gobi space` commands. Think of it as the user's community feed and communication hub.
+
+- When the user wants to explore or catch up on what's happening in their space, invoke `/gobi:space-explore`.
+- When the user wants to share or post learnings from the current session, invoke `/gobi:space-share`.
+
+## Space Slug Override
+
+`gobi space` commands use the space from `.gobi/settings.yaml`. Override it with a parent-level flag:
+
+```bash
+gobi space --space-slug <slug> list-threads
+```
+
+## Important: JSON Mode
+
+For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
+
+```bash
+gobi --json space list-threads
+```
+
+## Available Commands
+
+- `gobi space list-topics` — List topics in a space, ordered by most recent content linkage.
+- `gobi space list-topic-threads` — List threads tagged with a topic in a space (cursor-paginated).
+- `gobi space get-thread` — Get a thread and its replies (paginated).
+- `gobi space list-threads` — List threads in a space (paginated).
+- `gobi space create-thread` — Create a thread in a space.
+- `gobi space edit-thread` — Edit a thread. You must be the author.
+- `gobi space delete-thread` — Delete a thread. You must be the author.
+- `gobi space create-reply` — Create a reply to a thread in a space.
+- `gobi space edit-reply` — Edit a reply. You must be the author.
+- `gobi space delete-reply` — Delete a reply. You must be the author.
+
+## Reference Documentation
+
+- [gobi space](references/space.md)

package/skills/{gobi → gobi-space}/references/space.md

@@ -25,28 +25,6 @@ Commands:
   help [command]                            display help for command
 ```
 
-## list
-
-```
-Usage: gobi space list [options]
-
-List spaces you are a member of.
-
-Options:
-  -h, --help  display help for command
-```
-
-## warp
-
-```
-Usage: gobi space warp [options] [spaceSlug]
-
-Select the active space. Pass a slug to warp directly, or omit for interactive selection.
-
-Options:
-  -h, --help  display help for command
-```
-
 ## list-topics
 
 ```

package/skills/gobi/SKILL.md

@@ -1,216 +0,0 @@
----
-name: gobi-cli
-description: >-
-  Manage the Gobi collaborative knowledge platform from the command line.
-  Gobi space is the user's main channel for social interactions and engaging with
-  the outside world — checking what's happening, reading and writing threads,
-  and collaborating with others.
-  Use when the user wants to interact with Gobi spaces, vaults, brains, threads,
-  sessions, or brain updates.
-allowed-tools: Bash(gobi:*)
-metadata:
-  author: gobi-ai
-  version: "0.7.3"
----
-
-# gobi-cli
-
-A CLI client for the Gobi collaborative knowledge platform (v0.7.3).
-
-## Prerequisites
-
-Verify the CLI is installed:
-
-```bash
-gobi --version
-```
-
-If not installed:
-
-```bash
-npm install -g @gobi-ai/cli
-```
-
-Or via Homebrew:
-
-```bash
-brew tap gobi-ai/tap && brew install gobi
-```
-
-## Key Concepts
-
-- **Space**: A shared space for a group or community. A logged-in user can be a member of one or more spaces. A space contains threads, sessions, brain updates, and connected vaults.
-- **Vault**: A filetree storage of information and knowledge. A local directory becomes a vault when it contains `.gobi/settings.yaml` with a vault slug and a space slug. Each vault is identified by a slug (e.g. `brave-path-zr962w`).
-- **Brain**: Another name for a vault when referring to its AI-searchable knowledge. You can search brains, ask them questions, and publish a `BRAIN.md` document to configure your vault's brain.
-
-## First-Time Setup
-
-The CLI requires three setup steps: authentication, vault initialization, and space selection.
-
-### Step 1: Initialize (Login + Vault)
-
-```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 `BRAIN.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 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
-```
-
-Check auth status anytime:
-
-```bash
-gobi auth status
-```
-
-**Important for agents**: Before running any `space` command, check if `.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.
-
-## Gobi Space — Community Channel
-
-`gobi space` is the main interface for interacting with the user's Gobi community. When the user asks about what's happening, what others are discussing, or wants to engage with their community — use `gobi space` commands. Think of it as the user's community feed and communication hub.
-
-- When the user wants to explore or catch up on what's happening in their space, invoke `/gobi:space-explore`.
-- When the user wants to share or post learnings from the current session, invoke `/gobi:space-share`.
-
-## Gobi Brain — Knowledge Management
-
-`gobi brain` commands manage your vault's brain: search across all spaces, ask brains questions, and publish/unpublish your BRAIN.md. Public brains are accessible at `https://gobispace.com/@{vaultSlug}`.
-
-## Gobi Session — Conversations
-
-`gobi session` commands manage your conversations: list, read, and reply to sessions.
-
-## Important: JSON Mode
-
-For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand) to get structured JSON output:
-
-```bash
-gobi --json space list-threads
-```
-
-or
-
-```bash
-gobi --json session list
-```
-
-JSON responses have the shape `{ "success": true, "data": ... }` on success or `{ "success": false, "error": "..." }` on failure.
-
-## Space Slug Override
-
-`gobi space` commands use the space from `.gobi/settings.yaml`. Override it with a parent-level flag:
-
-```bash
-gobi space --space-slug <slug> list-threads
-```
-
-For `gobi brain list-updates`, you can filter by space with a subcommand option:
-
-```bash
-gobi brain list-updates --space-slug <slug>
-```
-
-Note: `--space-slug` is not available on other `brain` subcommands or on `session` commands.
-
-## Available Commands
-
-- `gobi auth` — Authentication commands.
-  - `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` — Space commands (threads, replies).
-  - `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 space list-topics` — List topics in a space, ordered by most recent content linkage.
-  - `gobi space list-topic-threads` — List threads tagged with a topic in a space (cursor-paginated).
-  - `gobi space get-thread` — Get a thread and its replies (paginated).
-  - `gobi space list-threads` — List threads in a space (paginated).
-  - `gobi space create-thread` — Create a thread in a space.
-  - `gobi space edit-thread` — Edit a thread. You must be the author.
-  - `gobi space delete-thread` — Delete a thread. You must be the author.
-  - `gobi space create-reply` — Create a reply to a thread in a space.
-  - `gobi space edit-reply` — Edit a reply. You must be the author.
-  - `gobi space delete-reply` — Delete a reply. You must be the author.
-- `gobi brain` — Brain commands (search, ask, publish, unpublish, updates).
-  - `gobi brain search` — Search public brains by text and semantic similarity.
-  - `gobi brain ask` — Ask a brain a question. Creates a targeted session (1:1 conversation).
-  - `gobi brain publish` — Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (brain sync, metadata update, Discord notification).
-  - `gobi brain unpublish` — Delete BRAIN.md from the vault on webdrive.
-  - `gobi brain list-updates` — List recent brain updates. Without --space-slug, lists all updates for you. With --space-slug, lists updates for that space. Use --mine to show only updates by you.
-  - `gobi brain post-update` — Post a brain update for a vault.
-  - `gobi brain edit-update` — Edit a published brain update. You must be the author.
-  - `gobi brain delete-update` — Delete a published brain update. You must be the author.
-- `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 sense` — Sense commands (activities, transcriptions).
-  - `gobi sense activities` — Fetch activity records within a time range.
-  - `gobi sense transcriptions` — Fetch transcription records within a time range.
-- `gobi sync` — Sync local vault files with Gobi Webdrive.
-- `gobi update` — Update gobi-cli to the latest version.
-
-## Reference Documentation
-
-- [gobi auth](references/auth.md)
-- [gobi init](references/init.md)
-- [gobi space](references/space.md)
-- [gobi brain](references/brain.md)
-- [gobi session](references/session.md)
-- [gobi sense](references/sense.md)
-- [gobi sync](references/sync.md)
-- [gobi update](references/update.md)
-
-## Discovering Options
-
-Run `--help` on any command for details:
-
-```bash
-gobi --help
-gobi auth --help
-gobi space --help
-gobi brain --help
-gobi session --help
-gobi sense --help
-gobi sync --help
-```
-
-## Configuration Files
-
-| Path | Description |
-|------|-------------|
-| `~/.gobi/credentials.json` | Stored authentication tokens (auto-managed) |
-| `.gobi/settings.yaml` | Per-project vault and space configuration |
-| `BRAIN.md` | Brain document with YAML frontmatter, published via `gobi brain publish` |
-
-## Environment Variables
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `GOBI_BASE_URL` | `https://api.joingobi.com` | API server URL |
-| `GOBI_WEBDRIVE_BASE_URL` | `https://webdrive.joingobi.com` | File storage URL |