Files
stack/packages/mosaic/framework/adapters/pi.md
T
2026-08-10 17:33:34 -05:00

39 lines
1.3 KiB
Markdown

# 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
```bash
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
```