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
• MCP-backed testcase context for Superpowers planning and TDD
• 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. Initialize or refresh the codebase graph when missing, stale, or not indexed.
4. Use Serena onboarding/memories to summarize tech stack, commands, conventions, and relevant symbols when needed.
5. Continue with the relevant Superpowers workflow.
6. When Superpowers reaches testcase selection, show ## Proposed Testcase Set and ask whether coverage should be added, removed, or adjusted.
7. Record that checkpoint in the plan or controller notes, then continue the same Superpowers workflow.

The testcase checkpoint belongs inside Superpowers planning/TDD, not beside it. Superpowers still owns brainstorming, writing plans, TDD, execution, reviews, verification, and branch finishing.

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 initializes or refreshes the codebase graph when needed.
• The agent uses Serena to identify tech stack, commands, conventions, and relevant symbols when needed.
• When Superpowers reaches testcase selection, the agent shows ## Proposed Testcase Set.
• The agent asks whether testcase coverage should be added, removed, or adjusted.
• After confirmation, the agent continues the same Superpowers workflow.
• If TDD applies, 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.