Reference tables for omp CLI subcommands, launch flags, slash commands, keybindings, internal URL schemes and file locations. Run /hotkeys and /settings for live truth on your install.
CLI subcommands
| Command | Effect |
|---|---|
omp | the TUI (bare = launch) |
omp acp | run as an ACP server over stdio (Zed) |
omp agents | manage bundled task agents |
omp auth-broker / omp auth-gateway | credential vault / forward proxy |
omp bench | benchmark models: TTFT, tokens/s, cache workloads |
omp browser-relay | local CDP relay so the browser tool drives your own Chrome tabs |
omp cleanse | detect and fix project diagnostics with weighted parallel subagents |
omp commit | generate a commit message and update changelogs |
omp completions <shell> | print a completion script (bash, zsh, fish) |
omp compress | rewrite a text file into the dense prompt register |
omp config <list/get/set/reset/path> | manage settings |
omp gallery | preview tool renderers |
omp gc | storage garbage collection; dry run until --apply |
omp git | fullscreen git UI: split diff, staging, commit composer |
omp grievances | view/clean/push reported tool issues |
omp images | inspect and purge image publication backends |
omp install | install or link an extension package |
omp join "<link>" | join a shared collab session |
omp models | list, search, refresh available models |
omp plugin <...> | install, uninstall, list, marketplace |
omp ps | list and control daemon-supervised background processes |
omp read <path/url> | show what the read tool returns for a path or internal URI |
omp render | replay a session through the transcript pipeline |
omp say | local text-to-speech |
omp search | test web-search providers |
omp setup | onboarding; install optional dependencies |
omp share | share a saved session as an encrypted link |
omp shell | interactive shell console |
omp ssh | manage SSH host configurations |
omp stats | local usage dashboard over ~/.omp/stats.db (-s summary, -j JSON) |
omp tiny-models | download tiny local models (titles, memory) |
omp token | get the API key or OAuth token for a provider |
omp ttsr | inspect and test time-traveling stream rules |
omp update | check for and install updates |
omp usage | provider usage limits for every authed account |
omp worktree / omp wt | list or clear agent-managed worktrees (~/.omp/wt) |
Live list snapshot: data/subcommands.txt; version pin: data/version.txt. omp --help has the remaining flags.
Launch flags
| Flag | Effect |
|---|---|
-p / --print | non-interactive: answer one prompt and exit |
--mode <text/json/rpc/rpc-ui> | output mode; pair json with -p for scripting |
--model <selector> | fuzzy: opus, gpt-5.2, openai/gpt-5.2 |
--smol / --slow / --plan | override that role’s model; --plan is not plan mode |
--thinking <off..max/auto> | reasoning level for the session |
--approval-mode <always-ask/write/yolo> | override tools.approvalMode for this session |
--auto-approve | force yolo for this session |
--tools read,edit,bash | pin the enabled tool set; unknown names hard-error |
-c / -r [id] | continue latest in this cwd / resume by id or picker |
--from-claude / --from-codex | import a Claude Code or Codex session, history intact |
--config <path> | overlay an extra config file; repeatable |
--add-dir <dir> | extra workspace root; repeatable |
--max-time <10m> | hard stop after this duration |
--plan-yolo / --plan-yolo-into <sel> | plan read-only, auto-approve, implement on another model |
--prewalk / --no-prewalk | demote to a cheap model at first edit once a plan exists |
--profile <name> | isolated profile for auth, sessions, settings, caches |
--no-session / --no-tools / --no-lsp | ephemeral / no tools / no LSP |
@path | attach a file to the first message: omp @spec.md "do it" |
Slash commands
| Group | Commands |
|---|---|
| Model and effort | /model /models /switch /fast /prewalk |
| Modes | /plan /plan-review /vibe /goal /guided-goal /loop /pause /force |
| Review | /review /advisor on/off/status/dump/configure |
| Agents and jobs | /agents /jobs /tan /btw /queue |
| Context | /context /compact /shake /handoff /memory view/stats/diagnose/clear/enqueue |
| Session | /new /clear /reset /fresh /drop /resume /fork /branch /tree /rename /retry |
| Share | /collab /join /leave /share /export /copy |
| Rules and plugins | /omfg /extensions /plugins /reload-plugins /marketplace /skill:<name> |
| Integrations | /mcp add/list/test/reconnect/reload /ssh /login /logout /browser /live |
| Info | /hotkeys /tools /settings /providers /usage /stats /changelog /todo /debug /exit |
/vibe,/goal,/loopare session modes: they stay on until toggled off./tanruns a full background agent on tangential work./btwasks an ephemeral side question without polluting context.
Keybindings
Remaps live in ~/.omp/agent/keybindings.yml, not config.yml.
| Chord | Effect |
|---|---|
Ctrl+P / Shift+Ctrl+P | cycle role models forward / back |
Alt+M | model selector, assign roles |
Alt+P | pick a model for this session only |
Alt+Shift+P | toggle plan mode |
Shift+Tab | cycle thinking level |
Ctrl+T | show/hide thinking blocks |
Ctrl+O | expand tool output |
Ctrl+G | edit the draft in $EDITOR |
Ctrl+Q / Ctrl+Enter | queue a follow-up |
Alt+Up | pull a queued message back |
Alt+R | retry the last failed turn |
Alt+A | open the agent hub |
Ctrl+R | search prompt history |
Ctrl+V | paste image |
Esc / Ctrl+C / Ctrl+D | interrupt / clear / exit |
hold Space | push-to-talk speech-to-text |
Internal URL schemes
read accepts all of these.
| Scheme | Example | Returns |
|---|---|---|
pr:// | pr://1428, pr://owner/repo/1428/diff/all | a PR as a path; /diff lists files |
issue:// | issue://42, issue://?state=open&label=bug | an issue, or a live list |
agent:// | agent://Scout/findings.0.path | a subagent’s output; JSON path addressing |
history:// | history://Scout | that subagent’s transcript |
local:// | local://ctx.md | session-local scratch; where plans live |
skill:// | skill://pdf/references/tables.md | a skill’s files |
rule:// | rule://no-box-leak | a rule’s body, on demand |
conflict:// | write conflict://1 with @theirs | resolve one merge conflict |
xd:// | read xd:// | the device shelf: list deferred tools |
ssh:// | read ssh://prod/var/log/app.log | a file on a configured SSH host |
Where files live
| What | User | Project |
|---|---|---|
| Settings | ~/.omp/agent/config.yml | <cwd>/.omp/config.yml (cwd only, no walk-up) |
| Context | ~/.omp/agent/AGENTS.md | .omp/AGENTS.md (nearest ancestor) |
| Sticky rules | ~/.omp/agent/RULES.md | .omp/RULES.md (nearest ancestor) |
| TTSR / rulebook | .omp/rules/*.md | |
| Agents | ~/.omp/agent/agents/*.md | .omp/agents/*.md |
| Skills | ~/.omp/agent/skills/<n>/SKILL.md | .omp/skills/<n>/SKILL.md |
| Commands | ~/.omp/agent/commands/*.md | .omp/commands/*.md |
| Extensions | ~/.omp/agent/extensions/ | .omp/extensions/ |
| MCP | ~/.omp/agent/mcp.json | .omp/mcp.json |
| Advisor roster | ~/.omp/agent/WATCHDOG.yml | WATCHDOG.yml (every ancestor) |
| Keybindings | ~/.omp/agent/keybindings.yml | |
| Sessions | ~/.omp/agent/sessions/ | |
| Worktrees | ~/.omp/wt |
See also: Settings, Getting started, Traps, Tips, Multi-agent.
Condensed from the omp guide by Hugo Lopes (MIT). Verify against your install:
omp config list.