omp-antigravity-cli

An unofficial OMP plugin that delegates tasks and slash commands to the Antigravity CLI (agy).

[!NOTE] This plugin is no better than using the official agy harness. It does not make Antigravity faster, smarter, or magically enhanced. It delegates directly to the underlying agy command-line executable. This plugin is built for developers who dislike using the official agy harness and prefer staying inside their OMP environment without switching tools.

Requirements

• The Antigravity CLI (agy) installed and accessible on PATH (or pointed to via PI_AGY_BIN).
• An authenticated Antigravity account (ensure running agy in your terminal succeeds).

Installation

Local checkout (development)

Link the local repository directly:

omp plugin link /path/to/omp-antigravity-cli

This creates a symlink into ~/.omp/plugins/node_modules/omp-antigravity-cli, allowing local changes to take effect immediately on the next launch.

From GitHub

omp plugin install github:Attacktive/omp-antigravity-cli

From NPM

omp plugin install omp-antigravity-cli

To verify the installation:

omp plugin list

To remove the plugin:

omp plugin uninstall omp-antigravity-cli

Features

1. Slash Command (/agy)

Delegate prompts directly to agy from your OMP chat console:

/agy Inspect this codebase and identify memory leaks

Progress is streamed live to a rolling status widget above your editor:

agy: step 3 · 4s · run_command · bun test

Flags

• Continue previous conversation (default): Consecutive /agy commands continue the same conversation thread automatically.
• Model (default): If --model is omitted, the plugin lets agy choose its configured default model.
• Execution mode (default): If --plan is omitted, the plugin runs agy in its normal mode; --mode plan is passed only with --plan.
• --new: Force a new conversation session instead of resuming:

  /agy --new Start fresh analysis

• --plan: Run in read-only plan mode without making any workspace modifications:

  /agy --plan Suggest an architectural refactor for auth

• --model <id>: Use a specific model available in agy:

  /agy --model gemini-3.8-flash-high Run quick diagnostics
  /agy --model claude-opus-4-6-thinking Perform deep reasoning refactoring

• --resume <id>: Explicitly resume a prior conversation by its ID:

  /agy --resume 3e4b7c12-8f90-4a1b-98cd-123456789abc Continue the previous task

• --stop: Immediately cancel all running agy executions:

  /agy --stop

2. Agent Tool (agy)

The primary coding agent can also delegate self-contained sub-tasks to agy as a tool:

• Offloads tasks onto your Antigravity subscription to conserve primary model tokens.
• Obtains second opinions or parallel explorations from different model families.
• Automatically handles permissions (--dangerously-skip-permissions) and bounds file operations to the current workspace (--add-dir).

Parameters

| Parameter | Type | Required | Description | | :--- | :--- | :--- | :--- | | prompt | string | Yes | Self-contained task instructions, goals, and acceptance criteria. | | model | string | No | Target model ID (e.g. gemini-3.8-flash-high, claude-opus-4-6-thinking). | | conversation | string | No | Previous conversation ID to continue an existing session. | | plan | boolean | No | Run in read-only plan mode without file edits. |

Environment Variables

| Variable | Default | Description | | :--- | :--- | :--- | | PI_AGY_TIMEOUT | 900 | Wall-clock timeout in seconds handed to agy --print-timeout. | | PI_AGY_BIN | agy | Custom path or executable name for the agy binary. |

Development

Run tests, typechecks, and linters:

bun install
bun test
bun run typecheck
bun run lint

License

MIT