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

# Antigravity CLI

> Beacon support details for Antigravity CLI endpoint telemetry

## Runtime overview

Beacon 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.
* Beacon 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 Beacon's hook adapter from Antigravity hook configuration. The adapter writes normalized endpoint events to the configured runtime JSONL log.

## Discovery and status

Beacon detects Antigravity through the `antigravity` or `antigravity-cli` executable, `~/.gemini/config`, or `./.agents`, then checks Beacon 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
```

Beacon 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. Beacon 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>