anegri93/flowrunner

Le pedís una feature a Claude Code y flowrunner la lleva sola hasta una PR lista para revisar. Vos
intervenís cuando aprobás el plan y cuando revisás la PR, y también si el run se traba: en vez de
reintentar a ciegas, se detiene y te pregunta qué hacer. Todo lo demás corre sin vos, en segundo plano,
y cada repo tiene un cerebro en .flowrunner/ que aprende de tus correcciones.
## Instalar
Una sola vez por máquina. Necesitás macOS, Node 24 o más nuevo, pnpm 10, git y Claude Code con tu
sesión abierta.
1. Instalá las herramientas que usa flowrunner y abrí sesión en GitHub:
bash
npm i -g pnpm@10 @nanonets/graft
bash
gh auth login
2. Cloná flowrunner en la carpeta que quieras e instalá sus dependencias:
bash
git clone https://github.com/anegri93/flowrunner.git
bash
cd flowrunner && pnpm install
3. Desde esa misma carpeta, dejá el comando flowrunner en tu PATH:
bash
ln -s "$PWD/bin/flowrunner.js" ~/.local/bin/flowrunner
Ese link es solo para arrancar. flowrunner init --aplicar deja el flowrunner que corre runs en
~/.flowrunner/app, un worktree de este repo en origin/main con sus propias dependencias, y apunta ahí
el comando, el job de launchd, la skill y el plugin de Orca. Para actualizarlo a lo último de main:
bash
flowrunner self-update
No actualiza con un run corriendo: los que esperan aprobación, detenidos o en cola siguen con el código
nuevo. El checkout que clonaste queda para desarrollar, y cambiar de rama ahí no afecta a ningún run.
flowrunner doctor avisa si el comando o el job de launchd apuntan a otro lado. self-update instala con
pnpm install --frozen-lockfile: pnpm tiene que estar en el PATH de quien lo corre.
### Si ya tenías una versión anterior
Antes de ~/.flowrunner/app, flowrunner corría desde el checkout. Para pasar a esta versión:
1. flowrunner status: esperá a que termine cualquier run que esté trabajando. Los que esperan
aprobación, detenidos o cerrados no molestan, y siguen con el código nuevo.
2. En el checkout:
bash
git switch main && git pull && pnpm install --frozen-lockfile
3. Instalá la app y apuntá todo ahí:
bash
node bin/flowrunner.js self-update
4. Si usás Orca, corré el orca plugin dev load … --approve … que imprime, tal cual.
5. flowrunner doctor tiene que dar «flowrunner corre desde ~/.flowrunner/app» en verde. Abrí una
sesión nueva de Claude Code para que tome la skill nueva.
Después de actualizar, no vuelvas a correr la versión anterior: no lee los runs que crea la nueva.
## Sumar un repo
Una vez por repo. El repo tiene que estar en GitHub y su rama base en verde. Si fija Node en .nvmrc o
.node-version, setup, agentes y verify corren con esa versión, instalada con nvm, fnm, volta o
Homebrew; si no está instalada, verify no corre y el run se detiene diciendo cómo instalarla.
1. Mirá qué hay y qué falta. No toca nada:
bash
flowrunner init ~/ruta/al/repo
2. Aplicalo. Registra el repo, instala la skill de Claude Code, el chequeo cada 10 minutos y el comando,
y abre una PR con el cerebro del repo en .flowrunner/:
bash
flowrunner init ~/ruta/al/repo --aplicar
3. En esa PR, revisá la config que infirió, con el setup, los tests, el lint y el formateador, y el borrador de contexto.md, convenciones.md y