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