llms.txt@site git:20261005.2b0b1bfA

Immutable. This exact content never changes and is served at /api/v1/blob/efd8e75dbfe21021.

# session-orchestrator

> Your coding agents get an agreed plan, a check after each round of changes and a handover to the next session. Session Orchestrator is an open-source workflow plugin for Claude Code, Codex CLI, Cursor and Pi. MIT-licensed, local by default, no plugin account.

German landing page: https://session-orchestrator.com/de

Version: 5.8.0 · npm: session-orchestrator · requires Node.js >= 24 (package.json engines) · Codex CLI >= 0.144.4; no minimum pinned for Claude Code, Cursor, or Pi

## Pages

- / (English)
- /de (German)
- /guide
- /impressum
- /datenschutz
- /llms-full.txt

## Install

- Claude Code: `/plugin marketplace add Kanevry/session-orchestrator` then `/plugin install session-orchestrator@kanevry` (afterwards run `npm install` once inside the plugin directory and restart Claude Code)
- Upgrade: `/plugin update session-orchestrator@kanevry`, then restart. Session-start warns when the RUNNING copy is behind the published npm version, and stays silent rather than claiming "up to date" when it cannot tell.
- Uninstall: remove the plugin through the harness's own plugin manager. `.orchestrator/` (bootstrap.lock, metrics JSONL, policy, steering), `STATE.md`, and the `## Session Config` block stay behind in the user's repo and are deleted by hand.
- Codex CLI: `git clone https://github.com/Kanevry/session-orchestrator.git ~/Projects/session-orchestrator && cd ~/Projects/session-orchestrator && npm install && node scripts/codex-install.mjs`
- Cursor IDE: same clone, then `node scripts/cursor-install.mjs /path/to/your/project`
- Pi: `pi install npm:session-orchestrator`
- Codex usage: select `$session-orchestrator:bootstrap` once per project, then `$session-orchestrator:session feature`, `$session-orchestrator:go`, and `$session-orchestrator:close` in the skill picker or a message. Requires a fresh task after plugin installation; review hooks through `/hooks`.
- Codex refresh: a Git marketplace uses `codex plugin marketplace upgrade kanevry` then `codex plugin add session-orchestrator@kanevry`; a local clone uses `git pull`, `npm install`, and `node scripts/codex-install.mjs`. Start a fresh task afterwards.

## What you get

- Know what to work on: /session reads git, open issues, recent commits and the last session record, recommends one scope and waits for your correction. /plan, /brainstorm and /grill help while an idea is still vague.
- Errors stop at the next check: /go checks each implementation wave with your tests and typecheck and turns failures into fix tasks for the next wave; the full test, typecheck and lint gate runs after the Quality wave and before /close commits; /close checks every planned item against what happened; /debug looks for the root cause before a fix.
- Agents keep to their files: declared per-agent file scopes are checked for overlap before dispatch; a destructive-command guard blocks 12 command patterns and warns on 4 (hooks on Claude Code, bridges on Cursor and Pi, instructions only on Codex).
- Pick up where you stopped: STATE.md records each finished wave so the next /session offers to resume; a heartbeat session lock keeps two sessions from colliding in one checkout; /close files unfinished work as GitLab or GitHub issues.
- It improves with your sessions: every session appends a record; /evolve proposes learnings with confidence scores, /reconcile drafts rules from them, and the operator approves or deletes each one. Optional mirror into a Markdown notes vault.
- Audit, test and review on demand: a discovery scan at /close turns confirmed findings into issues; /test drives web and macOS flows end to end; /ux-grill audits a running web app (accessibility, target size, overflow); /test-audit removes tests that catch nothing; /repo-audit and /harness-audit score a repository against a checklist; /persona-panel has several reviewer personas read the same output in parallel.
- Longer runs: /autopilot chains sessions and stops on any of 10 kill-switches; /dispatcher recommends the next free repository and claims it once you confirm; /portfolio summarises issues, MRs and CI across the repositories registered in your notes vault.

## Plan, Go, Close

Read the repository and agree the scope. Assign independent work, combine the changes and verify the result. Close with evidence and a record of unfinished work. The shape depends on the session type: housekeeping uses one wave, a feature three, deep five, the ultradeep profile seven. Parallel execution is available on Claude Code and Codex; Cursor and Pi execute sequentially. The landing page illustrates this with a CSV-export example, not a live session report.

## Platform limits and data

Claude Code runs guard hooks directly. Cursor and Pi use bridges with documented event limits and execute tasks sequentially. Codex CLI offers selectable workflow skills and parallel agents, but its destructive-command and file-scope rules are instructions only; the plugin does not enforce either guard there. With an active compatible scope hook on Claude Code, Cursor or Pi, strict blocks supported out-of-scope edits, warn reports them without denial, and off disables scope checking. The separate destructive-command policy defines 12 blocking and 4 warning rules; an active compatible hook is required to apply them.

macOS and Linux are covered by CI. Native Windows use is untested; shell hooks and the optional MCP server need WSL or Git Bash.

Optional telemetry is off until consent. By default, session-start checks the npm registry for updates. Successful results are cached for 24 hours per repository; a failed request or cache write may cause another request at the next session. SO_DISABLE_UPDATE_CHECK=1 or DO_NOT_TRACK=1 disables the check. The coding tool and configured VCS services use their own network connections. The website uses cookieless Vercel Web Analytics; see https://session-orchestrator.com/datenschutz.

## Surface

<!-- census:start -->
Version 5.8.0 · counted 2026-10-05 at 190fe1c0 · skills 51 · commands 30 · agents 14 · hooks 29 · test files 733 · sessions 437 · learnings 269 · npm downloads (30d) 3241 · GitHub stars 53
<!-- census:end -->

Generated by `node scripts/site-numbers.mjs --write`; the machine-readable receipt is /_census.json. Facts outside the census, measured 2026-10-03 at d1af261a: 19 ADRs, 25 rule files under .claude/rules/, 16 destructive-command policy rules (12 marked blocking, 4 marked warning; applied only by a compatible active hook), and 28 of the hook files plugin-wired across 10 event types. Also ships a portable cross-harness surface: root AGENTS.md (byte-identical generated copy of CLAUDE.md), .cursor-plugin/plugin.json (agent-plugins.org 1.0.0), and a .agents/skills/ mirror of every skill.

Repository session records describe development activity, not active users. Download counts include automated requests.

## Links

- Source, docs, issues: https://github.com/Kanevry/session-orchestrator
- Eval standard (aiat-llm-eval v1): https://github.com/Kanevry/session-orchestrator/blob/main/docs/eval/aiat-llm-eval-v1.md
- Full description for LLMs: https://session-orchestrator.com/llms-full.txt

- Optional support: https://paypal.me/Kanevry