# session-orchestrator

> Loop engineering for AI coding agents. Turn ad-hoc sessions into a repeatable research, plan, wave-execute, close loop with verification gates. Runs on Claude Code, Codex CLI, Cursor, and Pi. MIT-licensed, local by default, no account.

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

Version: 4.0.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`

## Surface

<!-- census:start -->
Version 4.0.0 · counted 2026-09-07 at a4315993 · skills 43 · commands 25 · agents 14 · hooks 27 · test files 664 · sessions 289 · learnings 201 · npm downloads (30d) 1165 · GitHub stars 50
<!-- census:end -->

Generated by `node scripts/site-numbers.mjs --write`; the machine-readable receipt is /_census.json. Facts outside the census, measured 2026-09-06 at bc49301b: 18 ADRs, 26 always-on rule files, 14 destructive-command rules (10 blocking, 4 warning), and 26 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), root plugin.json (agent-plugins.org 1.0.0), and a .agents/skills/ mirror of every skill.

## 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