stack/packages/mosaic/framework/adapters/pi.md

Pi Adapter

Use this adapter when running Pi sessions via mosaic pi.

Required Context

1. ~/.config/mosaic/STANDARDS.md
2. <repo>/AGENTS.md

Integration

Pi is the native Mosaic agent runtime. The mosaic pi launcher:

1. Injects the full runtime contract via --append-system-prompt
2. Loads Mosaic skills via --skill flags
3. Loads framework-owned mosaic-extension.ts and goal-extension.ts from ~/.config/mosaic/runtime/pi/ via ordered --extension flags
4. Detects active missions and injects initial prompts

Capabilities vs Other Runtimes

• No permission restrictions (no yolo flag needed)
• Native thinking levels replace sequential-thinking MCP
• Native skill discovery compatible with Mosaic SKILL.md format
• Native extension system for lifecycle hooks (TypeScript, not bash shims)
• Bounded persistent /goal loop with per-turn, post-compaction, and two-pass evidence checks
• Native session persistence and resume
• Model-agnostic (Anthropic, OpenAI, Google, Ollama, custom providers)

Command Wrapper

mosaic pi                    # Interactive session
mosaic pi "Fix the auth bug" # With initial prompt
mosaic yolo pi               # Identical to mosaic pi
mosaic coord --pi run        # Coordinator-driven session
mosaic prdy --pi init        # PRD creation via Pi