Superpowers MCP Augemnt Marketplace

Git marketplace for the superpowers-mcp-augemnt Codex plugin.

This plugin augments Superpowers workflows with:

• codebase-memory-mcp indexing and graph context
• Serena project activation, onboarding, memories, and symbolic context
• mandatory testcase approval before behavior-changing implementation
• UI/UX skill awareness for design preview work, including installed skills such as impeccable
• existing-app design pattern discovery before localhost mockups or UI implementation
• context budget tiers to avoid over-querying MCP on small tasks
• task-level execution context
• subagent implementer/reviewer context
• verification context before completion claims

Prerequisites

Users must install and configure these before enabling this marketplace:

• Codex
• Superpowers plugin
• Serena MCP server
• codebase-memory-mcp server

This plugin does not install Superpowers, Serena, or codebase-memory-mcp. It only augments their behavior when they are already available in Codex.

Expected available capabilities after setup:

• Superpowers skills such as superpowers:brainstorming, superpowers:test-driven-development, and superpowers:verification-before-completion
• Serena MCP tools such as activate_project, check_onboarding_performed, get_symbols_overview, and find_symbol
• codebase-memory-mcp tools such as list_projects, index_status, index_repository, get_architecture, search_graph, and trace_path

Install

| OS | One-command install | Manual install | | --- | --- | --- | | macOS | curl -fsSL https://raw.githubusercontent.com/Penz7/superpowers-mcp-augemnt-marketplace/main/scripts/install.sh | bash | codex plugin marketplace add Penz7/superpowers-mcp-augemnt-marketplace then set enabled = true | | Linux | curl -fsSL https://raw.githubusercontent.com/Penz7/superpowers-mcp-augemnt-marketplace/main/scripts/install.sh | bash | codex plugin marketplace add Penz7/superpowers-mcp-augemnt-marketplace then set enabled = true | | Windows | irm https://raw.githubusercontent.com/Penz7/superpowers-mcp-augemnt-marketplace/main/scripts/install.ps1 | iex | codex plugin marketplace add Penz7/superpowers-mcp-augemnt-marketplace then set enabled = true |

macOS and Linux

One-command install:

curl -fsSL https://raw.githubusercontent.com/Penz7/superpowers-mcp-augemnt-marketplace/main/scripts/install.sh | bash

This script runs codex plugin marketplace add and then enables the plugin persistently in ~/.codex/config.toml.

Manual install:

codex plugin marketplace add Penz7/superpowers-mcp-augemnt-marketplace

Or use the full Git URL:

codex plugin marketplace add https://github.com/Penz7/superpowers-mcp-augemnt-marketplace.git

Current Codex CLI behavior: marketplace add adds the marketplace only. It does not automatically enable plugins contained in that marketplace. Enable the plugin after adding:

[plugins."superpowers-mcp-augemnt@superpowers-mcp-augemnt-marketplace"]
enabled = true

Then restart Codex.

Windows

One-command install from PowerShell:

irm https://raw.githubusercontent.com/Penz7/superpowers-mcp-augemnt-marketplace/main/scripts/install.ps1 | iex

This script runs codex plugin marketplace add and then enables the plugin persistently in %USERPROFILE%\.codex\config.toml.

Manual install:

codex plugin marketplace add Penz7/superpowers-mcp-augemnt-marketplace

Or use the full Git URL:

codex plugin marketplace add https://github.com/Penz7/superpowers-mcp-augemnt-marketplace.git

Current Codex CLI behavior: marketplace add adds the marketplace only. It does not automatically enable plugins contained in that marketplace. Enable the plugin after adding:

[plugins."superpowers-mcp-augemnt@superpowers-mcp-augemnt-marketplace"]
enabled = true

Then restart Codex.

If your Codex version does not support codex plugin marketplace, add this manually to your Codex config file (~/.codex/config.toml on macOS/Linux, %USERPROFILE%\.codex\config.toml on Windows):

[marketplaces.superpowers-mcp-augemnt-marketplace]
source_type = "git"
source = "https://github.com/Penz7/superpowers-mcp-augemnt-marketplace.git"

[plugins."superpowers-mcp-augemnt@superpowers-mcp-augemnt-marketplace"]
enabled = true

Then restart Codex.

To update later:

codex plugin marketplace upgrade superpowers-mcp-augemnt-marketplace

To remove:

codex plugin marketplace remove superpowers-mcp-augemnt-marketplace

How To Use

Use Codex normally. The plugin is designed to trigger automatically for behavior-changing coding tasks when Superpowers, Serena, and codebase-memory-mcp are available.

For feature work, bug fixes, API changes, UI behavior changes, refactors, or TDD tasks, the agent should:

1. Use codebase-memory-mcp first to inspect or index the project.
2. Use Serena second for project activation and symbol-level context.
3. Continue with the relevant Superpowers workflow.
4. Stop at ## Proposed Testcase Set before editing tests or implementation.
5. Wait for explicit user approval, testcase changes, testcase removal, or a user waiver.

Short prompts such as "add this API" do not count as testcase approval.

Verify Behavior

Open a real code project that has Superpowers, Serena, and codebase-memory-mcp available, then send a short behavior-changing request:

Add a new read-only API endpoint:
- return a stable resource name
- return a version from environment or package metadata
- return the current runtime environment

Expected behavior:

• The agent loads superpowers-mcp-augment or superpowers-mcp-test-planning.
• The agent uses codebase-memory-mcp before broad code discovery.
• The agent activates/checks Serena.
• The agent stops at ## Proposed Testcase Set.
• The agent does not create or edit tests/code before explicit user approval.

After approving:

Approve testcase set as-is.

Expected continuation:

• The agent writes failing tests first.
• The agent runs tests and confirms RED.
• The agent writes minimal implementation.
• The agent runs tests and confirms GREEN.
• The agent runs verification and reports any command that cannot be verified.

Repository Layout

.agents/plugins/marketplace.json
plugins/superpowers-mcp-augemnt/
  .codex-plugin/plugin.json
  README.md
  CHANGELOG.md
  LICENSE
  skills/
    superpowers-mcp-augment/
    superpowers-mcp-test-planning/
    superpowers-mcp-planning-context/
    superpowers-mcp-execution-context/
    superpowers-mcp-subagent-context/
    superpowers-mcp-verification/

Do not publish local Codex cache workarounds such as skills/skills.