Files
stack/packages/mosaic/framework/adapters/pi.md
Jason Woltje 6e6ee37da0
Some checks failed
ci/woodpecker/push/ci Pipeline failed
ci/woodpecker/pr/ci Pipeline failed
feat: complete framework migration — PowerShell, adapters, guides, profiles, tests
Completes the bootstrap repo migration with remaining files:
- PowerShell scripts (.ps1) for Windows support (bin/ + tools/)
- Runtime adapters (claude, codex, generic, pi)
- Guides (17 .md files) and profiles (domains, tech-stacks, workflows)
- Wizard test suite (6 test files from bootstrap tests/)
- Memory placeholder, audit history

Bootstrap repo (mosaic/bootstrap) is now fully superseded:
- All 335 files accounted for
- 5 build config files (package.json, tsconfig, etc.) not needed —
  monorepo has its own at packages/mosaic/
- skills-local/ superseded by monorepo skills/ with mosaic-* naming
- src/ already lives at packages/mosaic/src/
2026-04-01 21:23:26 -05:00

1.1 KiB

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 the Mosaic extension via --extension for lifecycle hooks
  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)
  • 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