omm help
Show omm's own help — a short command summary by default, or the full reference with --all.
01 / 07
Overview
Reach for help the same way you'd reach for --help — it's the same content, just as its own subcommand so it composes with a command name (omm help search shows exactly what omm search --help would). Bare omm help shows the short, curated list you see below; --all expands it to every command omm has, and --all --flags adds each one's full option list.
02 / 07
Options
Every flag this command accepts, and what it defaults to when you leave it out.
[command]—Default: none — shows general helpShow full --help output for this one subcommand instead of the summary.
--all—Default: offList every command omm has, not just the commonly used ones.
--flags—Default: offWith --all, also print each command's complete flag list.
03 / 07
Examples
From a plain search to something you'd put in a script.
The short, curated command summary.
$ omm helpFull --help output for one command.
$ omm help searchEvery command omm has, one line each.
$ omm help --allEvery command, with its complete option list.
$ omm help --all --flags04 / 07
A real run
Real omm help capture, 2026-08-24, this dev machine.
06 / 07
If something goes wrong
Every message below is one this command actually prints. Find yours, read why it happened, then do the last line.
No such command 'zzzz-not-a-real-command'. See `omm help`.- why
- There's no subcommand by this name — usually a typo, or a command that exists under an alias (rm, ls, up) instead of the name given.
- what to do
- Run omm help --all to see every real command name.
- source
- src/omm/cli.py:795-796
Still stuck? Open an issue with the exact message you saw.
07 / 07
CLI reference
Exactly what omm help --help prints, exported from the CLI source.
Usage
omm help [OPTIONS] [command]Arguments
commandoptionalShow help for a specific subcommand.
Options
--allDefault: —List every command, not just the common ones.
--flagsDefault: —Also show each listed command's option list (the common commands, or every command with --all).
Shared flags
Every omm command also accepts --json, --no-color, --quiet, -q, --yes, -y, so they are listed here once instead of on each command.
Exported from omm 0.3.101.
All commands
- omm searchFind a model across the curated catalog, HuggingFace and ModelScope.
- omm installDownload a model into the hub and link it into every installed runner.
- omm runChat with an installed model — in the terminal for Ollama, or by opening the app for GUI runners.
- omm recommendGet a model suggestion ranked for this machine's hardware, with an offer to install it.
- omm contributeBenchmark models in a loop, uploading telemetry to improve recommend for hardware like yours.
- omm setupRe-run the hardware scan and runner-install checklist, any time.
- omm scanPrint this machine's hardware, detected runners, and models — no flags needed.
- omm tuneGet recommended context length, GPU offload, threads, and batch size for a model.
- omm fitSee whether a model fits this machine's free memory right now, installed or not.
- omm importAdopt .gguf files sitting in other apps' model directories into the omm hub.
- omm uninstallRemove a model and clean up its symlinks and manifests. Alias: rm.
- omm listShow every model omm has installed and which runners each is linked into. Alias: ls.
- omm infoShow full detail — repo, version, size, links, run commands — for one installed model.
- omm upgradeRefresh installed models against their source — only re-downloads what's actually changed. Alias: up.
- omm linkRe-verify and repair every installed model's runner links, or link into a custom directory.
- omm cleanupClean up leftover partial downloads and broken runner symlinks in one pass — no flags needed.
- omm verifyProve that an installed model actually loads and generates text on this machine.
- omm benchmarkLocal quality and speed smoke evidence for one or more installed models.
- omm updateReinstall omm from the latest source and refresh its recommendation data.
- omm settingView or change omm's settings — telemetry, outbound data, theme, update channel, and more.
- omm doctorDiagnose the omm install and Ollama links, read-only — no flags needed.
- omm engine installInstall one local AI runner program directly, skipping the setup checklist.
- omm logRead the local run log: what omm ran, when, and whether it worked.
- README — UsageEvery omm command, one line each.