antigravity-swarm

Antigravity Swarm

█████╗ ███████╗██╗ ██╗ ██╔══██╗██╔════╝██║ ██║ ███████║███████╗██║ █╗ ██║ ██╔══██║╚════██║██║███╗██║ ██║ ██║███████║╚███╔███╔╝ ╚═╝ ╚═╝╚══════╝ ╚══╝╚══╝

Antigravity CLI workflow layer: type asw and turn a loose request into a planned agent run.

Quick Start · Large Update · Mission Control · Aliases · HUD · 한국어

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.