<img src="../docs/screenshots/dashboard-light.webp" alt="The Plan2Code dashboard: a Set up card, then the steps in order as cards, one of them marked Suggested.">
<img src="../docs/screenshots/dashboard-utilities-light.webp" alt="The utility cards: Quick task, Review, Handoff and Git, which notes that the folder is not a git repository yet and offers to start one.">
<img src="../docs/screenshots/question-light.webp" alt="A Plan question card, How tasks are paged, with three options, the first marked Suggested, each with its trade-off underneath.">
<img src="../docs/screenshots/signoff-light.webp" alt="The Approve this phase card, with a button to read the completion report and three choices: Review the code first, Approve this phase, and I want changes.">
</picture>
The **Ask** tab is a chat beside the cards, for a quick question at any point.
bridges, a sprinkler, the Frog), **Kitchen Floor** (oil slicks, a rolling
orange, the Sneak, who drops cones), **Flowerbed Fork** (splits, ramps,
falling flowerpots, the Nudge), **Sandbox Run** (road that crumbles behind
you, the Hauler, the Bruiser), **Toy Room** (a toy train crossing, toy-block
chicanes, the Racer), **Garden Pond** (swaying bridges, drawbridges, the
Cop), **Rooftop Gutter** (gusts), **Night Lights** (everything, in the dark)
and **Monster Mash**, where the Monster truck hops at you and must be
stomped five times; then the road goes round again from Kitchen Floor,
quicker and meaner. The rivals get keener every stage: they block your
line, brake in front of you, swerve from under your landings, hop the gaps
and keep the pack close. Every hole has a warning sign and a straight
run-up, and can be cleared at 80% of the top speed. Power-ups lie on the
road from Hose Creek: **Spring**, **Bubble** (one free save), **Nitro** and
**Mega wheels** (bigger and heavier: flatten whatever you touch). Points
come from new road, rivals flattened (each kind its own, times the chain)
and bumped off, jumps, big air, close shaves, stars and boost strips (times
the combo), the Monster (2,000 for beating it), and each stage line (100
times the stage, a bonus for beating its par time, and with no life lost
250 more and a life back, up to five). Planny's car is your highlight
color, and a rival whose color sits too close to it wears a spare one. The
start and end screens show the furthest stage you have reached.
- **Ghoul Rush** is a fast, dark run-and-gun through a haunted house:
Planny sprints left to right through a mansion a room at a time, the view
scrolling with him. The house is pitch dark: you see what his glow, his
flashlight's cone, the candles, the moonlight and the muzzle flash light,
plus the eyes of whatever is waiting in the dark, and now and then
lightning lights the whole room for a moment. Hold left or right to run,
press up to jump (let go early for a short hop), down to drop through a
shelf or, on the ground, to duck (a crow, bat, gargoyle or other swooper
passes over your head if you are down before it reaches you), and hold space to fire his flashlight blaster the way he faces, ten
bolts a second; a bolt tilts toward a monster ahead near his height (and
toward a hovering wraith anywhere the tilt reaches). The blaster heats up
as it fires: about three seconds go at the full rate, then each bolt waits
longer, down to one a second (holding fire or hammering space heats it the
same). A **LIGHT** gauge at the right of the HUD shows it: the bar fills
as the blaster heats and empties as it cools, notched where the bolts
start to slow, pale, then amber near the notch, then red and **HOT** past
it. Let
go of fire and, after a fifth of a second, it cools, the hottest blaster
in about two seconds. Rapid fire's bolts add no heat and ignore it. **Tap
space twice** to use a **secondary weapon** you have picked up, shown by
a glowing icon and count beside the LIGHT gauge and by the same icon over
Planny's head; keep holding after the second
tap and the bolts carry on. The first tap still fires a bolt, feathering
the blaster never throws anything, and hammering space spends one at
most. The weapon you picked up last comes out first, you keep the rest
from room to room and through a lost life, and no weapon ever hurts you.
**Dynamite** (a wide blast on a short fuse), the **Iron Stake** (goes
through a whole line) and the **Bottle Rocket** (three at once: one
ahead, one that climbs and curves down onto the nearest monster above or
ahead, one behind, each going off in a blast with a trail of colored
sparks) turn up anywhere. Each stage has one of its own:
the Manor's **Billiard Ball** (rolls along the floor), the East Wing's
**Cast-Iron Skillet** (three pans circle you, then spiral off screen, each one-shotting what it touches and breaking on it), the
Graveyard's **Grave Salt** (burns the floor, even what is still buried),
the Grounds' **Hedge Sickle** (out and back, hitting on both passes), the
Chapel's **Tuning Fork** (a ring that cracks stone and strikes organ
pipes), the Sanatorium's **Flash Powder** (dazes what is near and shows
what hides), the Village's **Silver Bear Trap** (five a use: two behind, one at your feet and two ahead, each
snapping on the first thing to step in it) and the Mine's Dynamite, by the
bundle. A boss can take only so much from them (about a third of its
health at full force, then next to nothing), so they help a lot without
winning the fight, and one at half health drops its stage's weapon if your
bag is empty. Each room's door opens
once you grab its key, often up on a shelf. A run starts in **the Long
Hall**, an easy walk with only zombies, then goes **stage** by stage:
three rooms, then a boss, and beating it opens the door. Out of the hall
and out of each boss's room you **choose the next stage** from two
(one, once a single stage is left) never played that run, each card
showing the stage with its boss standing in it: left and right pick one
out, space or up goes in. Clear every stage and you **escape**, a win.
Each stage cleared makes the next quicker and tougher. Every other room keeps a **horde**
pouring in from the edges of the view, mostly ahead, so standing still is
never safe. **Zombies** shamble out of doors in the wall and sprint once
you are close, **crawlers** drag themselves up through loose boards,
**bats** swoop in level passes at your chest, **ghosts** drift through
walls and can only be hit (or hurt you) while solid, **skeletons** throw
bones you can shoot down, **hellhounds** crouch growling, then lunge in a
low arc a jump clears, **widows** hang from the ceiling and drop on you as
you pass under, **wraiths** hover ahead, shriek and dive at where you were
(keep moving, or shoot them first), and **bloaters** lob acid that leaves
burning puddles and burst into more acid when they die. Now and then a
zombie comes as a **runner** (fast, down in one bolt) or a **glutton**
(slow, 15 bolts to kill, a stomp only bruises it, and it never leaps or
climbs), and a widow or a hellhound as a **huntsman**, a big spider on the
floor that crouches and springs at you as high as you are. A shot to the head
or a stomp from above doubles a kill, and each kill within 1.2 seconds of
the last steps the chain, which multiplies kills up to x10. The rooms bring
pits, one-way shelves, crumbling boards and falling chandeliers that crush
whatever is below (a monster crushed counts double). Five stages so
far: **the Manor**, the **Foyer**, the **Portrait Gallery**, the **Library**, the **Ballroom**
(the **Rotting Gourd**, a giant rotten pumpkin that picks one of three
moves at random, never one three times running: a hop to where you stood,
its shadow showing where, that shakes loose gourdlings; a spit of two
acid globs after a shake; or a quake straight up and down that sends a
shockwave along the floor both ways). Its arena is stacked with balconies
in three tiers: up on one over its head it only spits at you, never hops,
a corner always leaves a pocket its hop cannot land on, and its gourdlings
jump up onto balconies after you and run off their ends to follow you
down), **the East Wing**, the
**Kitchen**, the **Conservatory**, the **Attic** and the **Crypt** (**Old
Rattlebones**, who throws volleys of five bones, slams shockwaves along
the floor you jump and throws his own skull like a boomerang, level at your
chest and back again, so jump it going and coming; headless meanwhile, he
has no weak spot, but a bolt to the flying skull does triple. His skull on
his shoulders takes double. At half his hp he shakes, his eyes flare and he
fights faster: his slams come in a double, he hurls bones up that come down
around you on shadows, and he raises up to two skeletons out of the floor),
and **the Graveyard**, out
under the night sky: the **Lychgate**, **Open Graves**, **Mausoleum Row**
and **Angel's Rest**. Its monsters are its own: **grasping hands** that lie
unseen under the dirt, burst up as you pass and creep along under the
ground after you; **mourners** whose wail slows you to half speed for a
moment if you are close; **grave robbers** who dig in and come up behind
you; **rotters**, zombies whose legs keep walking after you if you shoot
them down at the body (a headshot or a stomp finishes them); **carrion
crows** that wait on the headstones and dive at you; and rotters climbing
out of open graves. Its boss is **Mother Mourning**, a giant weeping angel:
while she weeps she is stone (your bolts glance off) and flings headstones,
then she turns and watches, and only then can she be hurt, but anything
but standing still while she watches brings a stone fist down where you
are, its shadow first. She does not stay where she was: each time she turns
back to watch she has blinked a few steps nearer, in a puff of stone dust.
At half her health she spreads her wings: a shorter weep, two headstones at
a time, a shockwave each way as each weep begins, and while she watches a
stone fist also falls near you now and then, moving or not.
A fourth stage, **the Grounds**, is the gardens under the night sky: the
**Hedge Maze**, the **Topiary Garden**, the **Gazebo** and the
**Groundskeeper's Yard**. Its monsters: **topiary beasts**, hedges clipped
into animals that stand frozen while you face them and charge the moment
your back is turned (so you can only shoot one while it is still);
**rootlings**, a crack that runs along under the lawn after you, stops
to warn, then bursts up as a solid root that hurts until it sinks again;
**lantern moths**, which come in flocks of three and flutter at you,
quicker in the dark and straighter still while you hold the Lantern; and
**mulch crawlers**, which wait in a leaf pile and burst out as you come
near. Its power-up is the **Hedge shears** (10 seconds, found only here):
one bolt cuts down a topiary beast or a rootling outright. Its boss is
**the Groundskeeper**. Jump his scythe as its low wave sweeps along the
floor, but when he raises it high (a pale band hangs in the air in front
of him) stay on the ground and let the high sweep pass over you; shoot the
lantern at his belt while it flares open (it takes triple damage, but only
then, and only briefly: after the scythe and again when the mower stalls);
jump or stand clear of the fire he lobs where you stand, which burns the
floor for a few seconds. At half his health he climbs onto a rusted mower:
when he revs, get up high on a shelf before he charges across the
arena (the charges come a little oftener), then shoot the lantern while he
is stalled against the far wall. On the mower he lobs a second fire where
you are heading, and each time the lantern opens a few lantern moths
flutter in toward it.
A fifth stage, **the Chapel**, is indoors again, candlelit stone and
stained glass: the **Nave**, the **Bell Tower**, the **Organ Loft** and
**the Choir**. Its monsters: **gargoyles**, stone on their ledges (your
shots glance off and a stomp does nothing) until you pass under one, when
it shakes loose, dives at your chest and flies back to turn to stone
again; **choir ghosts**, which drift at you and sing now and then, and
while they sing every monster near them moves faster, so kill them first;
**censer monks**, who walk at you, swing their censers and leave clouds of
harmless smoke that hide what is inside; and **bell bats**, asleep in the
bells until the bell tolls. The **bell toll** is the stage's twist: in the
tower and the choir the bell swings in view, then tolls, and for one
second everything freezes, you included (a bolt already flying still
hits), while a flock of bats bursts from every bell in view. Its power-up
is **Holy Water** (10 seconds, found only here): your bolts splash,
hurting every monster close to what they hit, hurting ghosts twice as much
and breaking a stone gargoyle even on its ledge. Its boss is **the
Choirmaster**, at his organ. Silence the four pipes to open him: each pipe
takes a handful of bolts, a sounding pipe spews a ghost now and then, and
while any pipe sounds he cannot be hurt. Once all four are silent, shoot
him. Between those he raises his baton and a column of notes flies at you
along the lines of a staff with one gap in it: mind the gap in each column
and be at its height (the floor or one of the boards) as it passes. At
half his health the hymn quickens: the notes fly faster, now and then a
second column follows close behind, and the pipes come back one by one,
each sounding again in turn.
A sixth stage, **Blackmoor Sanatorium**, is a derelict asylum of cracked
green tile: **Admissions**, the **Hydrotherapy Baths**, the **Surgical
Theater** and **the Night Ward**. Its monsters: **orderlies**, huge and
slow, which reach for you when you come close (jump clear while they wind
up), grab you and throw you a long way back (the throw costs no life, but
mind where you land); **gurneys**, solid enough to stand on while parked,
which rattle and roll at you when you come along their floor and hurt only
while rolling; **flickers**, gaunt patients you can neither see nor hit
while the lamps are lit, which lunge at you in the dark; and **specimen
bloaters**, which lob jars that shatter into puddles of formaldehyde. The
**flicker** is the stage's twist: in the baths and the theater the lamps
stutter, then go out for a moment, and in that blackout you see little
beyond your own glow. It has two power-ups found only here (10 seconds
each): **Smelling Salts** (you break an orderly's grab at once, and keep a
wide glow through a blackout, in which flickers show and take double
damage) and the **Bone Saw** (your bolts pierce every monster in a line,
and a gurney breaks in one hit). Its boss is **the Night Matron**. Stay out
of her lantern's beam as it sweeps the ward: a moment in it costs a life,
so hide behind a medicine cabinet or climb above it. Between sweeps she
throws fans of syringes, and cracks of light in a wall warn of a long arm
about to reach across the room at your height. At half her health the ward
goes dark, her lantern the only light, her arms come from both walls at
once and her fans of syringes grow.
A seventh stage, **Hollow End Village**, is out under the night sky again
(all but its inn): **Main Street**, **the Crooked Inn**, **the Town
Square** and **the Village Green**. The **moonrise** is the stage's twist:
in each room the moon climbs the sky, and when it is full every villager
in view turns into a fast, leaping wolf-man and the moonhounds grow, so
clear the villagers before the moon is up. Its monsters: the **torch mob**,
villagers who come in threes and lob torches that leave fire on the
ground; **hanged men**, swaying on their ropes until you pass under, when
they drop to head height and haul back up; **shutter ghouls**, which rattle
their shutters as you come near, then lunge out of the window (shoot them
while they are out); and **moonhounds**, which leap at you like
hellhounds. Its power-up is **Wolfsbane** (10 seconds, found only here):
wolf-men and moonhounds shy away from you, and your bolts do them and the
Beast double damage. Its boss is **the Beast of Hollow End**, a werewolf.
It bounds onto the walls at either end of the green and clings there a
moment, the time to shoot it for double damage, then pounces where you
stand (watch the shadow on the grass); up close it swipes, and its howl
calls moonhounds. At half its health the moon comes full: it waits less,
pounces twice in a row, and its howl calls grown hounds.
An eighth stage, **the Deep Seam Mine**, goes underground, where every room
is always dark: **the Mine Shaft** (ride the cage lifts up and down),
**the Flooded Tunnels** (knee-deep water slows you and your steps splash),
**the Collapse**, **the Runaway Cart** and **the Mother Seam**. **Rockfall** is the stage's
twist: dust trickling from the ceiling warns of a rock about to drop, which
crushes whatever is under it, you included. Its monsters: **Knocker imps**,
small and quick, whose touch steals your light (your glow shrinks to a
sliver for a few seconds, but no life is lost; shoot the imp to get it
back); **canary ghosts**, harmless to touch, but their scream brings three
rocks down around you, so shoot them first; **dead miners**, who burst out
of the walls with their helmet lamps still lit and swing a pickaxe up
close; and **blind crawlers**, which hunt by sound: stand still without
firing for a moment and they lose you. It has two power-ups found only
here: the **Hard Hat** (worn on your head until it is used, like the
Garlic shield: one rock bounces off it, or an imp knocks it off instead of
stealing your light) and bundles of **Dynamite** (three sticks here,
thrown with a double tap like any secondary weapon). Its boss is **the
Tommyknocker**, a miner-giant with a sledgehammer. He knocks on the rock
to bring the ceiling down, sweeps his hammer low along the floor (jump
it), and puts out the lights: in the dark an imp carries his lantern as a
decoy, so follow the knocking instead, and when he bursts out of the floor
he is dazed for a moment and takes double damage. At half his health the
dark lasts longer, his knocks come quicker and imps join in.
**The Runaway Cart** is a ride, not a walk: Planny rides a mine cart down a
roller coaster of track over the chasm and the cart does the moving. It
rolls on its own, quicker down a slope and slower up one; right leans
forward, left brakes, up jumps (left and right steer in the air) and down
ducks. Jump the gaps, the heaps of rubble and the crates (or shoot a crate
twice), duck the low beams, pick the right line where the track splits, and
do not brake for long: a boulder rolls up behind (and once it surges, hold
right to stay ahead of it). It is a **bonus round**: a long, fast ride (about
a minute) played for five hearts of its own, so a hit, a fall off the track
or a flattening costs a bonus heart, never a life, and you come back at the
last checkpoint. Lose all five and the round ends with nothing and the run
goes on to the Seam; get to the buffer stop and the door opens, and you earn
Lucky Dice (three at least, up to nine for hearts left, obstacles passed
untouched, crates broken and monsters shot, and not braking much).
A ninth stage, **the Midnight Carnival**, is a fairground at night:
**the Midway** (booths and counters to hop along), **the Hall of Mirrors**
(indoors), **the Funhouse** (its floors are conveyor belts that carry you
along while you stand on them, slower than you can run) and **the Big Top**.
Its monsters: **grinners**, clowns that honk out a balloon that drifts at
you at chest height (shoot it or it pops by itself, and it leaves a puddle
of acid for a couple of seconds; one on you costs a life, and ducking lets it
float over); **marionettes**, which hang just over your head and drop when
you pass under them (a bolt over its head, on the string, kills one at once,
else it takes four hits); **Mirror You**, which steps out of a mirror,
copies your moves the other way half a second late, and fires a bolt for
every bolt you fire (its bolts and yours cancel when they meet, so fire and
then move); **strongmen**, slow and huge, who lob barbells in an arc (a
stomp hurts one); and **circus hounds**, which crouch while a hoop of fire
flares and then leap, coming down where you stand (a ducked Planny is
passed over). It has two things found only here: **Cotton Candy** (10
seconds of sticky bolts that slow what they hit) and the **Custard Pie**
(thrown with a double tap in an arc, it splats and leaves everything near
stunned for three seconds; a pied Mirror You copies nothing meanwhile). Its
boss is **the Ringmaster**, on a gantry high over the ring, working a
giant puppet that hangs on three strings and stalks you round the ring: it
leaps to where you stood (watch the shadow, then jump the shockwaves),
charges along the floor to the wall (jump it) and stomps. Shoot the strings,
not the puppet: they follow it and slant as it moves, and from a trapeze
board or in a jump a bolt that crosses a string cuts into it, and
when all three are cut the puppet collapses and the Ringmaster is left
open on the floor for four seconds, the only time he can be hurt. Then he
climbs back and ties the strings again. Now and then he cracks his whip
along the floor at chest height (duck it, or jump it). At half his health the
cages in the wings open and hounds come out, and the strings take more hits.
Between the Funhouse and the Big Top is a second **bonus round**, **the Dark
Ride**: a side-view shooting gallery on rails where Planny sits in a ghost-train
car and twelve rooms of animatronics go wrong (a wax museum, a torture chamber
with the Executioner, a carousel, a hall of mirrors where only the solid ghoul
is real, a tunnel of love with the Black Swan, the Widow's nest, a lift hill, a
burning big top, a fake Exit, the Dark and the Barker), about a minute and a
half. Its title screen waits for a key or a click, and tips you to use the
mouse and to duck by moving your aim below the dashed line. Nothing walks: the **arrows** move an aiming reticle (it speeds up the longer
you hold), **Space** fires (hold to keep firing), and with the **mouse** you
move to aim and click or hold to fire. Pull the reticle down into the car,
below the dashed line, and Planny ducks (he cannot fire while ducked): the
answer to swinging blades, falling chandeliers and the big swings. Shoot
what lights up, chains and webs, and never the green-heart guests or a
mirror's reflections; a shot that just misses still finds a target close
to the reticle (never a guest). You have five hearts of your own and a
hit leaves you safe for a couple of seconds; killing a mini-boss gives one
back. Lose all five and the bonus ends with no dice and the run goes on to the
Big Top, its lives untouched; reach the end alive and you earn five to nine
Lucky Dice by how well you did (the dice pop out in a cascade).
A tenth and last stage, **the Frozen Lake**, is a frozen lake at night under
falling snow: **the Ice Fishing Huts** (open ice with holes in it), **the
Snowbound Lodge** (indoors, a hall the roof fell into), **the Black Ice**
(the longest room, ice nearly everywhere) and **the Widow's Web**. Between
the Black Ice and the Widow is a third **bonus round**, **the Coffin Sled**.
Two rules are its own and work in any room that sets them. **Ice** is
slippery: on it Planny's run eases up and eases off, so he slides a dozen
units past where you let go, a jump keeps the speed you had, and he stops
dead at the ice's edge. **Thin ice** is a tile that shows a crack when you
stand on it, breaks a moment later (the floor is a gap, and if you are on it
a life is lost: "went through the ice") and freezes again after a few
seconds; step off in time and it heals. Its monsters: **under-ice hands**,
which trail you beneath the ice, crack a thin tile under you or burst up and
grab (shoot or stomp one); **snow shades**, which you see only by their
footprints until one winds up or a bolt of yours passes near it, so shoot at
the prints; **frozen ghouls**, zombies that slide on ice and shatter when
they die into three shards (two run along the floor, jump them, and one flies
at head height, duck it); and **ice wraiths**, whose dive freezes you for
most of a second if it passes close (one dives at a time). Two things are
found only here: **Hot Cocoa** (10 seconds of no sliding, no freezing and
thin ice that cracks at half the speed) and the **Road Flare** (thrown with
a double tap in an arc, it lands and burns a patch for four seconds: it burns
what walks in without leaving drops, melts a Frozen Ghoul at once with no
shards, lights up a shade, and never hurts you). Its boss is **the Frost
Widow**, who hangs from the roof, drops to the floor and walks at you
behind a veil of ice that guards her. Kick or shoot the burning barrels at
her to melt the veil (a flare does it too); then, with her low, any shot
hurts and the heart takes triple while her mouth is open. A blizzard now and
then pushes you away from her (a barrel in between breaks the wind), ice
spikes rise from the floor where you stand (the line cracks first; a board
of 18 is over them), her web slows you while you are in it, and at half her
health the barrels are set out again and ice wraiths join in. **The Coffin
Sled** is a ride down a long frozen cemetery hill on a coffin lid, about a
minute and a half: the sled speeds up on the downs and slows on the ups on
its own, so you only jump (cracks in the ice, headstones, snowdrifts, hands),
duck (low branches and tombstone arches) and shoot (icicles, popping ghouls
and hands). It plays for five hearts of its own, so a hit costs a heart,
never a life, and a fall into a crack puts you back on the ice ahead. Lose
all five and the round ends with nothing and the run goes on to the Widow;
reach the snowbank and you earn three to nine Lucky Dice (hearts left,
obstacles passed untouched, things shot and souls and Cocoa taken).
Not every room is dark: each time you enter one it is dark three times in
five and otherwise lit, dim but seen whole (the same for the same run's
seed). In a dark room only half as many monsters come in from the edge
behind you. Power-ups lie in the rooms and now and then drop from
a kill: **Spread shot** and **Rapid fire** (eight seconds each), a **Garlic
shield** (shrugs off one hit and sees off what touched you; lose a life
within 12 seconds of coming in and you come back already holding one), a
**1UP**, a **Lucky die** (a white die, dropped by a kill as often as a
1UP and never lying in a room; every run starts with three, up to nine are kept for the whole run, shown
as a **DICE** pill, and a ninth more is points; when you would lose a life,
by any cause but the endless-lives code, one die rolls on the field (the rest
are kept). A 4, 5 or 6 brings you back where you fell, or after a pit on the
last ground you stood on, with no life lost and the room as it was: a 5 adds
a heart, a 6 a heart and a Garlic shield, and in an ordinary room every
monster in view blows apart for its points (in a boss's room nothing does).
A 3 or lower loses the life as usual: a 3 brings you back with Rapid fire and
a Garlic shield, a 2 with Bottle Rockets and a Garlic shield, and a 1 only
laughs at you, "Better Luck Next Time"; on your last heart a 2, 3 or 4 instead pays one heart, and you respawn with it as usual; every run starts with 3 dice), a
**Lantern** (15 seconds of the dark pulled far back, found only in a dark
room; in a lit one another power-up lies in its place), **Bat wings** (12
seconds of one flap in the air per jump, for a second jump; fall down a pit
with them on and they carry you back to the ground you fell from, costing no
life or die, and are used up), a **Church
bell** (4 seconds where every monster but a boss stands still and none
comes, ending at the door) and an **Hourglass** (20 more seconds on the
clock). Every room but a boss's has a **clock** (70 to 80 seconds, its
last ten ticking out loud); at none it costs a life and the room starts
over with a full clock. Two or more zombies, runners, crawlers or
gourdlings bunched under you climb over each other to reach you, arms
raised (land on the arms and they hurt you; only the head between them
takes a stomp), so a shelf over a
crowd is never a safe place to wait. The horde never ends, so its kills
(and those of the dead that come once the bonus is gone) are worth 80% of
the last one in the room, down to a tenth, and drop nothing: farming them
by the door pays next to nothing. A walker at the edge of a pit or a
drop (or a wall up to 8 high, for a zombie, runner or crawler) stops a
moment to think about it (a "?" over it), then leaps (or climbs): across
up to 10 units to floor at its own height, further down to a lower floor,
or straight down off a ledge; a wider pit or floor higher than a step
still stops it. High over each room's key
shelf (but a boss's) float **crystals** (250 points each) and in some
rooms **Silver bolts** (10 seconds of bolts that go on through every
monster they hit, found nowhere else): out of reach of one jump from
anywhere, but a jump and a **Bat wings** flap from the key shelf takes
them, and each such room has Bat wings on the way.
Points: 100 a zombie, 75 a crawler, 50 a bat, 150 a ghost or a hellhound,
120 a widow, 200 a skeleton or a wraith, 250 a bloater and 40 a gourdling,
all times the chain, 25 a bone or glob of acid shot down, 10 a soul and 50
a power-up; through a door, 300 times the room number, the time bonus left
(1500, dropping 50 a second; once it runs out, zombies come in from the
edges every second and a half) and 500 more with no life lost; 2000 for
the Gourd and 2500 for Rattlebones (90 hp), a quarter more for each stage
already cleared, with a life back up to nine. A hit or a fall costs one of seven lives and puts you back at the
room's start (in a boss fight, the arena's, the boss's hp kept), safe for
a moment, and on your last life the edges of the view pulse red. The start
and end screens show the most stages you have cleared in a run. When a
room starts again after a loss (a hit, a fall or the clock), a random
power-up shimmers a few steps ahead of Planny on every restart until you
clear the room (never a 1UP, and not in the bonus rides).
- **Keys.** Arrows or W/A/S/D steer, space starts and plays (and boosts in
Light Trails, fires while held in Bug Hunt, burns nitro in Sunset Drive,
where held up drives and held down brakes, drops the block in Stack Deploy, dashes in Bumper Ring, where held arrows push, fires while held in Rapids Run, where held up speeds up and held down slows, dashes in Hot Potato, where held arrows run, uses the oldest pickup in Crossing Rush, where an arrow hops once a press, jumps once a press in Bounce Road, where held up drives and held down brakes, and fires while held in Ghoul Rush, where held arrows run, up jumps once a press and down drops through a shelf), P pauses, R starts the round over (from the 3, 2, 1), F (or **Full screen** under the board) gives the game the whole screen and F or Esc puts it back, and Esc closes the window with the game paused. In full screen the board takes the whole screen, as big as its shape allows, with black bars where the shape leaves room, and a panel (the game's name, the score line, the game's **Music** slider for a game with music, Exit full screen) is laid over it: docked in the side bar when that bar is at least 220 px wide, in the bottom bar on a tall screen when that is at least 110 px tall, and otherwise floating in the top right corner (Sunset Drive's 16:9 board on a 16:9 screen), where it shrinks to the score line in the bottom right corner while a round plays and the pointer is still. The board never gives up room for the panel. The pointer hides after two still seconds. In the desktop app the page asks the app (`activities-full`) to lay the console over its bar and terminal and put the window in full screen, since the app's frame allows the page no full screen of its own. A question, a sign-off or a finish takes a full-screen game back to the window's own size as it pauses it. A page with no mouse or trackpad
| In User Preferences: arrow keys, `Home`, `End` | Move between its four tabs (up and down in the side list, left and right in the strip on a narrow window) |
The gear button in the top bar opens **User Preferences**, always on its first tab. Its four tabs sit in a side list, or in a strip along the top on a window narrower than 720px, and the arrow keys, `Home` and `End` move between them:
On Appearance and Sounds & activities each change saves the moment you make it, and a small **Saved** mark shows beside it. **Close** (or `Esc`) shuts the dialog. **Back to default** resets only the tab on screen: Appearance's four settings (Role back to *Not set*), or every sound and the two Activities switches (Show Activities and Play game sounds); Activities best scores stay. It is not shown on Agents & models or System, which have nothing to reset.
### Agents & models
Most people never need this tab: Plan2Code finds the agents installed on the machine and ships an up-to-date model list with every release. It opens on a summary table, one row per agent with its models and whether its command was found on this machine. **Edit** opens that agent's form and **Add agent** a blank one. Nothing on this tab saves as you type: each form has its own **Save** and **Discard**, and shows an **Unsaved** badge while it holds a change. Leaving a form with an unsaved change (another tab, **Back to summary**, **Close**, `Esc`) asks first: save it, discard it, or keep editing. Saving one agent never sends another's half-typed edit.
**Models.** The `plan2code` launcher's model menu comes from `models.json`, which every install overwrites with the authors' curated list. Each built-in agent's form (Claude, Devin, Codex) shows that list under *Comes with Plan2Code*, and below it **Models you added**, each a model id and the name shown in the menu, for a model that came out before Plan2Code was updated. Additions are kept in `~/.plan2code/models.json` and survive updates, unless the curated list now includes them; **Remove** takes one out. Restart `plan2code` to see a change. You can always run `plan2code --model <id>`, or switch model inside your agent before running a skill. Devin ids ending `-xhigh` or `-max` are refused. Maintainers refresh the curated list with the repo-local `/plan2code-model-update` skill, which shows a diff and changes only what they approve.
**Agents.** An agent you add is an agent CLI Plan2Code did not find on its own, which the `plan2code` command and the desktop app can then start. Each one has a name, the command to run (a bare name looked up on `PATH`, or a full path), and optional fields:
- **Models**: a list to offer, each an id and an optional label.
- Under the **Command-line arguments** fold:
- **Arguments**: one per row. `{prompt}` is replaced by the start prompt (for example `--message={prompt}`); with no `{prompt}` anywhere, the prompt is added last.
- **Bypass arguments**: added when permission checks are off.
- **Model arguments**: added when a model is chosen, with `{model}` replaced (`--model` and `{model}` by default).
**Test** beside the command shows where it is found, or "Not found on PATH", and never runs it. Saving a duplicate name, a blank command or a built-in id marks the field and writes nothing. **Delete agent** asks once more on the form before it removes one. The list is plain text in `~/.plan2code/agents.json`, shared by the `plan2code` command and the desktop app; this page is the only thing that writes it, and a broken file or entry is skipped with a warning shown on the tab, never a crash. If the file holds something the page could not read, saving asks first (**Save anyway**). `/plan2code` works only in agents that load the installed Plan2Code skills.
### System
**Cleanup** lists what Plan2Code does not need in `~/.plan2code/`, with sizes, before anything is deleted (**Find files to clean up**, then **Delete these**); what it offers and what always stays is under *Or clean up on demand* below.
**Desktop app** appears only when the page is open inside the desktop app. Its switch, **Show on the taskbar when Plan2Code needs me** (on by default), controls the app's taskbar signal: on Windows a green dot on your move and a red one when it needs attention, plus one short burst of flashes when the window is not focused (the button stays lit until you look); on macOS a red `!` dock badge when it needs attention and one bounce; on Linux a badge where your desktop supports it. Turning it off clears the dot and stops flashes. The choice is kept by the app in its own `~/.plan2code/app.json`.
| You closed the tab | Open the link again. Everything is where you left it. After about two minutes with no tab open the link stops working: ask the agent to resume the session for a new one. |
| The link stopped working | Tell the agent. It restarts the session and gives you a new link. |
| Your agent session died while you were mid-answer | Press Send anyway. Your answers are written to disk and are never discarded, including when the session is restarted. The next session picks them up. |
| The page says Plan2Code is not running | It has not checked in for a few minutes. Look at the terminal: it may have finished its turn, hit an error, or be waiting on you there. If it is idle, type `continue` in the terminal and it picks your answers up. Answering here still works, and what you send is held for it. |
| You are not sure anything is connected | The **?** at the top right opens Help. Its *What this page is* tab says what keeps the page alive and whether both halves are talking at that moment, and *When something looks stuck* covers what to check. |
| You would rather use the terminal after all | Say so. Nothing is lost. |
Nothing is installed. The skills ship a small zero-dependency Node server
(`references/web-console/`), and the workflow step starts it when you say yes.
```
agent server (detached) your browser
| | |
|-- open (binds the port, starts ->| |
| the server AND the browser) ---|---------------------------->|
|<-- http://127.0.0.1:PORT/s/TOK/ |<---- the page, first state -|
| | already inside it |
|-- post the first questions ----->|---- pushed to the page ---->|
|-- wait --seconds 240 ----------->| |
| (returns every 4 minutes with | |
| progress, then waits again) |<---- you press Send --------|
|<-- your answers -----------------| |
```
The server runs detached rather than as a background task of the agent, because
agent background tasks get killed at various timeouts, and that would take your
half-finished answers with them.
**It is built to show you something fast.** A browser takes most of a second to
turn up after it is asked, so `open` binds the page's port itself and sends the
browser there before the server has even finished starting; the server takes
the port over a moment later, and the browser's request waits for it rather
than being refused. The page arrives with the session already inside it, so it
draws the real screen without asking for anything first, in your own theme and
colors from the first frame. On a Windows laptop the page is in front of you in
roughly the time the browser itself takes to open.
**It stays up while the page is open.** The page pings it every few seconds, so
the idle clock never runs down while you are there. Close the tab and it shuts
itself down about two minutes later; it stops after four hours regardless, and
the agent stops it outright when the session ends.
That also means **the server routinely outlives the agent**. It is the agent, not
the server, that reads your answers, and the two fail separately. The page tells
the two apart: the **?** button at the top right opens Help, whose *What this
page is* tab says which halves are talking right now (and *When something
looks stuck* covers what to check), and Planny stops looking busy once
nothing is listening rather than spinning at you indefinitely.
**State lives in three places**, and none of them is your repository (the one
exception being the note attachments the agent keeps for a spec, above):
| Where | What | Survives |
| --- | --- | --- |
| `~/.plan2code/console/sessions/<id>/` | the questions, your draft, your answers | 30 days after the session was last touched |
| `~/.plan2code/console/sessions/<id>/workspace.json`, `ledger.ndjson`, `workspace-cursor.json` | the workspace's folders (paths, names, descriptions — never their contents), the session meter's events, and how far the agent has been told of workspace changes. Kept beside the session, so they outlive every dashboard hop | with the session |
| `~/.plan2code/console/sessions/<id>/uploads/` | images and documents attached to notes and quick questions | 30 days after the session was last touched |
| `~/.plan2code/handoffs/<id>.md`, `<id>.json` | each handoff's document, and which checkout, spec and skill it belongs to and whether it was picked up (`handoffs.mjs` is their one owner) | 30 days after it was last touched, picked up or not |
| `~/.plan2code/notepads/<folder-name>-<12 hex>/` | your notebook for one folder: `meta.json`, `tabs.json` and, per tab, `tabs/<id>/note.md` and `tabs/<id>/images/` (`notepads.mjs` is their one owner; the agent never reads them, except a tab you send) | until you delete it through Cleanup, which offers it once its newest file is 30 days old |
| `~/.plan2code/console/looks.json` | your role, theme, colors, sounds and card width, the Show Activities and Play game sounds switches (`hideActivities`, `activitySounds`), the last activity picked (`lastActivity`), best scores (flat `activityBest<Id>` keys: `activityBestSnake`, one per Mini golf course from `activityBestGolfPirate` to `activityBestGolfFrost`, `activityBestTrails`, `activityBestBugs`, `activityBestDrive`, `activityBestStack`, `activityBestBumper`, `activityBestRapids`, `activityBestFuse`, `activityBestHop`, `activityBestBounce`, `activityBestGhoul`) and each game's memo (`activityMemo<Id>`: Snake's surprises found, Light Trails' furthest arena, Bug Hunt's bugs, bosses and power-ups found, Sunset Drive's roads found, Stack Deploy's highest floor, Bumper Ring's furthest arena, Rapids Run's furthest dam, Hot Potato's furthest venue, Crossing Rush's furthest zone, Bounce Road's furthest stage, Ghoul Rush's most stages cleared in a run) | always |
| `~/.plan2code/console/subagents.json` | your Subagents switch, instruction and limit, per project folder and skill | always |
| `~/.plan2code/console/sessions/<id>/subagents-setting.json`, `subagents-cursor.json` | this session's copy of the switch, and how far the agent has been told of it | with the session |
| `~/.plan2code/agents.json` | your custom agent CLIs (User Preferences → Agents & models), read by the `plan2code` command and the desktop app | always |
behind the session cookie, and the ones that write also check the request's
origin.
| Route | Does |
| --- | --- |
| `POST /upload` | Raw bytes, original name in `x-p2c-name`. `Content-Type: image/jpeg`: writes `uploads/<uuid>.jpg` and answers `{ ok, id, kind: "image", path, url, name, size }`; not a JPEG → 415, over 4 MB → 413. `Content-Type: application/octet-stream`: a document, its extension from the name's allow-listed extension; writes `uploads/<uuid>.<ext>` and answers `{ ok, id, kind: "file", path, name, size }` with no `url`; not an allowed extension or contents that do not match → 415 `type`, over 10 MB → 413. Any other content type → 415. |
| `GET /uploads/<id>.<ext>` | Serves an upload: an image as `image/jpeg` (the thumbnail after a reload), a document as `application/pdf` or `text/plain; charset=utf-8` with `nosniff` and, on text, `Content-Security-Policy: sandbox`. Only `<uuid>.<allowed ext>` names under `uploads/`; anything else is 404. |
| `DELETE /uploads/<id>.<ext>` | Deletes an image or document removed before sending. 204, or 404 if it is not there. |
| `POST /submit` | The Send. A note may carry `images` and `files`, each `[{ path, name }]`: at most 5 together, images in `images` and documents in `files`, every path inside this session's `uploads/`, otherwise 400. |
| `POST /chat` | A Quick question `{ text, about?, images?, files?, conversation }`, or `{ reset: true, conversation }` for New conversation. Appended to the session's `chat.ndjson`. 400 `too-long` (over 4,000 characters), `image`, `file` or `bad`; 409 `offline`, `stale` or `limit` (10 per conversation). Never refused because a card send is still uncollected. |
| `POST /chat/decision` | Approve or Decline on an edit the agent proposed: `{ re, decision, text?, conversation }`. Once per proposal; does not count toward the 10. |
| `GET /overview?spec=specs/<name>[&file=map\|draft]` | The Overview tab's read of `<spec>/overview.md` (or, with `file=`, the Map tab's `pathfinder/map.md` or the Plan draft tab's live `PLAN-DRAFT-*.md`), as `text/markdown` with `cache-control: no-store` and the file's spec-relative name, URL-encoded, in `x-spec-file`. A missing file is a 204. On the dashboard `spec` must be one of the scanned specs; elsewhere the session's own spec is used. The file's real path must stay inside the project, so `../`, absolute paths and symlinks pointing out all get the same 204 as a missing file, as does an unscanned `spec` or an unknown `file`. |
| `GET /handoff?id=<id>` | *Read it all*: the handoff's `.md` from `~/.plan2code/handoffs/`, as `text/markdown` with `cache-control: no-store`. A dashboard only, and only an id its own scan listed: a used, unknown or malformed id is 404. |
| `GET /workspace` | The Workspace dialog's list: folders, `missing`, `remote` and the agent's folder `issues`. `?check=1` re-checks every folder on disk first. |
| `POST /workspace/add` | `{ path, name?, description? }`. The path is resolved against the folder the session started in (`~` expanded) and must be a folder: 400 `not-a-folder`, `duplicate` (with its `name`; compared case-insensitively on Windows and macOS), `bad-name`, or `name-taken` with a `suggest`. Answers the new entry, `nested: true` when it sits inside another folder in the list. |
| `POST /workspace/remove` | `{ id }`. 400 `original` for the folder the session started in, 404 `unknown`. |
| `POST /workspace/browse` | Opens the system folder picker and answers `{ path }` or `{ cancelled: true }`; never adds anything itself. 409 `busy` while one is open, 404 `no-picker` when the session looks remote or no picker exists. |
| `GET /notepad[?tab=<id>]` | The notepad for the folder this session runs in: `{ tabs: [{ id, name, sent? }], last, tab: { id, text, savedAt, images: [{ id, url, thumb }] } | null }`, with the tab's `text`, `savedAt` and `images` repeated at the top. Without `tab` it answers the last one used; 404 `no-such-tab` for an id it does not have. A notepad in the first shape answers one virtual tab, Notes. Reading never creates or moves a file. |
| `POST /notepad/text?tab=<id>` | `{ text }`. Saves that tab's `note.md` and answers `{ ok, savedAt }`; 400 `bad`, 404 `no-such-tab`, 413 `too-long` (over 1 MB). |
| `POST /notepad/image?tab=<id>` | Raw `image/jpeg` (the page re-encodes every picture first). Writes the tab's `images/<uuid>.jpg` and answers `{ ok, id, url }`; 415 `not-jpeg`, 413 `too-large` (over 4 MB), 409 `too-many` (200 pictures in the tab). |
| `POST /notepad/thumb?id=<uuid>&tab=<id>` | Raw `image/jpeg`: that picture's thumbnail. 404 `not-found` or `no-such-tab`, 415 `not-jpeg`, 413 `too-large`. |
| `POST /notepad/image/delete?tab=<id>` | `{ id }`. Deletes a picture and its thumbnail; 404 `not-found` or `no-such-tab`. |
| `POST /notepad/tab` | `{ name }`. Makes a tab, which becomes the last one used, and answers `{ ok, id, name }`; 400 `bad-name`, 409 `duplicate-name` (any case) or `too-many-tabs` (20). |
| `POST /notepad/tab/sent` | `{ id, workflow, spec? }`. Records that the tab was sent (`workflow` one of `pathfinder`, `plan`, `quick-task`, `revise-plan`; `spec` like `specs/<name>`) as `sent: { workflow, spec?, at }` on its `tabs.json` entry, shown back in `GET /notepad`'s `tabs`. The page posts it only after the Send that carried the filled box; 400 `bad-sent`, 404 `no-such-tab`. |
| `GET /notepad/images/<tab>/<uuid>.jpg`, `<uuid>.thumb.jpg` | Serves a picture or its thumbnail as `image/jpeg`, only by a tab id and a UUID name, a regular file (never a link) whose real path stays inside `~/.plan2code/notepads/`; anything else is 404. |
| `POST /subagents` | `{ on, instruction, max }` (`instruction: null` for the shipped default). Saves the switch for this project and skill and answers `{ ok, setting }`; 400 `not-offered` on a skill without the switch, `bad`, `too-long` (over 2,000 characters) or `max` (outside 1 to 20). |
| Wiring | one `additionalReferences` entry per skill in `install.js`; the dashboard's menu lives in `public/skills.js` (each entry's `card`; `SKILL_CATALOG` in `public/answers.js` is a lookup on it) |
| Agent contract | a card, `src/web-console/console.md` (read once), plus pointers: the console names a topic file (`console-*.md`, `notes/<workflow>.md`, `building.md` / `building-review.md`) in its own `read` output, once per session per topic, when its moment comes; `console.mjs help <topic>` prints any of them. A `stop` with no `finish`, or a `finish` while `stopWarning` is set, is refused with the fix; `stop --session <sid> --force` ends a dead page or an abandoned session anyway. Patches are one line, with lettered options and the console's own defaults filled in; a refused patch names the field and the fix. Byte budgets keep the card, the notes and a sample session's outputs from growing back (`scripts/test-console-wire-budgets.mjs`) |
| Tests | `node --test scripts/test-web-console-*.mjs` (split by area, shared setup in `scripts/web-console-test-helpers.mjs`), also run by `npm test` |
| Start-up benchmark | `node scripts/bench-web-console.mjs` (needs a local Chrome or Edge for the paint columns, driven through `playwright-core` from `npm install`; `--browser-delay 900` models a real browser launch, `--roundtrip` times Send→agent and post→page) |
| Screenshots | `node scripts/capture-screenshots.mjs` (needs a local Chrome or Edge, driven through `playwright-core` from `npm install`; `PLAN2CODE_TEST_BROWSER=chrome|msedge` forces one) |
| Dependencies | none at runtime. `marked` 15.0.7 (MIT) is vendored for its lexer only, and CodeMirror 6 (MIT) for the notebook's editor as one bundled file, `public/vendor/codemirror.esm.js`, made by the dev-only `node scripts/vendor-codemirror.mjs` from a pinned lock (about 500 KB, loaded only when the Notebook is first opened); the page's policy blocks the `<style>` element CodeMirror writes, so the editor lives in a shadow root where it adopts its rules as a constructed stylesheet (steps in the architecture doc's Notebook point) |
`node src/web-console/console.mjs help` prints the same command summary an
agent gets when it finds the binary before the docs.
`wait` exits `0` with the answers, `10` if nobody has finished yet, `20` if the
server died, `30` on Cancel. Pick `--seconds` to sit under whatever your harness
allows a single command: it is a poller, so killing it costs nothing, and a
collected result is printed before it is marked collected, which means an
interrupted handover can only repeat itself, never lose an answer. `status`
lists sessions and flags any whose answers were submitted but never collected.
When something misbehaves, the session directory is the whole story:
`state.json` (what the agent published), `draft.json` (what the person has typed
but not sent), `result.json` (what they sent), `events.ndjson` (an append-only
log you can `cat`), and `server.log`.
Set `--idle-ms 60000` on `open` if you want the server to shut itself down
quickly while experimenting.
Two environment variables help when the start is what you are looking at:
| Variable | Does |
| --- | --- |
| `PLAN2CODE_CONSOLE_TRACE=1` | `open` prints a timeline of its steps to stderr (roots found, server spawned, port bound, browser sent, state written, server listening). |
| `PLAN2CODE_BROWSER` | The command that opens the link instead of the system default, run through the shell with the link appended, e.g. `PLAN2CODE_BROWSER='firefox --new-tab'`. |