Antigravity CLI

Antigravity CLI is Google's agentic coding CLI — installed as the agy binary — for planning, editing, and running code straight from the terminal. Pair it with SpecStory to turn every conversation into reusable Markdown notes.

Run Antigravity CLI with SpecStory

Tip

Install SpecStory first: see the Terminal Coding Agents overview.

specstory run antigravity

Note

For the full SpecStory CLI command and flag reference, see Configuration.

You use Antigravity CLI normally while SpecStory records the entire conversation and context.

List existing Antigravity CLI sessions

List all the Antigravity CLI conversations SpecStory can see and sync for the current project directory.

specstory list antigravity

Sync existing Antigravity CLI sessions

Forgot to launch with specstory run antigravity? Convert prior conversations with specstory sync.

# Convert every stored Antigravity CLI conversation
specstory sync antigravity

# Convert a single conversation by UUID
specstory sync antigravity -s <conversation-uuid>

# Inspect sync logs in your terminal
specstory sync antigravity --console

Session sources: Read from ~/.gemini/antigravity-cli/brain/<conversation-id>/.system_generated/logs/transcript_full.jsonl.

Note

Antigravity CLI keeps its data under ~/.gemini/antigravity-cli/. Everything SpecStory reads lives in that subtree.

The resulting Markdown files live under .specstory/history/ with timestamps and metadata for easy sharing.

Watch for Antigravity CLI activity

Prefer to run the Antigravity CLI directly or via another tool? Use specstory watch to watch the current project directory for any new agent activity and auto-save it to markdown.

# Watch for activity from any supported coding agent
specstory watch

# Watch for only new Antigravity CLI agent activity
specstory watch antigravity

Run specstory watch without an agent name to capture activity from any supported provider.

Resuming Antigravity CLI sessions

Antigravity CLI conversations show up in the specstory resume picker and resume in place — SpecStory relaunches agy against the existing conversation (agy --conversation <id>), so the agent keeps its full memory of the thread.

specstory resume

Info

Antigravity CLI can't be a target for another agent's session. Its resumable state lives in a SQLite conversation store that SpecStory can't synthesize, so specstory resume antigravity is rejected — run specstory resume without a target and pick an Antigravity session to continue it in place. Cross-agent handoffs still work in the other direction and into agents like Claude Code and Codex CLI. See Resume a Session.

Best Practices

Segment workstreams: Start a fresh Antigravity conversation per task so transcripts stay focused.
Document custom tooling: Add notes about bespoke scripts or workflows to the Markdown files for teammate handoff.
Archive transcripts: Commit .specstory/history/ alongside your code to preserve design intent.

Troubleshooting

agy command missing: Confirm installation by running agy --version outside SpecStory, then re-run specstory check antigravity.
Installed somewhere else? Point SpecStory at it with specstory run antigravity -c "~/bin/agy" or set antigravity_cmd in your config.
No Markdown output: Run inside a project directory that contains .specstory/ and allows writing.
Sync returns nothing: Ensure Antigravity CLI has stored conversations under ~/.gemini/antigravity-cli/brain/. Conversations started in print mode with no recoverable workspace aren't scoped to a project.
Need assistance? Contact support@specstory.com or open a ticket on GitHub.