Skip to main content

ANTIGRAVITY

Prerequisites

Initialize the repository

$ swamp repo init --tool antigravity

You will see output like:

20:46:58.279 INF repo·init Initialized swamp repository at "/path/to/your/repo" (tool: "antigravity")

What this sets up

Swamp adds its rules and skill list to AGENTS.md, copies bundled skills to .agents/skills/, and installs an audit hook at .agents/hooks.json that intercepts run_command tool calls and records them via swamp audit record --from-hook --tool antigravity. Your own project instructions coexist in AGENTS.md via managed sections — Swamp only touches its own delimited block.

AntiGravity follows the .agents/ convention shared with Amp, Codex, Copilot, and OpenCode: AGENTS.md for instructions, .agents/skills/ for project-level skills.

Use alongside another agent

Enroll multiple tools by repeating --tool on swamp repo init. Each tool's scaffolding is written independently, so AGENTS.md and another tool's instructions file (such as CLAUDE.md) coexist in the same repository.

$ swamp repo init --tool antigravity --tool claude

To enroll an additional tool in an existing repository, run swamp repo upgrade with the full intended list — upgrade replaces the enrolled tools, so any tool you want to keep must appear in the command:

$ swamp repo upgrade --tool antigravity --tool claude

Verify it works

Run agy in your repository and invoke:

/skill:swamp-getting-started

The agent matches the getting-started skill and walks you through creating your first model.

Record and view agent commands

Every shell command AntiGravity runs is appended to .swamp/audit/commands-YYYY-MM-DD.jsonl by the audit hook. View recent rows:

$ swamp audit --hours 1

Each row shows the command, cwd, timestamp, session ID, and success/failure.

To verify end-to-end, ask AntiGravity to run a command like ls, then in another terminal run swamp audit --hours 1. You should see that command in the output.

Upgrading

When a new version of Swamp is released, upgrade the repository to get updated skills, instructions, and audit hook:

$ swamp repo upgrade

The managed section in AGENTS.md is replaced with the latest content. Anything you wrote outside the managed section is preserved. The audit hook is overwritten with the latest version.

← PreviousPiNext →Vaults