Obra Superpowers on Mac mini: Coding Agent Install Guide (2026)

Coding agents that skip design and tests ship plausible bugs fast. Obra Superpowers (Jesse Vincent, MIT, github.com/obra/superpowers) is a composable skills framework that forces brainstorming → approved spec → TDD → review before merge. On a rented Mac mini M4, Superpowers pairs with always-on SSH, launchd, and tools like OpenClaw so agents run 24/7 without a sleeping laptop.

Why Superpowers on a cloud Mac mini

Most developers install Superpowers on a daily-driver MacBook. That works until the machine sleeps, VPN drops, or MDM blocks plugin marketplaces. A dedicated Mac mini in HK/JP/KR/SG/US gives stable SSH for headless sessions, isolated API keys, and predictable ~$99/month hardware cost (see ProxyMac pricing)—often cheaper than a second Mac for agent sandboxes. Compare model token spend via Codex CLI pricing.

Superpowers does not replace your model; it replaces ad-hoc prompting with mandatory workflows encoded as SKILL.md files. Pair with OpenClaw launchd gateway setup when you need always-on gateways.

How Superpowers works

Quotable definition: Superpowers is an MIT-licensed skills framework that makes coding agents run design approval, implementation plans, and test-driven development as mandatory steps—not optional chat suggestions.

The library ships 14+ skills (brainstorming, git worktrees, writing-plans, subagent-driven-development, TDD, code review, and more). Anthropic added Superpowers to the official Claude plugin marketplace in January 2026; the public repo reported 170k+ GitHub stars by spring 2026. Size RAM using Apple Mac mini specs when colocating agents and MCP servers.

Nine-step install runbook

1. Size the instance — 16 GB RAM minimum; 24 GB if OpenClaw gateway + MCP run together.
2. Baseline tools — xcode-select, git, Node 22+ on the rented host.
3. Workspace — mkdir -p ~/agents/superpowers-workspace; avoid iCloud-synced folders.
4. Cursor — In Agent chat: /add-plugin superpowers (or marketplace search).
5. Claude Code — /plugin install superpowers@claude-plugins-official
6. Codex CLI — /plugins → search superpowers → Install (watch API billing).
7. launchd PATH — Set EnvironmentVariables in plist per MCP environment guide.
8. Smoke test — Ask for a small feature; expect questions before code.
9. Optional OpenClaw — Schedule jobs via OpenClaw install guide.

Cursor plugin command

/add-plugin superpowers — restart Agent chat, then prompt: help me plan a feature. Brainstorming should trigger automatically.

Claude Code marketplace

/plugin marketplace add obra/superpowers-marketplace then /plugin install superpowers@superpowers-marketplace. Verify with /plugin list.

Troubleshooting

Skills ignored — agent codes immediately

Start a new session; confirm the plugin is enabled; say Use superpowers brainstorming before coding. On manual installs, re-sync from the GitHub repo.

Marketplace blocked behind proxy

Set HTTPS_PROXY / NO_PROXY and retry. For headless gateways, mirror keys into launchd per HTTP proxy egress guide.

FAQ

Which harness should you install first?

Superpowers is harness-specific. A plugin enabled in Cursor does not appear in Codex CLI. Use this matrix on your rented Mac mini:

If you only rent one Mac mini, pick the harness you will actually drive from CI. Many teams install two (Cursor locally + Claude Code on the server) and accept duplicated skill versions.

Security and ops on a shared agent host

A Mac mini running Superpowers + OpenClaw holds live API keys and git credentials. Minimum baseline:

• Dedicated macOS user per environment (dev/staging/prod)—never share HOME between tenants.
• Store secrets in Keychain or encrypted env files; inject via launchd per MCP environment guide.
• Disable automatic iCloud Desktop/Documents for the agent user.
• Rotate keys when an agent session logs full prompts externally.

Superpowers increases session length (more tool calls per feature). Watch disk: git worktrees and test artifacts can consume 5–15 GB per active feature branch.

What changes in day-to-day engineering

Before Superpowers, a typical agent session jumped from prompt → diff in under a minute. After install, the same prompt should produce:

1. Clarifying questions (scope, constraints, existing APIs).
2. A design section you approve in chat.
3. A written plan with file paths and test commands.
4. RED tests, then minimal implementation, then review notes.

That adds roughly 5–15 minutes upfront and saves hours of rework when the feature touches more than two files. For production agent fleets, the trade-off is overwhelmingly positive.

Updating and pinning versions

Claude Code: /plugin update superpowers. Cursor: use the marketplace update UI. Pin versions in team docs if you need reproducible audits—upstream ships frequent skill tweaks (v5.0.7+ in spring 2026). After updates, rerun the smoke test in Step 8.

Raw agents vs Superpowers on the same Mac mini

Teams often A/B test on identical hardware. A raw Claude Code session on a ProxyMac Mac mini can merge a feature in one hour—with regressions discovered later in CI. The same prompt with Superpowers typically spends twenty minutes on design and tests, then forty minutes on implementation, with fewer surprise breakages.

Measure what matters for your org: if production incidents from agent merges dropped after install, keep Superpowers enabled for feature work. If your repo is mostly docs and config, the overhead may not pay off. The framework is MIT-licensed, so the experiment costs only engineer time—not license fees.

Combine with OpenClaw when you need Telegram/Slack triggers or MCP filesystem tools; Superpowers does not provide channels—it provides discipline. That separation keeps responsibilities clear: OpenClaw moves messages, Superpowers moves engineering process.

The seven phases in detail

Brainstorming clarifies goals before diffs. Git worktrees isolate features with a green test baseline. Writing-plans emits 2–5 minute tasks with paths and verify commands. Subagent-driven-development is the heaviest CPU/RAM phase on Mac mini M4. TDD enforces red-green-refactor. Code review blocks on critical findings. Finishing-a-development-branch cleans up worktrees on shared rental hosts.

Related reading

• Hermes Agent Mac setup guide
• What is an agent harness?
• OpenClaw Mac mini install guide
• Codex CLI pricing & API costs
• OpenClaw MCP environment & launchd
• OpenClaw gateway launchd startup