Skip to content

antigravity.md

Latest commit

 

History

History
77 lines (55 loc) · 2.81 KB

antigravity.md

File metadata and controls

77 lines (55 loc) · 2.81 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 prepended to every agy 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

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.