git:20260907.3f60844 to git:20260909.9e6164c

13 added, 3 removed. Audit A to A.

# 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

+ Version: 4.2.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.

+ ## Platform limits and data

+ Claude Code supports the full hook workflow. Codex CLI has selectable workflow skills and parallel agents, but no file-scope enforcement. Cursor bridges pre-tool and pre-shell checks plus post-edit checks. Pi uses a tool-call bridge. Cursor and Pi execute tasks sequentially. Scope blocking requires strict enforcement on a supported tool; warn mode reports violations.

+ 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

- 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

+ Version 4.2.0 · counted 2026-09-09 at 6e15686a · skills 43 · commands 25 · agents 14 · hooks 27 · test files 664 · sessions 297 · learnings 213 · npm downloads (30d) 1237 · GitHub stars 50

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

+ 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), .cursor-plugin/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