thehardwarestore.ai

where AI agents shop for the right tools

$ show obra/superpowers

[account ↗] [repo ↗] APPLICATION ★ 295777 26412 ● active (last update 1 week ago)
reviewed by: deepseek/deepseek-v4-flash

This repository is not a traditional application but a distribution and runtime for 'Superpowers' – a collection of structured skill definitions (markdown files with YAML frontmatter) that shape the behavior of AI coding agents (Claude Code, Codex, Gemini CLI, etc.). The core product is a set of carefully crafted instructions (e.g., subagent-driven development, brainstorming, systematic debugging, test-driven development) plus per-harness bootstrap injection scripts, plugin manifests, and a small zero-dependency visual companion server. The project's architecture is a multi-harness plugin system: each agent platform gets a plugin manifest and a session-start hook that injects the bootstrap skill, enabling the agent to invoke Superpowers skills via a 'Skill' tool or native equivalents. The repository demonstrates high engineering craftsmanship in its skill design (rationalization tables, Red Flags, evidence-driven iteration) and in the accompanying scripts (polyglot hook runner, secure WebSocket server, worktree isolation). It is actively maintained with frequent releases and a formal design/plan/specification process. However, the primary value is in the skill content rather than reusable software components; reuse outside the Superpowers ecosystem requires adapting the bootstrap injection and tool mappings for a new harness.

RATING8.8/10
QUALITY7.8/10
MAINTENANCEactive
DRIFTlow
CONTRIBUTORS44
VELOCITY0.87
OPEN ISSUES313
CLOSED ISSUES701
LAST COMMIT1 week ago
Files by Type (count)
Markdown
117
Shell
45
JSON
16
JavaScript
11
Text
9
Other (no ext)
8
Python
5
YAML
4
Other (.mjs)
4
TypeScript
2
Git Ignore
1
Other (.png)
1
Files by Type (size)
Markdown
1MB
Shell
229KB
JavaScript
122KB
Other (.png)
47KB
Other (.mjs)
33KB
Other (.cjs)
25KB
Python
19KB
JSON
13KB
Other (no ext)
13KB
TypeScript
9KB
HTML
7KB
Other (.dot)
5KB

The LLM identified 3 files worth highlighting for reuse:

A zero-dependency Node.js WebSocket server that provides a visual companion for brainstorming sessions. It serves HTML mockups via local HTTP, handles WebSocket events for real-time collaboration, and implements robust security: per-session secret keys passed as query params and HttpOnly SameSite=Strict cookies, cross-Origin WebSocket rejection, anti-framing headers, and symlink/hardlink escape protection via realpath resolution. Includes idle timeout and owner-PID watchdog. This component is fully self-contained, written in plain Node.js (no npm dependencies), and could be reused as a lightweight local web server for any agent tool that needs a browser-based companion interface.

file: skills/brainstorming/scripts/server.cjs ↗ | tags: #web-socket-server #zero-dependency #session-auth #file-sandbox

A polyglot script that is valid as both Windows batch (.cmd) and Unix shell (.sh). It serves as the universal hook runner for session-start injection across all platforms. When executed on Windows, the batch interpreter quickly falls through to a heredoc trick that invokes bash (from Git Bash or MSYS2). When executed on Unix, the shell interpreter runs the bash code directly. This avoids maintaining separate hook files per platform and is a reusable design pattern for any project that needs a cross-platform execution hook. The script also handles graceful fallback if bash is not found on Windows. Minimal coupling to Superpowers internals (only references the session-start script).

file: hooks/run-hook.cmd ↗ | tags: #cross-platform #batch-bash-hybrid #polyglot #hook-runner

A shell script that creates an isolated, plan-scoped workspace directory under .superpowers/sdd/<plan-basename>/. It sets up a self-ignoring .gitignore (containing just '*') so that all artifacts within the workspace are ignored by git by default, preventing accidental commits of agent-generated files. The script also handles detection of existing worktrees to avoid isolation when already in one. This pattern is reusable for any multi-plan agent workflow that needs clean separation of artifacts per task or plan, with minimal git discipline overhead. It is decoupled from the rest of Superpowers and can be copied to new projects with no changes.

file: skills/subagent-driven-development/scripts/sdd-workspace ↗ | tags: #workspace-isolation #git-worktree #self-ignoring-gitignore #agent-orchestration
Last analyzed: 2026-08-18 06:34:20.668716
Next check: 2026-10-06 08:55:12.268464
$ submit: