superpowers-dex

Superpowers Dex

A community-maintained fork of obra/superpowers for Claude Code, with native task management and dex cross-session persistence.

Why This Fork

The original Superpowers is a cross-platform toolkit for multiple AI CLI tools (Claude Code, Codex, OpenCode, Gemini CLI). Features unique to Claude Code fall outside its cross-platform scope.

This fork adds Claude Code-native integrations.

What's Different

Feature	Description
Native Task Management	Claude Code TaskCreate/TaskUpdate for real-time progress visibility and dependency tracking
Dex Persistence	Cross-session task memory via dex CLI — resume work across conversations
Dual-Write Pattern	In-session native tasks + persistent dex storage, so nothing is lost between sessions

How Dex Works

Skills use a dual-write pattern:

1. Native tasks (TaskCreate/TaskUpdate) for in-session UI — you see pending/in_progress/completed states in real time
2. Dex for persistent storage — when you start a new session, dex list --in-progress recovers where you left off

This means:

• Plans created in one session survive to the next
• using-superpowers checks dex on session start and offers to resume
• No more lost context when Claude Code restarts

Visual Comparison

Superpowers (Vanilla)	Superpowers Dex
Tasks exist only in markdown plan No runtime task visibility Agent may jump ahead or skip tasks Progress tracked manually by reading output	Dependency enforcement — Task 2 blocked until Task 1 completes Execution on rails — native task manager keeps the agent on plan Real-time visibility — pending/in_progress/completed states Cross-session memory — dex persists tasks between conversations

Installation

Via Marketplace (recommended)

# Register marketplace
/plugin marketplace add abhishekray07/superpowers-dex

# Install plugin
/plugin install superpowers-dex@superpowers-dex-marketplace

Direct install

claude plugins add abhishekray07/superpowers-dex

Verify

After restarting Claude Code:

/help
# Should show superpowers-dex skills:
# superpowers-dex:brainstorming
# superpowers-dex:writing-plans
# superpowers-dex:executing-plans
# ...

Prerequisites

Install dex for cross-session persistence:

# Install from https://dex.rip/install
curl -fsSL https://dex.rip/install | bash

Without dex, the plugin still works — you just lose cross-session memory.

The Workflow

1. brainstorming — Refines ideas through questions, explores alternatives, saves design document. Creates dex epic for persistence.

2. using-git-worktrees — Creates isolated workspace on new branch, runs setup, verifies clean test baseline.

3. writing-plans — Breaks work into small tasks with exact file paths, code, and verification steps. Creates native tasks with dependencies + dex epic.

4. subagent-driven-development or executing-plans — Dispatches subagent per task with two-stage review, or executes in batches with checkpoints. Loads from dex on session resume.

5. test-driven-development — RED-GREEN-REFACTOR. Write failing test, make it pass, commit.

6. requesting-code-review — Reviews against plan, reports by severity. Critical issues block progress.

7. finishing-a-development-branch — Verifies tests, presents options (merge/PR/keep/discard), cleans up.

Skills are checked automatically before any task — mandatory workflows, not suggestions.

Skills Library

Testing

• test-driven-development — RED-GREEN-REFACTOR cycle

Debugging

• systematic-debugging — 4-phase root cause process
• verification-before-completion — Verify before declaring success

Collaboration

• brainstorming — Socratic design refinement + dex epic creation
• writing-plans — Implementation plans + native tasks + dex persistence
• executing-plans — Batch execution with checkpoints, dex-aware resume
• dispatching-parallel-agents — Concurrent subagent workflows + dex completion tracking
• subagent-driven-development — Fast iteration with two-stage review, dex verification
• requesting-code-review — Pre-review checklist
• receiving-code-review — Responding to feedback
• using-git-worktrees — Parallel development branches
• finishing-a-development-branch — Merge/PR decision workflow