powdermonkeylisted
Install: claude install-skill zmaril/powdermonkey
# PowderMonkey
PowderMonkey is a single-operator tool for long-term solo dev. It tracks work as **Goals → Milestones → Tasks → Phases**, and runs each task as a **Session** — either `local` (a git worktree on `pm/task-<id>`) or `remote` (`claude --remote`). The supervisor runs on `main`, owns the *desired* plan, and **never executes work itself**. Progress is read off `main`; nothing self-reports.
The API base URL is in `$PM_URL` (default `http://localhost:4500`).
There are two roles. You're in the **supervisor shell** (repo dir) → see *Driving*. You're in a **`pm/task-<id>` worktree** → see *Working a task*.
## Driving PowderMonkey (supervisor shell)
**Author a plan.** Plans are a nested, id-less tree; the loader assigns ids and wires foreign keys. `POST $PM_URL/plan`:
```json
{
"goals": [{
"title": "...", "objective": "...",
"milestones": [{
"title": "...",
"tasks": [{
"title": "...",
"phases": [{ "name": "write tests" }, { "name": "implement" }]
}]
}]
}]
}
```
Validation is strict (TypeBox); a malformed plan returns 422. Don't include ids — they're assigned.
**Inspect / edit.** Every entity has full CRUD: `GET/POST/PATCH/DELETE $PM_URL/{goals|milestones|tasks|phases|sessions}` (and `/:id`). `DELETE` is a **soft delete** (sets `archived_at`, hides from lists); `?archived=true` includes archived; `POST /{entity}/:id/restore` un-archives. Use these to refine a plan after loading it.
**Run & land.** `POST $PM_URL/tasks