jayjayholic/jstack

Claude Code skills and scripts for running 10+ parallel AI coding agents on one laptop without melting it. Their branches ship as a train (one build, one PR, one CI run), heavy jobs share one machine-wide slot under a hard RAM ceiling, and every branch is checked before it boards. Every rule in here exists because something broke, usually my 32 GB laptop.
Quickstart · What you get · Merge trains · Preflight and unslop · RAM · Guard hooks · Worktrees · Domain packs · Optimize · Settings · FAQ
## Quickstart
In Claude Code:
text
/plugin marketplace add jayjayholic/jstack
/plugin install jstack@jstack
Then copy tools/config.example.sh to ~/.jstack/config.sh and fill in your values (branch, build and typecheck commands, RAM limits). When two or more agent branches are ready, type /train.
Don't want to configure it by hand? Tell your agent: "follow ADAPT.md in jayjayholic/jstack for my project". It detects your stack, fills in the settings, installs everything and checks it works. That's what I'd do.
Other ways to install (manual copy, extra plugins, which skills show up)
Which skills show up. With the plugin, the skills appear as /jstack:train, /jstack:train-compound, /jstack:train-queue, /jstack:optimize, /jstack:preflight, /jstack:unslop, /jstack:machine-memory, /jstack:grill-me, /jstack:grilling and /jstack:wayfinder, plus the skills wayfinder calls (research, prototype, domain-modeling, setup-matt-pocock-skills) and the 16 eng- domain packs. /simplify is already built into Claude Code.
Extra plugins from the same marketplace:
text
/plugin install unslop@jstack # /unslop:explain, /unslop:metrify, /unslop:retro
/plugin install jay-claude-switcher --marketplace jayjayholic/jstack # account switcher side panel
The hands-on way:
1. Clone it.
bash
git clone https://github.com/jayjayholic/jstack.git
2. Copy the tools somewhere that won't move, and make your config.
bash
mkdir -p ~/jstack-tools ~/.jstack && cp jstack/tools/ ~/jstack-tools/
cp ~/jstack-tools/config.example.sh ~/.jstack/config.sh # then edit it
3. Install the skills for Claude Code. This is user-wide; for a single project use /.claude/skills/ instead.
bash
mkdir -p ~/.claude/skills && cp -r jstack/skills/train jstack/skills/train-queue ~/.claude/skills/
cp -r jstack/skills/{grill-me,grilling,wayfinder,research,prototype,domain-modeling,setup-matt-pocock-skills} ~/.claude/skills/ # the planning ones, nothing to fill in
4. Fill the {{PLACEHOLDERS}} in the installed skill files (the table in ADAPT.md says what each one is). When grep -rn "{{" ~/.claude/skills/train ~/.claude/skills/train-queue prints nothing, you're done.
5. Paste worker-clause.md into every coding agent's prompt. /train hands orchestrator-brief.md to the one agent that runs trains.
6. Use the lock yourself too.
bash
source ~/jstack-tools/heavy-lock.sh
heavyacquire my-build; heavycapped "npm run build"; heavyrelease # anything heavy, under the RAM ceiling
serverwait 8 # before a server: no build running and 8 GB free
7. When two or more branches are ready, type /train.
Requirements: node on the PATH (the hooks and tools), bash (Git Bash on Windows). Builds aren't tied to Next.js; see the FAQ.