From 0dba60f73b392a9bd63b071aa769078cc5dee84c Mon Sep 17 00:00:00 2001 From: teknium1 <127238744+teknium1@users.noreply.github.com> Date: Fri, 29 May 2026 04:16:26 -0700 Subject: [PATCH] docs(skills): regen catalog + sidebar for optional antigravity-cli skill --- .../docs/reference/optional-skills-catalog.md | 1 + .../productivity-antigravity-cli.md | 194 ++++++++++++++++++ website/sidebars.ts | 1 + 3 files changed, 196 insertions(+) create mode 100644 website/docs/user-guide/skills/optional/productivity/productivity-antigravity-cli.md diff --git a/website/docs/reference/optional-skills-catalog.md b/website/docs/reference/optional-skills-catalog.md index b82780c2c..dd1335c7a 100644 --- a/website/docs/reference/optional-skills-catalog.md +++ b/website/docs/reference/optional-skills-catalog.md @@ -151,6 +151,7 @@ hermes skills uninstall | Skill | Description | |-------|-------------| +| [**antigravity-cli**](/docs/user-guide/skills/optional/productivity/productivity-antigravity-cli) | Operate the Antigravity CLI (agy): plugins, auth, sandbox. | | [**canvas**](/docs/user-guide/skills/optional/productivity/productivity-canvas) | Canvas LMS integration — fetch enrolled courses and assignments using API token authentication. | | [**here.now**](/docs/user-guide/skills/optional/productivity/productivity-here-now) | Publish static sites to {slug}.here.now and store private files in cloud Drives for agent-to-agent handoff. | | [**memento-flashcards**](/docs/user-guide/skills/optional/productivity/productivity-memento-flashcards) | Spaced-repetition flashcard system. Create cards from facts or text, chat with flashcards using free-text answers graded by the agent, generate quizzes from YouTube transcripts, review due cards with adaptive scheduling, and export/impor... | diff --git a/website/docs/user-guide/skills/optional/productivity/productivity-antigravity-cli.md b/website/docs/user-guide/skills/optional/productivity/productivity-antigravity-cli.md new file mode 100644 index 000000000..e620e6494 --- /dev/null +++ b/website/docs/user-guide/skills/optional/productivity/productivity-antigravity-cli.md @@ -0,0 +1,194 @@ +--- +title: "Antigravity Cli — Operate the Antigravity CLI (agy): plugins, auth, sandbox" +sidebar_label: "Antigravity Cli" +description: "Operate the Antigravity CLI (agy): plugins, auth, sandbox" +--- + +{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */} + +# Antigravity Cli + +Operate the Antigravity CLI (agy): plugins, auth, sandbox. + +## Skill metadata + +| | | +|---|---| +| Source | Optional — install with `hermes skills install official/productivity/antigravity-cli` | +| Path | `optional-skills/productivity/antigravity-cli` | +| Version | `0.1.0` | +| Author | Tony Simons (asimons81), Hermes Agent | +| License | MIT | +| Platforms | linux, macos, windows | +| Tags | `Antigravity`, `CLI`, `Productivity`, `Auth`, `Plugins`, `Sandbox` | + +## Reference: full SKILL.md + +:::info +The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active. +::: + +# Antigravity CLI (`agy`) + +Operator guide for the Antigravity CLI, invoked as `agy`. Run all `agy` +commands through the Hermes `terminal` tool; inspect its config and logs with +`read_file`. This skill is reference + procedure — it does not wrap a network +API, so there is nothing to authenticate from Hermes itself. + +## When to Use + +- Installing, updating, or smoke-testing the `agy` binary +- Driving non-interactive `agy --print` / `agy -p` one-shots +- Debugging Antigravity auth, sandbox, permissions, or plugin state +- Reading Antigravity settings, keybindings, conversations, or logs + +## Mental model + +Antigravity has two layers — keep them distinct or the guidance will be wrong: + +1. **Shell wrapper commands** — `agy help`, `agy install`, `agy plugin`, + `agy update`, `agy changelog`. Run these through the `terminal` tool. +2. **Interactive in-session slash commands** — `/config`, `/permissions`, + `/skills`, `/agents`, etc. These only exist inside a running `agy` TUI + session, not on the shell wrapper. + +`agy help` shows the shell wrapper surface, NOT the in-session slash commands. + +## Prerequisites + +- The `agy` binary on PATH. Verify through the `terminal` tool: + `command -v agy && agy --version`. +- No env vars or API keys required by this skill — Antigravity manages its own + auth via the OS keyring / browser sign-in (see Authentication below). + +## How to Run + +Invoke every `agy` command through the `terminal` tool. Examples: + +``` +terminal(command="agy --version") +terminal(command="agy help") +terminal(command="agy plugin list") +terminal(command="agy --print 'Summarize the repo in 3 bullets'", workdir="/path/to/project") +``` + +For an interactive multi-turn TUI session, launch `agy` with `pty=true` (and +tmux for capture/monitoring), the same pattern the `codex` / `claude-code` +skills use. For one-shot smoke tests and scripted prompts, prefer +`agy --print` (non-interactive). + +To inspect Antigravity's own files, use `read_file` on the paths under Core +paths below — do not `cat` them through the terminal. + +## Core paths + +- Binary / entrypoint: `agy` +- App data dir: `~/.gemini/antigravity-cli/` +- Settings file: `~/.gemini/antigravity-cli/settings.json` +- Keybindings file: `~/.gemini/antigravity-cli/keybindings.json` +- Logs: `~/.gemini/antigravity-cli/log/cli-*.log` +- Conversations: `~/.gemini/antigravity-cli/conversations/` +- Brain artifacts: `~/.gemini/antigravity-cli/brain/` +- History: `~/.gemini/antigravity-cli/history.jsonl` +- Plugin staging: `~/.gemini/antigravity-cli/plugins//` + +## Quick Reference + +### Wrapper commands +- `agy changelog` +- `agy help` +- `agy install` +- `agy plugin` / `agy plugins` +- `agy update` + +### Useful flags +- `--add-dir` +- `--continue` / `-c` +- `--conversation` +- `--dangerously-skip-permissions` +- `--print` / `-p` +- `--print-timeout` +- `--prompt` +- `--prompt-interactive` / `-i` +- `--sandbox` +- `--log-file` +- `--version` + +### Plugin subcommands (`agy plugin --help`) +- `list`, `import [source]`, `install `, `uninstall `, + `enable `, `disable `, `validate [path]`, `link `, + `help` + +### Install flags (`agy install --help`) +- `--dir`, `--skip-aliases`, `--skip-path` + +### In-session slash commands +- **Conversation control:** `/resume` (`/switch`), `/rewind` (`/undo`), + `/rename `, `/clear`, `/fork`, `/reset`, `/new` +- **Settings & tools:** `/config`, `/settings`, `/permissions`, `/model`, + `/keybindings`, `/statusline`, `/tasks`, `/skills`, `/mcp`, `/open `, + `/usage`, `/logout`, `/agents` +- **Prompt helpers:** `@` path autocomplete, `esc esc` clears the prompt (when + not streaming), `!` runs a terminal command directly, `?` opens help + +## Settings and permissions + +### Common settings keys (`settings.json`) +- `allowNonWorkspaceAccess` +- `colorScheme` +- `permissions.allow` +- `trustedWorkspaces` + +### Permission modes +`request-review`, `always-proceed`, `strict`, `proceed-in-sandbox`. + +### Sandbox behavior +- `enableTerminalSandbox` is a boolean in `settings.json`; default `false`. +- Launch-time overrides (`--sandbox`, `--dangerously-skip-permissions`) can + supersede persistent settings for the current session. + +## Authentication behavior + +- The CLI tries the OS secure keyring first. +- With no saved session, it falls back to browser-based Google sign-in. +- Locally it opens the default browser; over SSH it prints an authorization URL + and expects the auth code pasted back. +- `/logout` removes saved credentials. + +## Plugins + +- Plugins stage under `~/.gemini/antigravity-cli/plugins//`. +- They can bundle skills, agents, rules, MCP servers, and hooks. +- `agy plugin list` returning no imported plugins is a valid empty state. + +## Pitfalls + +- `agy help` shows wrapper commands, not interactive slash commands. +- `agy --version` is the safe non-interactive version check; `agy version` is + interactive and can fail without a real TTY. +- First place to look for failures: `~/.gemini/antigravity-cli/log/cli-*.log` + (read with `read_file`). +- Don't confuse persistent JSON settings with launch-time overrides. +- `~/.gemini/antigravity-cli/bin/agentapi` is a thin wrapper to `agy agentapi`. +- On WSL, token storage is file-based, so auth issues are usually local-file / + session-state problems, not browser-only problems. +- Workspace identity can depend on launch directory and the `.antigravitycli` + project marker. + +## Verification + +Confirm the install is real and usable, all through the `terminal` tool (read +files with `read_file`): + +1. `terminal(command="command -v agy")` +2. `terminal(command="agy --version")` +3. `terminal(command="agy help")` +4. `terminal(command="agy plugin list")` +5. `read_file` on `~/.gemini/antigravity-cli/settings.json` +6. `read_file` on the latest `~/.gemini/antigravity-cli/log/cli-*.log` +7. If needed, `read_file` on `~/.gemini/antigravity-cli/keybindings.json` + +## Support files + +- `references/cli-docs.md` — condensed notes from the getting-started, usage, + and features docs. diff --git a/website/sidebars.ts b/website/sidebars.ts index 071f994f1..39143667f 100644 --- a/website/sidebars.ts +++ b/website/sidebars.ts @@ -545,6 +545,7 @@ const sidebars: SidebarsConfig = { key: 'skills-optional-productivity', collapsed: true, items: [ + 'user-guide/skills/optional/productivity/productivity-antigravity-cli', 'user-guide/skills/optional/productivity/productivity-canvas', 'user-guide/skills/optional/productivity/productivity-here-now', 'user-guide/skills/optional/productivity/productivity-memento-flashcards',