Skip to content

antigravity.md

Latest commit

 

History

History
121 lines (88 loc) · 4.36 KB

antigravity.md

File metadata and controls

121 lines (88 loc) · 4.36 KB
Raw

Google Antigravity CLI (agy)

OpenAB supports Google Antigravity CLI via the agy-acp adapter — a thin Rust binary that translates ACP JSON-RPC into agy -p invocations.

How It Works

openab ──ACP JSON-RPC──► agy-acp ──spawns──► agy --add-dir /home/agent -p "prompt"
                                              agy --add-dir /home/agent --conversation <ID> -p "follow-up"
  • First prompt in a session: agy -p "text", then discovers the conversation ID
  • Subsequent prompts: agy --conversation <ID> -p "text" (resumes specific conversation)
  • Only the delta (new response) is sent back — previous turns are not repeated
  • Full <sender_context> metadata is passed through to agy

Configuration

[agent]
# command defaults from OPENAB_AGENT_COMMAND="agy-acp"
# Only override if you need non-default behavior

Environment Variables

Variable Description Default
AGY_WORKING_DIR Working directory for agy invocations /tmp
AGY_EXTRA_ARGS Extra arguments added to every agy prompt invocation (optional) (none)
OPENAB_TOOL_DISPLAY Controls filtering of intermediate thinking narration ("I will..."). full or unset keeps all output; compact/none/off drops leading narration-only parts. full

Print timeout

agy-acp supplies --print-timeout 20m on every prompt invocation unless AGY_EXTRA_ARGS includes --print-timeout <duration> or --print-timeout=<duration>. This gives longer tasks more time before the CLI ends the turn with Error: timeout waiting for response.

Migration: The adapter now uses a 20-minute timeout instead of inheriting the CLI timeout (5 minutes in the version used to diagnose this issue). To retain a 5-minute limit or choose another duration, configure it explicitly:

[agent.env]
AGY_EXTRA_ARGS = "--print-timeout 5m"

The timeout remains finite; tasks exceeding the configured duration can still fail. This setting controls the CLI print timeout, not other OpenAB timeouts.

Steering Files

agy reads AGENTS.md and GEMINI.md when it considers a directory a workspace:

  1. AGENTS.md and GEMINI.md are loaded first and injected into the system prompt
  2. agy does not disclose how it determines HOME as a workspace, but --add-dir explicitly adds a directory
  3. agy-acp automatically passes --add-dir <working_dir> on every invocation — no configuration needed

Place your steering instructions in /home/agent/AGENTS.md or /home/agent/GEMINI.md — they will be read on every prompt as long as working_dir points to that directory.

Docker

docker build -f Dockerfile.antigravity -t openab-antigravity .

Authentication

Antigravity CLI uses Google Sign-In (OAuth). Authenticate inside the container:

kubectl exec -it deployment/openab-antigravity -- sh -c "$OPENAB_AGENT_AUTH_COMMAND"

Complete the device flow in your browser. Auth tokens persist in the PVC at ~/.gemini/.

Helm

agents:
  antigravity:
    discord:
      botToken: "${DISCORD_BOT_TOKEN}"
      allowedChannels: ["123456789"]
    agent:
      command: "agy-acp"
      args: []
      workingDir: "/home/agent"
    # image: leave empty — chart auto-resolves to openab:<tag>-antigravity

Limitations

  • No streaming: agy -p returns the full response at once; the adapter sends it as a single agent_message_chunk notification.
  • Cancel is a no-op: agy -p runs to completion; session/cancel acknowledges but cannot interrupt.

Model Selection

The Discord /models dropdown is supported. agy-acp returns model configOptions when a session is created or loaded. It fetches the available models from agy models and caches a successful result. If the live fetch fails, the adapter uses the cache and then falls back to this static list when no cache is available:

  • Gemini 3.5 Flash (Medium)
  • Gemini 3.5 Flash (High)
  • Gemini 3.5 Flash (Low)
  • Gemini 3.1 Pro (Low)
  • Gemini 3.1 Pro (High)

When a user selects a model with /models, OpenAB sends session/set_config_option. agy-acp stores the selected model for that session and adds --model <model_id> to subsequent agy invocations.

To select a default model for every new session, set default_config_options:

[pool]
default_config_options = { model = "Gemini 3.5 Flash (Medium)" }