Antigravity Swarm installs an ASW workflow layer for Antigravity CLI and Antigravity IDE. It bundles short wake words, global skills, hook routes, subagent presets, diagnostics guidance, background continuation, and a compact status line.

The old repo was a Gemini-first swarm runner. v0.2.4 is the large Antigravity rebuild: npm install, Antigravity-native plugin layout, ASW aliases, hooks, subagents, LSP diagnostics guidance, and a HUD that can surface context, git state, and model quota data when the CLI provides it.

[!IMPORTANT] Type asw when the work is ready to move. Type asw-plan when the work needs shape first. Type asw-review before you call it done.

Quick Start

npx --yes [email protected] install --permission-profile safe --hud

Then open Antigravity CLI or IDE in a project and use the loop:

asw-plan "Refactor auth without changing public behavior"
start-work
asw
asw-review

Prefer the installer menu:

npx antigravity-swarm --interactive

Choose a HUD color:

npx antigravity-swarm install --hud --hud-color rose

Available colors: cyan, blue, teal, green, lavender, rose, gold, orange, slate, gray.

Choose an installer permission profile:

npx --yes [email protected] install --permission-profile safe
npx --yes [email protected] --dry-run install --permission-profile balanced --settings-target /tmp/asw-settings.json

Profiles: safe is least-privilege/read-mostly and is the non-TTY default, balanced is the recommended ASW profile, full grants broad tool access and should only be used in trusted workspaces, and none installs files without modifying permission settings. Existing permission settings are preserved unless --force-permission is passed. custom is future work and is not implemented.

Other useful commands:

npx antigravity-swarm --dry-run install --permission-profile safe
npx antigravity-swarm verify
npx antigravity-swarm install-hud
npx antigravity-swarm uninstall

ASW writes the plugin under ~/.gemini/config/, installs global skill shims, and registers the HUD and optional OpenCode-compatible permission profile through ~/.gemini/antigravity-cli/settings.json. Existing different statusLine settings are left alone unless --force-hud is passed, and existing permission settings are left alone unless --force-permission is passed.

Large Update

v0.2.4 is not a rename pass. It moves the project from a script-oriented swarm into an Antigravity workflow package.

| Before | Now | |---|---| | Gemini-first runner scripts | Antigravity CLI and IDE plugin install | | Manual setup steps | npx antigravity-swarm install --hud | | Single command surface | Planner, executor, loop, reviewer, cleanup, goal, diagnostics guidance | | Static docs | Hooked aliases with visible workflow handoff | | Minimal prompt routing | Skills, hooks, subagents, LSP diagnostics guidance, HUD |

The center of gravity is the command loop:

• Type asw-plan to produce an executable plan before implementation.
• Type start-work or asw-start-work to run that plan with the executor contract.
• Type asw for test-first implementation and visible checks.
• Type asw-review for a final reviewer pass over changes, hooks, install behavior, and docs.

Mission Control

┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃                     ASW Antigravity Mission Control                  ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
┌──────────────┬────────────┬──────────────────────┬──────────────────┐
│ Command      │ Role       │ What it wakes         │ Best moment       │
├──────────────┼────────────┼──────────────────────┼──────────────────┤
│ asw-plan     │ planner    │ scope, risks, steps   │ before big work    │
│ start-work   │ executor   │ plan execution        │ after plan review  │
│ asw          │ loop       │ tests, code, QA       │ active build pass  │
│ asw-review   │ reviewer   │ diff and install QA   │ before shipping    │
└──────────────┴────────────┴──────────────────────┴──────────────────┘

This is the part inherited from the first Antigravity Swarm: visible coordination. The new version keeps that mission-control feeling, but moves the controls into Antigravity aliases, hooks, skills, agents, and a status line that stays with your session.

Aliases

Type these in Antigravity CLI or IDE:

| Alias | Mode | Use | |---|---|---| | asw-plan | planning | Large changes, migrations, unclear work | | start-work | execution | Run the plan produced by asw-plan | | asw-start-work | execution | Same as start-work, ASW-explicit | | asw-goal | goal | Long tasks with explicit completion criteria | | asw | loop | Test-first implementation and visible checks | | asw-loop | loop | Same as asw, more explicit | | asw-review | review | Diff, package, hook, and QA review | | asw-remove-ai-slops | cleanup | Remove generated-looking clutter while preserving behavior | The hook injects a short directive before the model call. It does not run shell commands from the prompt and ignores identifier-like text such as asw_helper.mjs.

Contents

Skills

The package ships 15 skills:

asw, asw-loop, asw-plan, asw-start-work, asw-review, asw-goal,
asw-debug, asw-programming, asw-lsp, asw-rules,
asw-comment-check, asw-refactor, asw-ui-ux, asw-cleanup,
asw-remove-ai-slops

Agents

Antigravity validates six subagent presets:

• asw-planner
• asw-planning-analysis
• asw-plan-audit
• asw-explorer
• asw-librarian
• asw-reviewer

Hooks

ASW installs hook support for alias detection, diagnostics guidance handoff, and background-work continuation.

LSP diagnostics

ASW includes a diagnostics guidance hook and skill guidance for running real language checks on changed files. The hook itself is a safe no-op and does not run a language server; use the project-native checks named by asw-lsp before claiming diagnostics passed.

Status Line

The typical HUD line is compact:

[✨ASW v0.2.4] │ GPT-OSS 120B (Medium) │ ctx [█▋] 81%/131k

If Antigravity passes /usage model quota rows into the status line payload, ASW can append a compact quota segment:

mq G-f(M) [█░] 60% · G-f(H) 60% · G-f(L) 60% · G-p(L) 60% ↻6d22h

Acknowledgements

ASW adapts community patterns for planning, hooks, skills, diagnostics, and careful review into Antigravity CLI terminology and contracts.