CLI · oino

Usage: oino [options] [--] [@files...] [messages...]. Multi-letter short flags combine (-nbt), unknown long flags are passed to extensions, and print mode is implied when stdio is not a TTY.

Modes and basics#

Flag	Effect
`--mode <mode>`	`text` (default), `json`, `rpc`, `acp`
`-p, --print`	process the prompt and exit
`--tui-mode <mode>`	`fullscreen` (default) or `regular` (keep terminal scrollback)
`-v, --version`, `-h, --help`	version, help
`--verbose`	verbose startup (overrides `quietStartup`)

Models#

Flag	Effect
`--model <pattern>`	`provider/id`, bare id or fuzzy pattern, optional `:thinking` suffix
`--provider <name>`	narrow the model search
`--models <patterns>`	scoped model list, cycled with `ctrl+p`; globs work
`--thinking <level>`	`off`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`
`--api-key <key>`	credential for this run (with `--model`)
`--list-models [search]`	list available models, optionally fuzzy-filtered
`--offline`	no startup network operations

Sessions#

Flag	Effect
`-c, --continue`	continue the most recent session in this directory
`-r, --resume`	pick a session to resume
`--session <path\|id>`	open a session file or partial id
`--session-id <id>`	open or create a session with this exact id
`--fork <path\|id>`	fork a session into a new file
`--no-session`	ephemeral session, nothing written
`-n, --name <name>`	display name
`--session-dir <dir>`	session storage directory
`--export <file> [out.html]`	export a session to HTML and exit

Prompting and tools#

Flag	Effect
`--system-prompt <text>`	replace the system prompt
`--append-system-prompt <text>`	append text or a file (repeatable)
`-t, --tools <tools>`	tool allowlist (`+name`/`-name` entries adjust the defaults)
`-xt, --exclude-tools <tools>`	tool denylist
`-nt`	no tools at all
`-nbt`	no built-in tools, extension tools stay
`-nc`	no `AGENTS.md`/`CLAUDE.md` discovery

Extensions and resources#

Flag	Effect
`-e, --extension <path>`	load a package directory (repeatable); `builtin:<name>` loads test components
`-ne, --no-extensions`	skip discovered extensions (providers stay, `-e` still loads)
`--exclude-extension <id>`	drop composed packages by id (repeatable, comma-separated)
`--skill <path>`	load a skill (repeatable); `-ns` disables discovery
`--prompt-template <path>`	load a template (repeatable); `-np` disables discovery
`--theme <path>`	load a theme (repeatable); `--no-themes` disables discovery
`--use-theme <name>`	initial theme for this run

Projects#

Flag	Effect
`-a, --approve`	trust project-local files for this run
`-na, --no-approve`	ignore project-local files for this run
`--agent-dir <dir>`	configuration directory
`--remote <url>`	interactive mode over a remote session (`oino://host:port?token=...`; not implemented yet)

Subcommands#

output

oino install <source> [-l] [-y]   install a package (dir, archive, URL, git+https)
oino remove <id> [-l]             remove an installed package (alias: uninstall)
oino update [--check]             update the oino binary from the latest release
oino update <id>|--extensions     reinstall packages from their recorded source
oino list                         list distribution, installed and project packages
oino config                       print the settings.json paths
oino auth <command>               print credentials or check provider readiness
oino serve                        serve sessions to remote clients (not implemented yet)

-l/--project targets the project scope instead of global.