Story pipeline

1. Download the runner

   Download runner zip

   Unzip it somewhere handy, for example your home folder: you get a story-runner folder. It needs Node 18 or newer (node -v); no npm install.

2. Fill in your config only once

   Open story-runner/runner/runner.config.json. The board address is already filled in; set:

   userName

   your name, shown with your uploads

   workspaceRoot

   the repository where you run the pipeline: the folder with .claude/skills/run-story-pipeline and userstories/

   boardToken

   only if your admin gave you one

   launch.command

   ["claude", "{prompt}"] for Claude Code, or ["cursor-agent", "{prompt}"] for Cursor

3. Start the runner

   Double-click start.command (the first time: right-click → Open), or in Terminal:

   cd ~/story-runner && node runner/runner.mjsCopy

   It says Story runner on http://127.0.0.1:4311. Leave that window open.

4. Done!

   The top bar shows Runner connected, and the pipeline commands open a terminal in your workspaceRoot. When the board gets a newer runner, the top bar says Runner update available: download the zip again and keep your runner.config.json.

Everyone runs their own runner, with their own workspace and name. The board runs once, for everybody.