v0.4.0MIT0 dependencies

five agents build your page.
you watch the run.

Swarm Troopers puts named cursor agents on your existing HTML. They survey each section, call four tools and hand the page back, built. Your markup stays the source of truth. The board logs a real run, step by step.

html · react · vue · svelte · astro · any stack

Live playground

site-demo.html
  1. run · websitequeued
  2. ○planeli · survey sections–
  3. ○type()text–
  4. ○frame()boxes–
  5. ○rule()lines–
  6. ○stamp()list items–
  7. ○doneeli · hand back–
Your HTML, built by the agents.0/0 steps · 0.0s

Same library, full page: the everyday website a real portfolio

the agents

Up to five on this page: one lead and four agents, sent as the page needs them. Pass names to rename them, or false to hide the tags.

idroletoolscolour
elilead · surveys sections, checks them, hands backplan, doneink
adaagenttype() frame() rule() stamp()#7DB4FF
miaagenttype() frame() rule() stamp()#B98CFF
noéagenttype() frame() rule() stamp()#5FE3D0
irisagenttype() frame() rule() stamp()#FF7EB6

four tools

Picked from your markup. Text gets typed, boxes get framed, lines get drawn, lists get stamped.

type(el, text)

Words with a human rhythm

A click, a caret, a short pause. Text appears where it already sits, so the layout never jumps.

frame(el)

A precise drag for every box

Cards, images and fields open from one corner to the other, then release.

rule(el)

Lines drawn end to end

Separators and borders get one steady stroke.

stamp(list)

Lists pressed into place

The first item is framed. The rest follow it, one stamp at a time.

guardrails

The agents are guests on your page. Four checks pass on every run.

content

Your HTML is the source of truth

Real content from the first byte. Search engines and screen readers get the whole page.

weight

One canvas, no dependencies

The overlay draws on a single canvas and goes idle when the run ends.

motion

Reduced motion is respected

With the setting on, the page shows up built. No agents, no wait.

control

Readers can switch it off

Full, light, off. The choice is remembered for the next visit.

install

npm i swarmtroopers.
or one script tag.

Keep your markup. Install the package, point it at your main element, and the agents do the rest. Working with Claude Code? One command installs the integration skill, then ask it to add Swarm Troopers to your page.

htmlreactvuesvelteastro
install
// npm i swarmtroopers
import { create, controls } from 'swarmtroopers';

const swarmtroopers = create({
  root: 'main',
  auto: true,
  inspect: true,
});

controls(swarmtroopers);
npm i swarmtroopers. Create on mount. Call swarmtroopers.destroy() when the view unmounts.

run complete.
your page stays.

Free to use, open to fork. MIT licensed.