omp

⚡ OMP CLI Cheat Sheet

Operator mental model and command/flag reference for the OMP (`π`) runtime.

OMP is the compiled single-file agent at ~/.local/bin/omp; the prompt shows π. It is not oh-my-posh.

Correct startup#

cd /home/mc
omp --allow-home

Why: stable working directory, predictable /home/mc/.env loading, and plugin child sessions that do not drift into temp dirs.

Flag	Purpose
`--model`	Main model selector/fuzzy alias.
`--smol`, `--slow`, `--plan`	Fast, reasoning, and planning model choices.
`--thinking`	Reasoning level: `minimal`, `low`, `medium`, `high`, `xhigh`.
`--allow-home`	Stay in `~`; avoid temporary workspace switching.
`-p`, `--print`	Non-interactive run and exit.
`-c`, `--continue`; `-r`, `--resume`	Continue/resume a prior session.
`--session-dir`, `--no-session`	Storage directory or ephemeral run.
`--mode`	`text`, `json`, `rpc`, or `rpc-ui`.
`--auto-approve`, `--approval-mode`	Approval behavior; use carefully.
`--no-tools`, `--tools`	Disable or allowlist tools.
`--no-lsp`, `--no-pty`	Disable code intelligence or interactive PTY support.
`--no-skills`, `--skills`	Disable or filter skills.

Command	Use
`config`	Settings.
`plugin` / `install`	Manage and install plugins.
`update` / `setup`	Self-update and onboarding.
`agents`	Bundled task agents.
`auth-broker` / `auth-gateway`	Credential vault/proxy surfaces.
`worktree`	Manage OMP worktrees.
`commit`	Commit message/changelog helper.
`stats`	Usage stats.
`acp`, `ssh`, `shell`	ACP server, SSH, console helpers.
`completions`	Shell completions.

Trap	Fix
`tmux omp --allow-home`	Start `tmux` alone, then run `omp --allow-home` inside it.
Discord launcher secret added after OMP boot	Restart OMP so config is reread.

Sources: docs/omp-coms.md, docs/omp-pi-plugin-cheatsheet.md.