summaryrefslogtreecommitdiff
AgeCommit message (Collapse)Author
2026-03-15docs: use OPENCODE_CONFIG_DIR in install docsopencode-config-dir-docsjesse
Set the variable once at the top of each shell block with a default fallback, then use it cleanly throughout. Supports custom config directories without repeating the alternation on every line. Based on cavanaug's work in PR #704. Co-Authored-By: John Cavanaugh <cavanaug@users.noreply.github.com> Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-15fix: stop firing SessionStart hook on --resumejesse
Resumed sessions already have injected context in their conversation history. Re-firing the hook was redundant and could cause issues. The hook now fires only on startup, clear, and compact. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11Release v5.0.2: add release notes and bump marketplace versionv5.0.2Jesse Vincent
2026-03-11Release v5.0.2: Subagent context isolation, zero-dep brainstorm serverJesse Vincent
Subagent Context Isolation: All delegation skills (brainstorming, parallel agents, code review, subagent-driven development, writing plans) now explicitly instruct the dispatching agent to construct review context from scratch — never forward session history to subagents. This fixes a problem observed with Codex, where subagents inherited the full parent session context including the dispatcher's internal reasoning, prior conversation, and user-facing tone. Reviewers that inherited this context behaved as if they were the lead developer rather than a reviewer — they'd reject reasonable code for not matching unstated preferences, demand rewrites beyond scope, and treat advisory feedback as blocking. The fix is simple: the dispatcher crafts precisely what each subagent needs (the spec, the code, the review criteria) and nothing else. This keeps reviewers focused on the work product, not the thought process that produced it, and also preserves the dispatcher's own context window for coordination. Zero-Dependency Brainstorm Server: The brainstorm visual companion server has been rewritten from scratch as a single zero-dependency Node.js file. The previous implementation vendored Express, ws, chokidar, and 714 npm packages (84,000+ lines of third-party code) — a supply chain surface area that was disproportionate to what the server actually does. The new server.js (~340 lines) implements everything with Node built-ins only: RFC 6455 WebSocket protocol, HTTP server with template wrapping, fs.watch with debounce, and lifecycle management. 731 files changed, 1,700 insertions, 85,000 deletions. The entire vendored node_modules/ directory is gone. Server Lifecycle Management: The brainstorm server now automatically shuts down when no longer needed, preventing orphaned processes. Owner process tracking captures the harness PID at startup and checks every 60 seconds. 30-minute idle timeout as fallback. The visual companion guide now instructs agents to check .server-info before each write and restart if .server-stopped exists. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11Add context isolation principle to all delegation skillsJesse Vincent
Subagents should never inherit the parent session's context or history. The dispatcher constructs exactly what each subagent needs, keeping both sides focused: the subagent on its task, the controller on coordination. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11Fix owner PID tracking: resolve grandparent to get actual harness PIDJesse Vincent
$PPID inside start-server.sh is the ephemeral shell the harness spawns to run the script — it dies immediately when the script exits, causing the server to shut down after ~60s. Now resolves grandparent PID via `ps -o ppid= -p $PPID` to get the actual harness process (e.g. claude). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11Exit server when owner process dies (harness-agnostic cleanup)Jesse Vincent
start-server.sh passes $PPID as BRAINSTORM_OWNER_PID to the server. The server checks every 60s if the owner process is still alive (kill -0). If it's gone, the server shuts down immediately — deletes .server-info, writes .server-stopped, exits cleanly. Works across all harnesses (CC, Codex, Gemini CLI) since it tracks the shell process that launched the script, which dies when the harness dies. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11Auto-exit server after 30 minutes idle, add liveness check to skillJesse Vincent
Server tracks activity (HTTP requests, WebSocket messages, file changes) and exits after 30 minutes of inactivity. On exit, deletes .server-info and writes .server-stopped with reason. Visual companion guide now instructs agents to check .server-info before each screen push and restart if needed. Works on all harnesses, not just CC. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11(fix): declare encoding meta on viz brainstorm server pagesDrew Ritter
2026-03-11Remove vendored node_modules, swap to zero-dep server.jsJesse Vincent
Delete 717 files: index.js, package.json, package-lock.json, and the entire node_modules directory (express, ws, chokidar + deps). Update start-server.sh to use server.js. Remove gitignore exception. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11Add HTTP server, WebSocket handling, and file watching to server.jsJesse Vincent
Complete zero-dep brainstorm server. Uses knownFiles set to distinguish new screens from updates (macOS fs.watch reports 'rename' for both). All 56 tests pass (31 unit + 25 integration). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11Add WebSocket protocol layer for zero-dep brainstorm serverJesse Vincent
Implements RFC 6455 handshake, frame encoding/decoding for text frames. All 31 unit tests pass. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11Add implementation plan for zero-dep brainstorm serverJesse Vincent
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11Add design spec and tests for zero-dep brainstorm serverJesse Vincent
Replace vendored node_modules (714 files) with a single server.js using only Node built-ins. Spec covers WebSocket protocol, HTTP serving, file watching, and static file serving. Tests written before implementation (TDD). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10Release v5.0.1: Windows/Linux hooks fix, Gemini CLI, spec review loopv5.0.1Jesse Vincent
Bug fixes: - Fix single quotes breaking SessionStart hook on Windows/Linux (#577, #529, #644) - Add spec review loop to brainstorming checklist and flow diagram (#677) - Fix Cursor install command in README (#676) New features: - Gemini CLI extension support - Brainstorm server dependencies bundled for zero-npm-install experience Improvements: - OpenCode tool mapping fix (TodoWrite) - Multi-platform brainstorm server launch
2026-03-10Merge PR #676: fix Cursor install command in READMEJesse Vincent
The correct Cursor slash command is /add-plugin, not /plugin-add. Confirmed via the Cursor 2.5 release announcement.
2026-03-10Fix brainstorming skill: add spec review loop to checklist and flow diagramJesse Vincent
The spec review loop (dispatch spec-document-reviewer subagent, iterate until approved) existed in the prose "After the Design" section but was missing from both the checklist and the process flow diagram. Since agents follow the diagram and checklist more reliably than prose, the spec review step was being skipped entirely. Added step 7 (spec review loop) to the checklist and a corresponding "Spec review loop" → "Spec review passed?" node pair to the dot graph. Tested with claude --plugin-dir and claude-session-driver: worker now correctly dispatches the spec-document-reviewer subagent after writing the design doc and before presenting to the user for review. Fixes #677.
2026-03-10Merge PR #585: fix single quotes in SessionStart hook for Windows/LinuxJesse Vincent
Use escaped double quotes instead of single quotes around ${CLAUDE_PLUGIN_ROOT} path in hooks.json. Single quotes fail on Windows (cmd.exe doesn't recognize them as path delimiters) and on Linux when the shell doesn't expand the variable. Verified the fix works across all combinations: - macOS bash, path without spaces: pass - macOS bash, path with spaces: pass - Windows cmd.exe, path without spaces: FAILED with single quotes, PASS with double quotes - Windows cmd.exe, path with spaces: FAILED with single quotes, PASS with double quotes - Windows Git Bash: pass (both quote styles work here) Testing was done on a Windows 11 (NT 10.0.26200.0) dev box with Claude Code 2.1.72 and Git for Windows. The single-quote bug only manifests when cmd.exe is the executing shell (no Git Bash fallback), which explains why some users hit it and others don't. Closes #577, closes #644.
2026-03-10Add Gemini CLI install instructions to READMEJesse Vincent
2026-03-10fix: update install cursor commandsamuelcsouza
2026-03-09Remove fsevents from bundled deps (macOS-only native binary)Jesse Vincent
fsevents is an optional chokidar dependency that only works on macOS. Chokidar falls back gracefully without it on all platforms.
2026-03-09Bundle brainstorm server dependencies instead of requiring npm installJesse Vincent
Vendor node_modules into the repo so the brainstorm server works immediately on fresh plugin installs without needing npm at runtime.
2026-03-09Auto-install brainstorm server dependencies on first runJesse Vincent
start-server.sh now runs npm install if node_modules is missing. Fixes broken server when superpowers is installed as a plugin (node_modules are in .gitignore and not included in the clone).
2026-03-09Update changelog with server-info, platform launch, and OpenCode fixJesse Vincent
2026-03-09Write server-info to file so agents can find URL after background launchJesse Vincent
The server now writes its startup JSON to $SCREEN_DIR/.server-info. Agents that launch the server via background execution (where stdout is hidden) can read this file to get the URL, port, and screen_dir.
2026-03-09Replace Codex-specific server guidance with per-platform launch instructionsJesse Vincent
The visual companion docs now give concrete launch commands per platform: Claude Code (default mode), Codex (auto-foreground via CODEX_CI), Gemini CLI (--foreground with is_background), and a fallback for other environments.
2026-03-09fix(opencode): correct TodoWrite tool mapping to todowriteMatt Van Horn
TodoWrite maps to OpenCode's built-in `todowrite` tool, not `update_plan`. Verified against OpenCode source (packages/opencode/src/tool/todo.ts). Co-authored-by: Matt Van Horn <455140+mvanhorn@users.noreply.github.com>
2026-03-09Merge wip-gemini-cli: Gemini CLI extension, agentskills compliance, changelogJesse Vincent
2026-03-09Update release notes with all changes since v5.0.0Jesse Vincent
2026-03-09Move brainstorm-server into skill directory per agentskills specJesse Vincent
Moves lib/brainstorm-server/ → skills/brainstorming/scripts/ so the brainstorming skill uses relative paths (scripts/start-server.sh) instead of ${CLAUDE_PLUGIN_ROOT}/lib/brainstorm-server/. This follows the agentskills.io specification for portable, cross-platform skills. Updates visual-companion.md references and test paths. All tests pass.
2026-03-09Load Gemini tool mapping via GEMINI.md @import instead of skill referenceJesse Vincent
The tool mapping table is now @referenced directly in GEMINI.md so Gemini CLI always has it in context when processing skills, rather than requiring Gemini to find and read a reference file from within the skill.
2026-03-09Add Gemini CLI tool mapping and update using-superpowers referencesJesse Vincent
Maps all Claude Code tool names to Gemini CLI equivalents (read_file, write_file, replace, run_shell_command, grep_search, glob, write_todos, activate_skill, etc.). Notes that Gemini CLI has no subagent support. Updates using-superpowers to reference GEMINI.md in instruction priority and link to the new gemini-tools.md reference alongside codex-tools.md.
2026-03-09Move Gemini extension to repo root for cross-platform supportJesse Vincent
Symlinks inside .gemini/ don't work on Windows. Moving gemini-extension.json and GEMINI.md to the repo root means the extension root IS the repo root, so skills/ is found naturally without symlinks.
2026-03-09Add skills symlink to Gemini CLI extensionJesse Vincent
Symlinks .gemini/skills -> ../skills so the extension bundles all Superpowers skills. Without this, skills are only found when running from the repo workspace, not when installed as an extension.
2026-03-09refactor: replace MCP server with native Gemini CLI extensionJesse Vincent
Remove the custom MCP server (find_skills/use_skill tools) and force-invoke GEMINI.md. Gemini CLI natively supports the Agent Skills format — our skills/ directory works as-is. GEMINI.md now uses @import to inline using-superpowers content at session start. Needs testing to verify @import resolves relative to the extension root.
2026-03-09WIP: Gemini CLI extension infrastructureJesse Vincent
Add experimental Gemini CLI extension with MCP server that exposes skills as individual tools. Infrastructure works but auto-triggering skills is blocked by Gemini CLI treating context files as advisory rather than executable instructions. See issue #128 for detailed findings. - gemini-extension.json manifest - MCP server with individual skill tools - GEMINI.md bootstrap attempts (don't work) - Installation documentation
2026-03-09fix(brainstorming): add user review gate between spec and writing-plansJesse Vincent
After the spec review loop passes, the skill now asks the user to review the written spec file before invoking writing-plans. This prevents the agent from racing ahead to implementation planning without giving the user a chance to read and adjust the written document. Fixes #565
2026-03-09chore: remove dead lib/skills-core.js and its testsJesse Vincent
Last consumer (Codex bootstrap CLI) was removed on 2026-02-05. Removes the library, its dedicated test file, and references in test-plugin-loading.sh and run-tests.sh. h/t @RomarQ (PR #525) for flagging this.
2026-03-09Merge pull request #610 from karuturi/patch-1Jesse Vincent
Add Superpowers installation instructions for Claude Code official marketplace
2026-03-09fix(hooks): emit session-start context only once per platformmvanhorn
Claude Code reads both additional_context and hookSpecificOutput without deduplication, causing double injection. Detect platform via CLAUDE_PLUGIN_ROOT and emit only the appropriate field. Co-authored-by: mvanhorn <mvanhorn@users.noreply.github.com>
2026-03-09fix: replace bare except with except Exceptiondaniel-graham
Co-authored-by: daniel-graham <daniel-graham@users.noreply.github.com>
2026-03-09Merge dev-reorder10: Release v5.0.0v5.0.0Jesse Vincent
2026-03-09Release v5.0.0: Visual brainstorming, document review loops, architecture ↵Jesse Vincent
guidance
2026-03-08Fix stale docs/plans path in brainstorming checklistJesse Vincent
2026-03-08Add v5.0.0 release notes and include AGENTS.md in instruction priorityJesse Vincent
2026-03-08Broaden visual companion offer language beyond design-specific use casesJesse Vincent
2026-03-08Remove batch-and-stop pattern from executing-plans skillJesse Vincent
Executing-plans no longer pauses every 3 tasks for review. Also adds a note encouraging users to use a subagent-capable platform for better quality results.
2026-03-08Deprecate slash commands in favor of skillsJesse Vincent
2026-03-06Replace 'For Claude' with 'For agentic workers' in plan headersJesse Vincent
2026-03-06Rename brainstorm companion to Superpowers Brainstorming with GitHub linkJesse Vincent