Session Orchestrator

Your coding agents get an agreed plan, a check after each round of changes and a handover to the next session.

A free, MIT-licensed workflow plugin for people running Claude Code, Codex CLI, Cursor IDE or Pi on a git repository. It runs on your machine and writes plain text into your repository: no account, no server.

Website (Deutsch) · Commands · User guide · Changelog

Beta: 15 free seats in the agenticbuilders Pass for Session Orchestrator users. You learn to get real work done with Claude Code and agents. In return you tell me for 14 days what helped. Want a seat? agenticbuilders.at/so

Install

You need Node.js 24 or later and a git repository. In Claude Code:

/plugin marketplace add Kanevry/session-orchestrator
/plugin install session-orchestrator@kanevry

Codex CLI, Cursor IDE, Pi, upgrade and uninstall: docs/install.md.

How it works

/session reads your repository, your open issues and the last session, proposes what to work on, and waits for your correction. Nothing changes in your code until you agree.
/go runs the agreed work in waves: rounds of parallel agents, each with its own list of files. Your tests and typecheck run after each wave; failures become fix tasks for the next one.
/close runs the full test, typecheck and lint gate, checks every planned item against what happened, commits, and files the rest as GitLab or GitHub issues.

Without it	With it
You paste your working rules into every session	`/session` reads git, issues and the last session first
Two agents edit the same file	Each agent gets a declared file list; overlaps are rejected
"Done" before the tests ran	Tests and typecheck run after each wave
A crash loses the plan	Progress is written down after each wave; the next `/session` offers to resume

First session

Run /bootstrap --fast --no-interview once in your project. It adds a short config block to your instruction file (CLAUDE.md or AGENTS.md).
Set the three gate commands in that block to what your project uses, for example test-command: npm test, typecheck-command: npm run typecheck, lint-command: npm run lint. Every other key is optional (reference).
Run /session feature and describe the task. Correct the proposed scope, then run /go and, when the work is done, /close.

On Codex and in headless Claude Code (claude -p) some command names differ: Codex · headless.

What do you want to do?

Situation	Type	You get
A new project idea	`/plan new`	Research, decisions, a PRD and issues (works out of the box; uses your baseline when configured)
A feature that is not clear yet	`/plan feature`	A bounded plan with acceptance criteria
A feature that is clear	`/session feature`, then `/go`, then `/close`	The agreed change, checked, committed, leftovers as issues
A big or unclear change	`/session deep`	It looks first, then builds
Tidy up	`/session housekeeping`	A short maintenance pass
Look back on a phase	`/plan retro`	What worked, what to change
The same mistakes keep coming back	`/evolve`, then `/reconcile`	Lessons you approve become rules

All 31 commands, by situation: session-orchestrator.com/commands

It learns, with your yes

/evolve suggests lessons from your own session records; /reconcile turns the ones you approve into rule files that later sessions load. It never trains a model and never changes itself without your approval (how it works).

Add-on: lead-session-orchestrator

Running three or four sessions side by side? lead-session-orchestrator adds one lead session above them that decides which one goes next and puts their questions into one queue for you. It is a separate npm package; details and caveats: docs/install.md.

User guide · Install · Components · Telemetry (off unless you turn it on) · Contributing · Security · Issues · MIT · Privacy · npm · All docs

Provided as-is: a community project with best-effort maintenance and no SLA. Independent, and not affiliated with or endorsed by Anthropic, OpenAI or Cursor. The method is taught at agenticbuilders.at; the plugin is free and does not need the courses.

Session Orchestrator