3.2 KiB
3.2 KiB
Settings
Oh My Pi host settings
Use <project>/.omp/config.yml. POM creates a recommended file during project bootstrap and ships the same template at config/config.yml.
Important host controls:
| Key | POM purpose |
|---|---|
theme.dark/light |
Select POM Nocturne/Parchment after /pom theme install |
statusLine.showHookStatus |
Display POM stage, gate, Hive, retry, and approval segments |
terminal.showImages |
Show visual references and generated images in capable terminals |
tools.intentTracing |
Expose semantic tool intent in the live experience |
| artifact spill settings | Keep large tool output out of the conversation surface |
task.batch / concurrency |
Support bounded specialist waves |
compaction.strategy: snapcompact |
Preserve long-running production context |
| one-at-a-time steering/follow-up | Keep autopilot continuation ordered |
POM settings
Precedence:
built-in defaults
→ ~/.omp/agent/pom.json
→ <project>/.omp/pom.json
→ persisted project state for mutable experience fields
| Setting | Values | Purpose |
|---|---|---|
autoToolProfiles |
boolean | Route OMP active tools by stage |
autoModelRouting |
boolean | Resolve and activate the stage model role |
dashboardWidget |
boolean | Enable the persistent HUD |
stopGuard |
boolean | Continue an active stage briefly, then force explicit blocking |
defaultMode |
autopilot, collaborative, strict-autopilot |
Select prompt personality |
defaultView |
cinematic, rich, compact, minimal |
Select terminal information density |
defaultMotion |
off, subtle, full |
Select activity animation intensity |
defaultToolProfile |
auto, creative, research, draft, audit, delivery |
Initial active-tool policy |
maxStudioAgents |
1–12 | Bound a Hive task batch |
projectRootMode |
child, cwd |
Create a child project or use the current directory |
destructiveProjectCommands |
block, allow |
Guard recursive destructive commands |
gitMode |
off, checkpoint, branch-per-stage |
Control production checkpoints |
hudPlacement |
aboveEditor, belowEditor |
Place the production HUD |
showThinkingLane |
boolean | Annotate visible thinking with stage/execution lane |
/pom settings persists view/motion in project state and HUD/thinking options in .omp/pom.json.
Compatibility and verification state
| Requirement | Window | Source |
|---|---|---|
@oh-my-pi/pi-coding-agent |
>=16.4.6 <17 |
peerDependencies |
@oh-my-pi/pi-tui |
>=16.4.6 <17 |
peerDependencies |
@oh-my-pi/pi-utils |
>=16.4.6 <17 |
peerDependencies |
| Bun | >=1.3.14 |
engines.bun |
| Node.js + npm | Node 22 or newer | Local scripts and the node:test suite |
Verification state is PARTIAL. npm run smoke, npm run release:check, and node --import tsx --test tests/state.test.ts pass. The full npm run verify gate is blocked: an npm registry outage left node_modules incomplete (OMP SDK peer packages, @types/node, yauzl, and the OMP theme schema that scripts/verify.mjs reads). Restore registry access, reinstall, then rerun the full gate. See the README sections Verification status and Registry outage and offline guidance.