superpowers-sage

Superpowers Sage

Agent plugin for modern WordPress development with the Roots ecosystem — works with Claude Code, VS Code (GitHub Copilot), Cursor, OpenAI Codex, and any AI assistant that supports the agent plugin format. Workflow skills, design tool integration, visual verification, content modeling, and zero-token automation hooks for Sage, Acorn, and Lando projects.

Full documentation →

Prerequisites

Requirement	Version
Lando	3.x
Sage + Acorn	11+ / 4+
PHP	8.2+
Node.js	20+

Installation

One repository, four loaders. The same plugin installs identically regardless of your AI assistant. Pick the section for your tool below.

---

Claude Code

claude plugin marketplace add codigodoleo/superpowers-sage
claude plugin install superpowers-sage@superpowers-sage-marketplace

Alternatively, install directly from the repository URL:

claude plugin install --source https://github.com/codigodoleo/superpowers-sage

Verify the installation:

claude plugin list

---

VS Code (GitHub Copilot Chat)

1. Enable the preview feature in your settings:

   // settings.json
   "chat.plugins.enabled": true
   

2. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and run:

   Chat: Install Plugin From Source
   

3. Enter the repository URL:

   https://github.com/codigodoleo/superpowers-sage
   

Alternative — install via Extensions view:
Search @agentPlugins in the Extensions sidebar, or add the repository as a marketplace source in your settings:

// settings.json
"chat.plugins.marketplaces": [
  "codigodoleo/superpowers-sage"
]

Then search for and install superpowers-sage from the Extensions view.

---

Cursor

Note: We consistently see significantly better results with Claude CLI + Sonnet. This plugin was designed around Claude Code's execution model — worktrees, hooks, subagent dispatch, MCP tool routing — and those features are unavailable in Cursor. You get the skill instructions, but none of the automation. If you have access to the Claude CLI, it's worth using that instead.

Recent Cursor versions removed the "paste repo URL" plugin installation UI. The reliable approach is a one-time clone + symlink:

# Clone once to a shared location
git clone https://github.com/codigodoleo/superpowers-sage ~/.ai-plugins/superpowers-sage

# In each project root, symlink into .cursor/rules/
ln -s ~/.ai-plugins/superpowers-sage/skills .cursor/rules/superpowers-sage-skills
ln -s ~/.ai-plugins/superpowers-sage/agents .cursor/rules/superpowers-sage-agents

On Windows (Command Prompt as Administrator):

mklink /D .cursor\rules\superpowers-sage-skills %USERPROFILE%\.ai-plugins\superpowers-sage\skills
mklink /D .cursor\rules\superpowers-sage-agents %USERPROFILE%\.ai-plugins\superpowers-sage\agents

To update: git -C ~/.ai-plugins/superpowers-sage pull — all projects pick up changes automatically via the symlinks.

Cursor discovers skills and agents from .cursor/rules/ automatically. Hooks are loaded from hooks/cursor-hooks.json.

---

OpenAI Codex

The plugin ships in the current Codex plugin format: a marketplace manifest at .agents/plugins/marketplace.json and the plugin under plugins/superpowers-sage/.

Install (Codex CLI ≥ 0.137):

codex plugin marketplace add codigodoleo/superpowers-sage
codex plugin add superpowers-sage@superpowers-sage-marketplace

Activate the house rules (important). Unlike Claude Code, Codex does not load a plugin's CLAUDE.md — it reads AGENTS.md from the project root (and ~/.codex/AGENTS.md). The plugin ships the same universal rules as a generated AGENTS.md. Bring them into your Sage project once:

# from your project root — appends the superpowers-sage universal rules
curl -fsSL https://raw.githubusercontent.com/codigodoleo/superpowers-sage/main/AGENTS.md >> AGENTS.md

Without this, Codex still loads the skills on demand, but the always-on house conventions (ACF Composer field shapes, transient caching, Blade escaping by field type, Livewire-on-Bedrock route) won't fire one-shot. In measured runs, delivering these rules via AGENTS.md lifted Codex's house-convention adherence from 62% to 86%.

To run against a local model (e.g. Ollama), point Codex at it via ~/.codex/config.toml:

model = "your-model"
model_provider = "local_ollama"

[model_providers.local_ollama]
name = "Ollama"
base_url = "http://localhost:11434/v1/"
wire_api = "responses"   # Codex ≥ 0.137 dropped "chat"