Bundled upstream support

Supporting files are included at skill-relative paths. See UPSTREAM-NOTICE.md for their pinned sources, licenses, hashes, and import changes.

Oh My Pi Delegate

When to Use

• You want to delegate a bounded coding task to a separate omp implementer (Oh My Pi) and then review its diff yourself.
• The user explicitly asked for delegation to this implementer.

You are the orchestrator. Delegate a bounded coding task to a separate implementer - Oh My Pi (omp) - then review what it produced and land it yourself. You write the brief and own the judgment; the implementer makes changes in its own session; you verify and commit.

The loop needs only a shell command and file access, so any comparable orchestrator can drive it.

The binary is omp, not pi

Oh My Pi is a fork of Pi. This skill drives omp (@oh-my-pi/pi-coding-agent). The original Pi CLI is a different binary (pi) with a different skill (pi-delegate). If omp is missing but pi is installed, you have Pi, not Oh My Pi.

When NOT to use this

• The task is small enough to do inline; delegation overhead is not worth it.
• The omp CLI is not installed or authenticated.
• The user asked for the original Pi CLI (pi) — use pi-delegate.
• You need a sandboxed implementer. Oh My Pi has no sandbox. --read-only restricts the tool surface; a write-capable run executes without prompts (--yolo).

Prerequisites (check once)

1. Install omp with bun install -g @oh-my-pi/pi-coding-agent (or the install path from https://omp.sh).
2. Authenticate: /login inside omp for a subscription provider, or an API-key environment variable for an API-key provider. Credentials live under ~/.omp/.
3. Confirm omp --version succeeds.
4. Work in, or point --cd at, the target git repository.

Choose the model (optional)

Omit --model (and --provider) to use omp's configured default for this project / profile. The catalog is this install's authenticated providers — not a fixed list in this skill.

To pick another model:

1. List what this install can actually run. Do not pass omp --list-models — that flag is gone and omp treats it as an unknown flag (exit 2). Use the models subcommand:
   • omp models — every available model, grouped by provider
   • omp models --json — the same catalog, machine-readable
   • omp models find <substring> — filter by provider, id, or name (example: omp models find sonnet)
   • omp models <provider> — one provider's models
2. Pass that id to the relay. --model <pattern> is omp's own --model: a fuzzy match against the catalog (provider/id, a bare id, or a unique substring). --provider <name> pins the provider when the pattern is ambiguous.
3. The relay forwards only letters, digits, and . _ : / -. Glob patterns with * are rejected.

--thinking <level> is a separate reasoning dial, not a model id. Allowed values: off, auto, minimal, low, medium, high, xhigh, max. The relay rejects anything else (including inherit) before dispatch — omp would otherwise warn and ignore a bad value.

A fleet lane (--lane) can set provider, model, and effort. Lane effort becomes --thinking; an explicit --thinking / --model / --provider flag wins over the lane.

The relay does not forward --api-key, --smol, --slow, or --plan. Those stay omp's own CLI.

The loop

Run these five steps per task. Steps 1, 4, and 5 require judgment; 2 and 3 are mechanical.

1. Write the brief

Oh My Pi sees only the text you send plus what it can inspect in the workspace - no chat history or shared context. Include the goal, current state, what to change, what to leave untouched, the project's actual gates, and a report contract. Tell omp not to commit. Keep one task per brief. omp auto-loads AGENTS.md/CLAUDE.md context files from the workspace and its parents, so repo instructions reach it without inlining. See references/writing-the-brief.md.

2. Dispatch

Use the bundled relay. It pipes the brief to omp --mode json on stdin, captures the JSON event stream, and writes result.json. (<skill-dir> is the installed folder containing this SKILL.md.)

node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo
# list models first:                       omp models   (or: omp models --json)

…