> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asymptotelabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Antigravity CLI

> Asymptote support details for Antigravity CLI endpoint telemetry

## Runtime Overview

Asymptote supports Antigravity CLI through native hook payloads sent to `beacon-hooks`. Antigravity support was added in the endpoint agent in `v0.0.29`.

## Prerequisites

Before enabling Antigravity hooks, make sure:

* Antigravity CLI is installed as `antigravity` or `antigravity-cli`, or an Antigravity hook config directory exists.
* `beacon endpoint install` has run so shared endpoint config and runtime log paths exist.
* Asymptote hooks are installed with `beacon endpoint hooks install --harness antigravity`.
* For project-level collection, install hooks from the target project with `--level project`.
* Antigravity is restarted after hook install or removal so new sessions load the updated hook configuration.

## Collection path

Antigravity invokes Asymptote's hook adapter from Antigravity hook configuration. The adapter writes normalized endpoint events to the configured runtime JSONL log.

## Discovery and status

Asymptote detects Antigravity through the `antigravity` or `antigravity-cli` executable, `~/.gemini/config`, or `./.agents`, then checks Asymptote hook configuration.

Use `beacon endpoint hooks status --harness antigravity` to inspect Antigravity hook status.

## Install or configuration support

`beacon endpoint install` prepares shared endpoint config and runtime log paths. Install Antigravity hooks separately:

```bash title="Install runtime hooks" theme={null}
beacon endpoint hooks install --harness antigravity
```

For project-level hooks, run:

```bash title="Install project-level hooks" theme={null}
beacon endpoint hooks install --harness antigravity --level project
```

Asymptote writes user-level Antigravity hooks to `~/.gemini/config/hooks.json` and project-level hooks to `./.agents/hooks.json`. It manages a `beacon-endpoint` hook block and preserves unrelated hook blocks.

## Telemetry coverage

| Area                              | Support                                                                                                                                            |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Prompt telemetry                  | Supported through `PreInvocation` and `UserPromptSubmit` hooks                                                                                     |
| Command, tool, and file telemetry | Supported for pre-tool, post-tool, invocation stop, command, failed edit, quoted path, diff, and file edit payloads where Antigravity exposes them |
| Local JSONL and dashboard         | Supported                                                                                                                                          |
| MDM deployment                    | Supported for the endpoint agent; Antigravity hooks are installed separately in the logged-in user's context or project context                    |

Antigravity can invoke a pre-tool hook before its transcript file contains readable prompt text. Asymptote waits until the transcript is available before marking `prompt.submitted` as emitted, so the next hook in the same session can still record the prompt event.

## Deployment notes

Restart Antigravity after installing or removing hooks so new sessions pick up the updated hook configuration.

If Antigravity telemetry is missing, check the selected hook level, confirm the hook file contains commands with `--platform antigravity`, and run `beacon endpoint hooks status --harness antigravity`.

## Related

<Columns cols={2}>
  <Card title="Supported agent harnesses" icon="list-check" href="/runtimes">
    Return to the runtime support overview.
  </Card>

  <Card title="Hooks" icon="plug" href="/cli/hooks">
    Install, inspect, and uninstall runtime hook integrations.
  </Card>
</Columns>
