OMP
- getHarness
- getHarness("omp")
- binary
- omp
- invoke modes
- 2 of 6 · official
- model listing
- no
- mcp config
- json · standard
- agents file
- ~/.omp/agent/AGENTS.md
OMP keeps Pi's session layout, JSONL per project with UUIDv7 ids, and adds profiles: ~/.omp/profiles/<name>/agent replaces ~/.omp/agent when one is active, and PI_CODING_AGENT_DIR overrides the directory outright. Config is config.yml plus settings.json and mcp.json. Prompt history, agent state and the model catalog are three SQLite databases.
Instructions go beyond AGENTS.md: .omp/RULES.md and its global twin are sticky rules applied every turn, PERSONALITY.md replaces the system prompt's personality block. --no-tools only disables OMP's bundled tools, not extensions, so it does not qualify as an advisor without tools and the mode is rejected. The OMP extension in this package registers the nine tools in OMP itself.
Capabilities and invocation
mcp: yesvision: yesaudio: novideo: notools: yesstreaming: yes
Binary omp, evidence official. Add --mode json for structured event output. --no-tools disables only OMP's bundled tools, so it cannot provide an advisor mode without tools. Model selection appends --model={model}.
advisor
{}
advisor · json
{ structured: true }
read-only
{ readOnly: true }
read-only · json
{ readOnly: true, structured: true }
agent
{ tools: true }
-p {prompt}agent · json
{ tools: true, structured: true }
-p --mode json {prompt}Paths
Templates as the registry stores them. ~, ${HOME} and %VAR% expand in resolve(); entries tagged with a platform are dropped on the others. Open in the explorer to see them expanded for a home directory of your choice.
config
~/.omp/agent/config.ymluser · official · allAgent dir overridable with PI_CODING_AGENT_DIR; profiles use ~/.omp/profiles/<name>/agent.~/.omp/agent/settings.jsonuser · official · all~/.omp/agent/mcp.jsonuser · official · allMCP server configurations..omp/config.ymlproject · official · all.omp/settings.jsonproject · official · all
sessions
~/.omp/agent/sessions/<dash-encoded-cwd>/<timestamp>_<session-id>.jsonldata · official · allPer-project session transcripts in JSONL format; session ids are UUIDv7.~/.omp/agent/history.dbdata · official · allSQLite prompt history.~/.omp/agent/agent.dbdata · official · allSQLite agent state database.
instructions
AGENTS.mdproject · official · allDiscovered by walking up from cwd; CLAUDE.md and other vendor files loaded via compatibility providers (claude, codex, gemini, cursor, opencode, and more)..omp/AGENTS.mdproject · official · all.omp/RULES.mdproject · official · allSticky always-apply rules.~/.omp/agent/AGENTS.mduser · official · allGlobal user-level instructions.~/.omp/agent/RULES.mduser · official · allGlobal sticky always-apply rules.~/.omp/agent/PERSONALITY.mduser · official · allOverrides the system prompt's personality block; replaces the configured personality preset.
skills
.omp/skills/project · official · allScanned in ancestor directories from cwd, closest first.~/.omp/agent/skills/user · official · all~/.omp/agent/managed-skills/user · official · allAuto-generated managed skills.
commands
.omp/commands/project · official · all~/.omp/agent/commands/user · official · allGlobal user-level prompt commands.
empty
hooks No known location. That is not the same as the feature being missing.
MCP servers
~/.omp/agent/mcp.jsonuser · json · standard · mcpServers.omp/mcp.jsonproject · json · standard · mcpServersDetection
envVars
OMP_PROFILEPI_CODING_AGENT_DIR
projectMarkers
.omp
Persistence
- YAML - config.yml configuration files. (official)
- JSON - settings.json and mcp.json. (official)
- JSONL - Session transcripts. (official)
- SQLite - Agent state, prompt history, model catalog (agent.db, history.db, models.db). (official)
syncAgentsFiles links ~/.omp/agent/AGENTS.md to the master bundle.