oh-my-pi

Enhancement framework for Pi CLI — transforms the raw coding agent into a coordinated multi-agent orchestration system.

Install

pi install oh-my-pi

That's it. Pi auto-discovers the package and loads the extension on next session.

What It Does

oh-my-pi replaces Pi's default system prompt with a Sisyphus-style orchestrator prompt — the agent becomes a coordinator that routes work to specialist sub-agents, follows structured workflows, and provides richer guidance.

v0.1 features:

• Dynamic orchestrator prompt with agent/skill awareness
• Configurable via .oh-my-pi.jsonc (JSONC format)
• Built-in specialist agents (oracle, librarian, explore)
• Skill system with full instruction injection
• Graceful degradation — falls back to vanilla Pi on error
• /oh-my-pi doctor diagnostics

Quick Start

# Install
pi install oh-my-pi

# Create a project config (optional — defaults work out of the box)
echo '{
  "orchestrator": {
    "agentName": "my-agent",
    "promptTemplate": "sisyphus"
  }
}' > .oh-my-pi.jsonc

# Use pi normally — the orchestrator activates automatically
pi

Config

See .oh-my-pi.jsonc for the full config schema. Minimal config:

{
  "orchestrator": {
    "agentName": "oh-my-pi",
    "promptTemplate": "sisyphus"
  },
  "agents": {
    "oracle": {
      "description": "Architecture consultant",
      "model": "claude-opus-4.7"
    }
  }
}

Adding Custom Skills

Create .oh-my-pi/skills/my-skill.md:

---
name: my-skill
description: Description of what this skill provides
---

# Skill Instructions

Detailed instructions injected into the orchestrator prompt...

Skills are auto-discovered and their full instruction body is injected into the orchestrator prompt.

Development

git clone <repo>
cd ohmypi
npm install
npm run check    # lint + format
npm test         # run tests
npm run build    # compile TypeScript

See AGENTS.md for architecture, conventions, and development guide.

License

MIT