Supipowers

Agentic workflows for OMP. Plan features, orchestrate sub-agents, run quality gates, and ship releases — all from slash commands.

Install

bunx supipowers@latest

The installer checks for OMP, helps you install it if needed, copies supipowers into ~/.omp/agent/, and optionally installs LSP servers for better code intelligence.

Re-running the installer updates supipowers if a newer version is available. Already up-to-date installs are detected and skipped.

Update from inside OMP

/supi:update

Checks npm for the latest version, downloads and installs it — no prompts, no restart needed.

Commands

| Command | What it does | | ---------------- | ------------------------------------------------ | | /supi | Interactive menu — commands and project status | | /supi:plan | Collaborative planning with task breakdown | | /supi:run | Execute a plan with parallel sub-agents | | /supi:review | Quality gates at chosen depth | | /supi:qa | Run test suite and E2E pipeline | | /supi:release | Version bump, release notes, publish | | /supi:config | Interactive settings (TUI) | | /supi:status | Check running sub-agents and progress | | /supi:update | Update supipowers to latest version |

Commands like /supi, /supi:config, /supi:status, and /supi:update open native OMP TUI dialogs — they don't send chat messages or trigger the AI.

Planning

/supi:plan add authentication to the API

Starts an interactive planning session: clarifying questions, approach proposals, then a structured task breakdown saved to .omp/supipowers/plans/.

For simple tasks, skip the brainstorming:

/supi:plan --quick add rate limiting middleware

Running plans

/supi:run

Loads the latest plan and executes it with sub-agent orchestration. Tasks marked [parallel-safe] run concurrently (up to the configured limit). Sequential tasks respect their dependency chains.

The orchestration loop: dispatch batch → collect results → detect conflicts → retry failures → next batch. If interrupted, re-running picks up where it left off.

Quality review

/supi:review           # opens profile picker
/supi:review --quick   # fast: LSP diagnostics + AI scan
/supi:review --thorough  # deep: full AI review + code quality
/supi:review --full    # everything: tests + E2E + all gates

When no flag is provided, a TUI picker lets you choose the review profile interactively.

QA

/supi:qa              # opens scope picker
/supi:qa --changed    # tests for changed files only
/supi:qa --e2e        # Playwright / E2E only

Detects your test framework on first run (vitest, jest, pytest, cargo test, go test) and caches it. When no flag is provided, a TUI picker lets you choose the scope.

Release

/supi:release

Analyzes commits since last tag, suggests a version bump, generates release notes, and publishes. On first run, a TUI picker lets you choose your pipeline (npm, GitHub release, or manual).

Configuration

/supi:config

Opens an interactive settings screen with all configuration options. Select a setting to change its value — toggles flip instantly, selects open a picker, text fields open an input dialog.

Profiles

Three built-in profiles control quality gate depth:

| Profile | LSP | AI Review | Code Quality | Tests | E2E | | ----------------- | --- | ----------- | ------------ | ----- | --- | | quick | yes | quick scan | no | no | no | | thorough | yes | deep review | yes | no | no | | full-regression | yes | deep review | yes | yes | yes |

Create custom profiles in .omp/supipowers/profiles/.

Key settings

{
  "defaultProfile": "thorough",
  "orchestration": {
    "maxParallelAgents": 3, // concurrent sub-agents per batch
    "maxFixRetries": 2,     // retry failed tasks
    "maxNestingDepth": 2,   // sub-agent nesting limit
    "modelPreference": "auto"
  },
  "lsp": {
    "setupGuide": true
  },
  "qa": {
    "framework": null, // auto-detected and cached
    "command": null
  }
}

Config is stored in ~/.omp/agent/extensions/supipowers/ and managed entirely through /supi:config.

How it works

Supipowers is built on OMP's extension API. Every command is an immediate action — no state machine, no workflow phases.

Sub-agent orchestration: Plans are broken into batches of parallel-safe tasks. Each batch dispatches sub-agents with full OMP tool access (file editing, bash, LSP). After a batch completes, the orchestrator checks for file conflicts, retries failures, and moves to the next batch.

Quality gates: Composable checks selected by profile. LSP diagnostics feed real type errors. AI review catches logic issues. Test gates run your actual test suite. Gates report issues with severity levels (error/warning/info).

LSP integration: Sub-agents query LSP before making changes (find references, check diagnostics). If no LSP is active, everything still works — just better with it. The installer offers to set up LSP servers during installation.

Update checking: On session start, supipowers checks npm for a newer version in the background. If one is available, a notification tells you to run /supi:update.

Project structure

src/
  index.ts                     # extension entry point + update checker
  commands/                    # slash command handlers
    supi.ts, plan.ts, run.ts, review.ts, qa.ts, release.ts,
    config.ts, status.ts, update.ts
  orchestrator/                # sub-agent dispatch & coordination
    batch-scheduler.ts, dispatcher.ts, result-collector.ts,
    conflict-resolver.ts, prompts.ts
  quality/                     # composable quality gates
    gate-runner.ts, lsp-gate.ts, ai-review-gate.ts, test-gate.ts
  qa/                          # QA pipeline
    detector.ts, runner.ts, report.ts
  lsp/                         # LSP integration
    detector.ts, bridge.ts, setup-guide.ts
  notifications/               # rich inline notifications
    renderer.ts, types.ts
  config/                      # configuration & profiles
    loader.ts, profiles.ts, defaults.ts, schema.ts
  storage/                     # persistence
    plans.ts, runs.ts, reports.ts
  release/                     # release automation
    analyzer.ts, notes.ts, publisher.ts
  types.ts                     # shared type definitions
skills/
  planning/SKILL.md
  code-review/SKILL.md
  debugging/SKILL.md
  qa-strategy/SKILL.md
bin/
  install.mjs                  # bunx installer

Development

git clone https://github.com/ogrodev/supipowers.git
cd supipowers
bun install
bun run test        # run tests
bun run typecheck   # type checking
bun run test:watch  # watch mode

Requirements

• OMP (oh-my-pi)
• Bun runtime

License

MIT