You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
-1Lines changed: 0 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -78,7 +78,6 @@ Third-party plugins built by the community. [PRs welcome](#contributing)!
78
78
<!-- pinned -->
79
79
-[Registry Broker](https://github.com/hashgraph-online/registry-broker-codex-plugin) - Delegate tasks to specialist AI agents via the HOL Registry, plan, find, summon, and recover sessions.
80
80
-[AgentOps](https://github.com/boshu2/agentops) - DevOps layer for coding agents with flow, feedback, and memory that compounds between sessions.
81
-
-[Blueprint](https://github.com/JuliusBrussee/blueprint) - Specification-driven development pipeline that turns natural language into domain blueprints with testable acceptance criteria, generates parallel build plans, and implements them with automated validation and cross-model adversarial review.
82
81
-[Brooks Lint](https://github.com/hyhmrright/brooks-lint) - AI code reviews grounded in six classic engineering books — decay risk diagnostics with book citations, severity labels, and four analysis modes (PR review, architecture audit, tech debt, test quality).
83
82
-[Claude Code for Codex](https://github.com/sendbird/cc-plugin-codex) - Reverse of OpenAI's official Claude-hosted plugin: use Claude Code from Codex for reviews, rescue tasks, tracked background jobs, and hook-powered review gates.
84
83
-[Claude Code Harness](https://github.com/dadwadw233/claude-code-harness) - Harness blueprint skill for turning vague agent ideas into concrete designs for request assembly, control loops, memory, permissions, recovery, and extension planes.
"description": "Specification-driven development pipeline that turns natural language into domain blueprints with testable acceptance criteria, generates parallel build plans, and implements them with automated validation and cross-model adversarial review.",
"description": "Read-only meta-skill that scans your MCP servers, skills, plugins, and CLI tools, then suggests up to three ranked approaches (Methodical / Fast / Deep) with a copy-paste Quick Action table.",
"description": "Decentralized e-commerce skills — deploy self-hosted stores, import products from Shopify/Amazon, configure custom domains and Telegram bots, set up Tor privacy, and manage your store via MCP.",
@@ -12,6 +12,8 @@ Session orchestration plugin for Claude Code, Codex, and Cursor IDE. Covers proj
12
12
13
13
## Install
14
14
15
+
> **Prerequisite:** Node.js 20 or later. Check with `node --version`. v3.x runs as ES modules and requires a real Node runtime (no Bash shim). [Install Node.js](https://nodejs.org/).
16
+
15
17
### Claude Code
16
18
17
19
Run these two slash commands **inside** Claude Code (they are not shell commands; there is no `claude plugin` CLI):
@@ -21,7 +23,14 @@ Run these two slash commands **inside** Claude Code (they are not shell commands
21
23
/plugin install session-orchestrator@kanevry
22
24
```
23
25
24
-
The first command registers this repository as a marketplace (named `kanevry`), the second installs the plugin from it. Reload Claude Code so the slash commands (`/session`, `/go`, `/close`, …) become available.
26
+
Then install Node dependencies **once** (hooks import `zx`):
27
+
28
+
```bash
29
+
cd"$(claude plugin dir session-orchestrator 2>/dev/null ||echo~/.claude/plugins/session-orchestrator)"
30
+
npm install
31
+
```
32
+
33
+
Restart Claude Code so the slash commands (`/session`, `/go`, `/close`, …) become available.
25
34
26
35
Prefer installing from a local clone? Use an absolute path instead of the `owner/repo` shorthand:
27
36
@@ -34,17 +43,21 @@ Prefer installing from a local clone? Use an absolute path instead of the `owner
All platforms share the same skills, commands, hooks, and scripts. Platform-specific adaptations are handled automatically via `scripts/lib/platform.sh`. See setup guides: [Codex](docs/codex-setup.md) | [Cursor IDE](docs/cursor-setup.md).
115
+
Windows support is **native** as of v3.0.0 — no WSL, no Git-Bash, no msys. All file paths use `path.join`, all tmp paths use `os.tmpdir()`, and CI verifies on `windows-latest` alongside `ubuntu-latest` and `macos-latest`.
116
+
117
+
All platforms share the same skills, commands, hooks, and scripts. Platform-specific adaptations are handled automatically via `scripts/lib/platform.mjs`. See setup guides: [Codex](docs/codex-setup.md) | [Cursor IDE](docs/cursor-setup.md).
118
+
119
+
## Troubleshooting
120
+
121
+
### Hooks silently no-op after install
122
+
123
+
Most common cause on any OS: `npm install` was not run in the plugin directory, so `zx` is missing. Run it and restart your editor. Verify with `ls node_modules/zx` in the plugin root.
124
+
125
+
### Windows: `Cannot use import statement outside a module` or `node` not found
126
+
127
+
`node` must be on the editor's `PATH`. If you installed Node via nvm-windows or fnm, relaunch the editor from a shell where `node --version` prints `v20.x` or later. In Claude Code you can sanity-check with `!node --version`.
128
+
129
+
### Windows: CRLF breaks shell scripts / hooks after upgrade
130
+
131
+
v3 ships `.gitattributes` with explicit LF rules for `.sh`, `.mjs`, `.md`, `.json`, and `.yaml`. Clones from before v3 may still have CRLF endings in tracked files. Normalize once:
132
+
133
+
```bash
134
+
git config core.autocrlf false
135
+
git rm --cached -r .
136
+
git reset --hard
137
+
```
138
+
139
+
Back up any uncommitted work first.
140
+
141
+
### macOS / Linux: `Permission denied` on a hook
142
+
143
+
v3 hooks are `.mjs` files invoked via `node <path>` — the executable bit is not required. If your editor reports `Permission denied`, it is still pointing at a stale `.sh` path. Re-run the platform install script (`scripts/codex-install.sh`, `scripts/cursor-install.sh`) or re-add the plugin in Claude Code.
144
+
145
+
### `SyntaxError` in hooks
146
+
147
+
Confirm Node version (`node --version` must be `v20.x+`) and that `package.json` has `"type": "module"`. Both are required for ESM imports.
148
+
149
+
### `npm install` fails with `ERESOLVE`
150
+
151
+
Use Node 20 or 22 LTS. If the error persists: `npm install --legacy-peer-deps`. Open an issue if it still fails.
152
+
153
+
For a longer walkthrough including rollback, see [docs/migration-v3.md](docs/migration-v3.md).
100
154
101
155
## Why Session Orchestrator
102
156
@@ -310,11 +364,33 @@ Superpowers handles the **task layer** (TDD, debugging, brainstorming per featur
310
364
-**Output Styles**: 3 styles (session-report, wave-summary, finding-report) for consistent reporting
-`npm run lint` / `npm run lint:fix` — ESLint v9 + Prettier
383
+
-`npm run typecheck` — `node --check` on every `.mjs` file (syntactic-only; no TypeScript yet)
384
+
385
+
The legacy `bats` shell suite (`scripts/test/run-all.sh`) is retained for historical reference but is **deprecated** and will be removed in a future release. Do not add new tests there — use `tests/**/*.test.mjs` under vitest.
386
+
387
+
For contributor-facing architecture, hook authoring, and the `zx`-vs-stdlib heuristic, see [docs/plugin-architecture-v3.md](docs/plugin-architecture-v3.md).
0 commit comments