llms.txt@site git:20260909.9e6164cA

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

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

<!-- census:start -->
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
<!-- 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), .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