<feed xmlns='http://www.w3.org/2005/Atom'>
<title>superpowers.git/hooks, branch fix/2391-opencode-compaction-bootstrap</title>
<subtitle>Agentic skills framework and development workflow
</subtitle>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/'/>
<entry>
<title>Merge pull request #2594 from obra/fix/2503-run-hook-no-bash</title>
<updated>2026-10-22T22:05:26+00:00</updated>
<author>
<name>Drew Ritter</name>
<email>drew@ritter.dev</email>
</author>
<published>2026-10-22T22:05:26+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=7e2e91942b26418f0e1bb506f952288f4187c70b'/>
<id>7e2e91942b26418f0e1bb506f952288f4187c70b</id>
<content type='text'>
fix(hooks): fall back to zsh, or exit quietly, when bash is missing on Unix (#2503)</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
fix(hooks): fall back to zsh, or exit quietly, when bash is missing on Unix (#2503)</pre>
</div>
</content>
</entry>
<entry>
<title>Merge pull request #2593 from obra/fix/2081-session-start-forks</title>
<updated>2026-10-22T22:04:15+00:00</updated>
<author>
<name>Drew Ritter</name>
<email>drew@ritter.dev</email>
</author>
<published>2026-10-22T22:04:15+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=4a2a185a37ddf186e79749b4a95b4f11242be882'/>
<id>4a2a185a37ddf186e79749b4a95b4f11242be882</id>
<content type='text'>
fix(hooks): start no child processes in the SessionStart hook (#2081)</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
fix(hooks): start no child processes in the SessionStart hook (#2081)</pre>
</div>
</content>
</entry>
<entry>
<title>fix(hooks): fall back to zsh, or exit quietly, when bash is missing on Unix (#2503)</title>
<updated>2026-10-22T21:19:08+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-10-22T21:19:08+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=3cbe5575758e409ac083c694cfc45ccfde50c0cd'/>
<id>3cbe5575758e409ac083c694cfc45ccfde50c0cd</id>
<content type='text'>
On a Unix system without bash, the harness can't honour shell:"bash" and
runs run-hook.cmd with zsh or sh. $BASH is unset there, so the wrapper's
exec "${BASH:-bash}" fails with "command not found: bash" (zsh) or
"exec: bash: not found" (sh), the hook exits 127, and the bootstrap is
lost on every session start.

Keep $BASH first, so the empty-PATH case from #2310 still works, then look
for bash on PATH, then zsh, which runs session-start unchanged (its output
is byte-identical to bash's, including for a SKILL.md full of backslashes,
quotes, tabs and CRs). With neither shell, exit 0 quietly, as the Windows
half already does.

Reproduced with Claude Code 2.1.308 in an alpine container with zsh and no
bash: the hook exited 127 and no bootstrap reached the model before the
change; after it the hook exits 0 and the bootstrap arrives.

Tests run the wrapper under real zsh and under a non-bash sh with a PATH
that holds only zsh, and under that sh with neither shell. They skip where
zsh is absent or sh is bash (Git Bash, macOS).

Co-authored-by: Twot &lt;twotnguyen@users.noreply.github.com&gt;
Claude-Session: https://claude.ai/code/session_01SHANcr4A71nzuU9et4Fnba
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
On a Unix system without bash, the harness can't honour shell:"bash" and
runs run-hook.cmd with zsh or sh. $BASH is unset there, so the wrapper's
exec "${BASH:-bash}" fails with "command not found: bash" (zsh) or
"exec: bash: not found" (sh), the hook exits 127, and the bootstrap is
lost on every session start.

Keep $BASH first, so the empty-PATH case from #2310 still works, then look
for bash on PATH, then zsh, which runs session-start unchanged (its output
is byte-identical to bash's, including for a SKILL.md full of backslashes,
quotes, tabs and CRs). With neither shell, exit 0 quietly, as the Windows
half already does.

Reproduced with Claude Code 2.1.308 in an alpine container with zsh and no
bash: the hook exited 127 and no bootstrap reached the model before the
change; after it the hook exits 0 and the bootstrap arrives.

Tests run the wrapper under real zsh and under a non-bash sh with a PATH
that holds only zsh, and under that sh with neither shell. They skip where
zsh is absent or sh is bash (Git Bash, macOS).

Co-authored-by: Twot &lt;twotnguyen@users.noreply.github.com&gt;
Claude-Session: https://claude.ai/code/session_01SHANcr4A71nzuU9et4Fnba
</pre>
</div>
</content>
</entry>
<entry>
<title>fix(hooks): start no child processes in the SessionStart hook (#2081)</title>
<updated>2026-10-22T21:16:09+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-10-22T21:16:09+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=328685babd94e11910516025dee12e32a6d49de1'/>
<id>328685babd94e11910516025dee12e32a6d49de1</id>
<content type='text'>
On Windows, Git Bash emulates fork(), so every command substitution and
pipe costs tens of milliseconds. The SessionStart hook runs on every
startup, /clear and compaction, and on dev it forked six times: the
$(cd ... &amp;&amp; pwd) in run-hook.cmd and twice in session-start,
$(escape_for_json ...), and printf | cat.

Resolve paths with parameter expansion, read the skill with the read
builtin, have escape_for_json assign a variable, and absorb EPIPE with
trap '' PIPE plus printf 2&gt;/dev/null || true instead of piping through
cat. The cat pipe also turned an early-closed stdout into exit 141 under
pipefail; the new emit_json exits 0 there.

Measured on Windows 11 (VM, Git Bash 5.2), 21 interleaved runs of
run-hook.cmd session-start: median 116 ms before, 46 ms after, against a
25 ms floor for one bash start (the wrapper starts two). Claude Code
2.1.308 logged the hook at 181-421 ms before and 137-146 ms after. Output
is byte-identical to dev across all five output shapes, two working
directories, normal and empty PATH, direct and through the wrapper (40/40
on Linux), and its sha256 matches on Windows.

Tests: the cat-stub case, which asserted the pipe, is replaced by a
closed-stdout case, and a new case counts process creations with strace
on Linux (5 in session-start and 6 through the wrapper on dev, 0 after).

Co-authored-by: willow &lt;willowite@users.noreply.github.com&gt;
Claude-Session: https://claude.ai/code/session_01SHANcr4A71nzuU9et4Fnba
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
On Windows, Git Bash emulates fork(), so every command substitution and
pipe costs tens of milliseconds. The SessionStart hook runs on every
startup, /clear and compaction, and on dev it forked six times: the
$(cd ... &amp;&amp; pwd) in run-hook.cmd and twice in session-start,
$(escape_for_json ...), and printf | cat.

Resolve paths with parameter expansion, read the skill with the read
builtin, have escape_for_json assign a variable, and absorb EPIPE with
trap '' PIPE plus printf 2&gt;/dev/null || true instead of piping through
cat. The cat pipe also turned an early-closed stdout into exit 141 under
pipefail; the new emit_json exits 0 there.

Measured on Windows 11 (VM, Git Bash 5.2), 21 interleaved runs of
run-hook.cmd session-start: median 116 ms before, 46 ms after, against a
25 ms floor for one bash start (the wrapper starts two). Claude Code
2.1.308 logged the hook at 181-421 ms before and 137-146 ms after. Output
is byte-identical to dev across all five output shapes, two working
directories, normal and empty PATH, direct and through the wrapper (40/40
on Linux), and its sha256 matches on Windows.

Tests: the cat-stub case, which asserted the pipe, is replaced by a
closed-stdout case, and a new case counts process creations with strace
on Linux (5 in session-start and 6 through the wrapper on dev, 0 after).

Co-authored-by: willow &lt;willowite@users.noreply.github.com&gt;
Claude-Session: https://claude.ai/code/session_01SHANcr4A71nzuU9et4Fnba
</pre>
</div>
</content>
</entry>
<entry>
<title>fix(hooks): add a powershell form of the SessionStart command for Copilot on Windows (#2189)</title>
<updated>2026-10-22T20:56:46+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-10-22T20:56:46+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=0a4d60db4faf3628abc3e6be4fc3e1a0697c69de'/>
<id>0a4d60db4faf3628abc3e6be4fc3e1a0697c69de</id>
<content type='text'>
GitHub Copilot on Windows (Copilot CLI and VS Code Copilot) runs a hook's
command through PowerShell and ignores shell:"bash". PowerShell parses
"&lt;root&gt;/hooks/run-hook.cmd" session-start as a string expression followed
by a bareword, fails with "Unexpected token 'session-start'", and the
using-superpowers bootstrap never reaches the session.

Copilot prefers a hook's powershell key over command when it is present, so
add one that runs the same wrapper with the &amp; call operator. Claude Code
ignores the key and keeps dispatching command through Git Bash.

Verified on Windows 11 in a VM: Copilot CLI 1.0.103 logged the ParserError
and sent no bootstrap before the change, and ran the hook and sent the
bootstrap after it. Claude Code 2.1.308 ran the hook and sent the bootstrap
both before and after.

The new test in test-run-hook-cmd-windows.sh runs the hooks.json powershell
value through powershell.exe against a plugin root with a space in its path.

Co-authored-by: Tugrul Guner &lt;tugrulguner@users.noreply.github.com&gt;
Co-authored-by: Serge ARADJ &lt;orty@users.noreply.github.com&gt;
Claude-Session: https://claude.ai/code/session_01SHANcr4A71nzuU9et4Fnba
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
GitHub Copilot on Windows (Copilot CLI and VS Code Copilot) runs a hook's
command through PowerShell and ignores shell:"bash". PowerShell parses
"&lt;root&gt;/hooks/run-hook.cmd" session-start as a string expression followed
by a bareword, fails with "Unexpected token 'session-start'", and the
using-superpowers bootstrap never reaches the session.

Copilot prefers a hook's powershell key over command when it is present, so
add one that runs the same wrapper with the &amp; call operator. Claude Code
ignores the key and keeps dispatching command through Git Bash.

Verified on Windows 11 in a VM: Copilot CLI 1.0.103 logged the ParserError
and sent no bootstrap before the change, and ran the hook and sent the
bootstrap after it. Claude Code 2.1.308 ran the hook and sent the bootstrap
both before and after.

The new test in test-run-hook-cmd-windows.sh runs the hooks.json powershell
value through powershell.exe against a plugin root with a space in its path.

Co-authored-by: Tugrul Guner &lt;tugrulguner@users.noreply.github.com&gt;
Co-authored-by: Serge ARADJ &lt;orty@users.noreply.github.com&gt;
Claude-Session: https://claude.ai/code/session_01SHANcr4A71nzuU9et4Fnba
</pre>
</div>
</content>
</entry>
<entry>
<title>fix(hooks): run-hook.cmd finds per-user Git, skips WSL launchers and the current directory, keeps exit codes (#2393)</title>
<updated>2026-09-26T20:14:36+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@primeradiant.com</email>
</author>
<published>2026-09-26T20:14:36+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=35ce9493c912e8981cb5b76ffa7ceba5aed74530'/>
<id>35ce9493c912e8981cb5b76ffa7ceba5aed74530</id>
<content type='text'>
Combines and supersedes #1864 and #2365. Fixes #1863.

Co-authored-by: citizen204 &lt;161211652+citizen204@users.noreply.github.com&gt;
Co-authored-by: KaiyiQuan &lt;156817180+KaiyiQuan@users.noreply.github.com&gt;</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Combines and supersedes #1864 and #2365. Fixes #1863.

Co-authored-by: citizen204 &lt;161211652+citizen204@users.noreply.github.com&gt;
Co-authored-by: KaiyiQuan &lt;156817180+KaiyiQuan@users.noreply.github.com&gt;</pre>
</div>
</content>
</entry>
<entry>
<title>fix(hooks): make SessionStart hooks resolve without external PATH lookups (#2349)</title>
<updated>2026-09-26T19:48:28+00:00</updated>
<author>
<name>ada-sen</name>
<email>ada.sen@primeradiant.com</email>
</author>
<published>2026-09-26T19:48:28+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=0a8cefe3e3db5c9abd9ebe11b836b829baad1466'/>
<id>0a8cefe3e3db5c9abd9ebe11b836b829baad1466</id>
<content type='text'>
* fix(hooks): make SessionStart hooks resolve without external PATH lookups

SessionStart:startup hooks can run before Claude Code's PATH is repaired
(anthropics/claude-code#43127), or ahead of a sibling PATH-fixing hook in
the same startup batch. hooks/session-start and the Unix half of
hooks/run-hook.cmd both shelled out to dirname, cat, and a PATH lookup for
bash itself, so an empty PATH made every SessionStart hook fail outright:

  hooks/session-start: line 7: dirname: command not found
  hooks/session-start: line 44: cat: command not found

None of those external calls are necessary:
- ${0%/*} replaces $(dirname "$0") for both scripts.
- ${BASH:-bash} replaces a bare 'bash' in run-hook.cmd's exec — bash always
  sets $BASH to its own absolute path once running, so no PATH lookup is
  needed to re-invoke it.
- $(&lt;file) (a bash builtin) replaces 'cat file' for reading the skill body.
- The trailing '| cat' after each printf branch was a no-op pass-through
  through another external binary; removed.

Adds a regression test in tests/hooks/test-session-start.sh that invokes
both hooks under an empty PATH.

Fixes #2310.

* Split $0 on / or \ so cmd-dispatched hooks find the plugin root

run-hook.cmd's Windows half starts bash with a backslash path
(C:\...\hooks\session-start). ${0%/*} found no slash there, so
session-start resolved the wrong plugin root and injected 'Error
reading using-superpowers skill' instead of the skill. MSYS dirname
handled backslashes, so dev was fine. Seen on Windows 11 + Git Bash
5.2.37 via cmd /c run-hook.cmd session-start.

---------

Co-authored-by: Jesse Vincent &lt;jesse@primeradiant.com&gt;</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
* fix(hooks): make SessionStart hooks resolve without external PATH lookups

SessionStart:startup hooks can run before Claude Code's PATH is repaired
(anthropics/claude-code#43127), or ahead of a sibling PATH-fixing hook in
the same startup batch. hooks/session-start and the Unix half of
hooks/run-hook.cmd both shelled out to dirname, cat, and a PATH lookup for
bash itself, so an empty PATH made every SessionStart hook fail outright:

  hooks/session-start: line 7: dirname: command not found
  hooks/session-start: line 44: cat: command not found

None of those external calls are necessary:
- ${0%/*} replaces $(dirname "$0") for both scripts.
- ${BASH:-bash} replaces a bare 'bash' in run-hook.cmd's exec — bash always
  sets $BASH to its own absolute path once running, so no PATH lookup is
  needed to re-invoke it.
- $(&lt;file) (a bash builtin) replaces 'cat file' for reading the skill body.
- The trailing '| cat' after each printf branch was a no-op pass-through
  through another external binary; removed.

Adds a regression test in tests/hooks/test-session-start.sh that invokes
both hooks under an empty PATH.

Fixes #2310.

* Split $0 on / or \ so cmd-dispatched hooks find the plugin root

run-hook.cmd's Windows half starts bash with a backslash path
(C:\...\hooks\session-start). ${0%/*} found no slash there, so
session-start resolved the wrong plugin root and injected 'Error
reading using-superpowers skill' instead of the skill. MSYS dirname
handled backslashes, so dev was fine. Seen on Windows 11 + Git Bash
5.2.37 via cmd /c run-hook.cmd session-start.

---------

Co-authored-by: Jesse Vincent &lt;jesse@primeradiant.com&gt;</pre>
</div>
</content>
</entry>
<entry>
<title>Explain why session-start pipes printf through cat</title>
<updated>2026-09-26T19:11:21+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@primeradiant.com</email>
</author>
<published>2026-09-26T19:11:21+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=f5f695329400a98ad3db7d5e6c5878da4c2091ee'/>
<id>f5f695329400a98ad3db7d5e6c5878da4c2091ee</id>
<content type='text'>
Three open PRs (#2115, #2349, #2367) removed the | cat pipes as
no-op subprocess spawns, which would bring back the Windows EPIPE
diagnostic fixed in d72560e (#1612). Say so next to the code.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Three open PRs (#2115, #2349, #2367) removed the | cat pipes as
no-op subprocess spawns, which would bring back the Windows EPIPE
diagnostic fixed in d72560e (#1612). Say so next to the code.
</pre>
</div>
</content>
</entry>
<entry>
<title>fix: Muse SessionStart hook must use nested hookSpecificOutput</title>
<updated>2026-09-17T23:22:05+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-09-17T23:22:05+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=abf67452f89434916a35b2a26530bfb446ad5ac5'/>
<id>abf67452f89434916a35b2a26530bfb446ad5ac5</id>
<content type='text'>
muse-spark-1.3-contributor rejects top-level additionalContext on
SessionStart ("unsupported additionalContext in output"). Switch Muse
branch to Claude-style nested {hookSpecificOutput:{hookEventName,
additionalContext}} which validates and injects correctly (tested via
muse exec --provider meta hello world -&gt; success, no hook failed).

Co-Authored-By: Muse Spark
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
muse-spark-1.3-contributor rejects top-level additionalContext on
SessionStart ("unsupported additionalContext in output"). Switch Muse
branch to Claude-style nested {hookSpecificOutput:{hookEventName,
additionalContext}} which validates and injects correctly (tested via
muse exec --provider meta hello world -&gt; success, no hook failed).

Co-Authored-By: Muse Spark
</pre>
</div>
</content>
</entry>
<entry>
<title>feat: add native Muse support (multiprovider)</title>
<updated>2026-09-17T22:55:44+00:00</updated>
<author>
<name>Jesse Vincent</name>
<email>jesse@fsck.com</email>
</author>
<published>2026-09-17T22:55:44+00:00</published>
<link rel='alternate' type='text/html' href='https://git.1991861.xyz/superpowers.git/commit/?id=d2112a41561b4af9b6b75c0ae9de8b90ea5e9898'/>
<id>d2112a41561b4af9b6b75c0ae9de8b90ea5e9898</id>
<content type='text'>
Add .muse-plugin/plugin.json (native Muse contract, 16 skills,
SessionStart hook) and marketplace.json so the same repo now serves
Muse alongside Claude Code, Codex, Cursor, Gemini, Pi, etc.

- skills/using-superpowers/references/muse-tools.md: Muse tool mapping
- skills/using-superpowers/SKILL.md: list Muse in Platform Adaptation
- hooks/session-start: handle MUSE_PLUGIN_ROOT (SDK standard
  additionalContext) alongside CURSOR/CLAUDE/COPILOT branches
- .version-bump.json: track .muse-plugin/plugin.json and marketplace
- README.md: add Muse to TOC and Installation with muse plugins install
  instructions
- AGENTS.md: convert symlink -&gt; regular file copy to satisfy Muse
  validator (symlink entries rejected as installable)

Validated: muse plugins validate =&gt; valid:true (diagnostics=1 for
expected multiple-manifests warning), all 16 skills validate true.

Co-Authored-By: Muse Spark
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Add .muse-plugin/plugin.json (native Muse contract, 16 skills,
SessionStart hook) and marketplace.json so the same repo now serves
Muse alongside Claude Code, Codex, Cursor, Gemini, Pi, etc.

- skills/using-superpowers/references/muse-tools.md: Muse tool mapping
- skills/using-superpowers/SKILL.md: list Muse in Platform Adaptation
- hooks/session-start: handle MUSE_PLUGIN_ROOT (SDK standard
  additionalContext) alongside CURSOR/CLAUDE/COPILOT branches
- .version-bump.json: track .muse-plugin/plugin.json and marketplace
- README.md: add Muse to TOC and Installation with muse plugins install
  instructions
- AGENTS.md: convert symlink -&gt; regular file copy to satisfy Muse
  validator (symlink entries rejected as installable)

Validated: muse plugins validate =&gt; valid:true (diagnostics=1 for
expected multiple-manifests warning), all 16 skills validate true.

Co-Authored-By: Muse Spark
</pre>
</div>
</content>
</entry>
</feed>
