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.2 is the large Antigravity rebuild: npm install, Antigravity-native plugin layout, ASW aliases, hooks, subagents, LSP diagnostics, 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 antigravity-swarm install --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.

Other useful commands:

npx antigravity-swarm --dry-run install
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 through ~/.gemini/antigravity-cli/settings.json. Existing different statusLine settings are left alone unless --force-hud is passed.

Large Update

v0.2.2 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 | | Static docs | Hooked aliases with visible workflow handoff | | Minimal prompt routing | Skills, hooks, subagents, LSP diagnostics, 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 handoff, and background-work continuation.

LSP diagnostics

ASW includes a diagnostics hook and skill guidance for running real language checks on changed files.

Status Line

The typical HUD line is compact:

[✨ASW v0.2.2] │ 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.