MINARATerminal (CLI)
The minara terminal commands. Chat opens the REPL; every other subcommand runs once and exits.
Chat is the default. Both minara (bare) and minara chat drop straight
into the interactive REPL. Every other subcommand runs once and exits.
For the /commands you type inside chat (the REPL or the Web UI chat
box), see Slash Commands.
Running the CLI
minaraSubcommands
| Command | What it does |
|---|---|
minara / minara chat | Start the interactive REPL (default entry). |
minara setup / minara init | First-run wizard: provider + Minara login + workspace scaffold + doctor. |
minara serve [--ui] [-p <port>] [--daemon|--status|--stop] | Run the HTTP gateway. --ui co-launches the Web UI in your browser; --daemon detaches it. |
minara research <topic> [--mode light|heavy] | Run the deep-research pipeline without entering the REPL. |
minara institution <action> | Institution Mode batch operations: history, finalize, reflect, reflect-pending. |
minara agents <action> | Manage custom agents: list, get, create, run, archive, export, import. |
minara profile <action> | View or set your trading profile, risk tags, and custom prompt. |
minara preferences <action> | Review learned preferences: pending, list, show, approve, reject (alias prefs). |
minara learning <action> | Inspect the self-optimization loop: stats, tune-methodology. |
minara skills {list|add|upgrade|remove} | Manage installed external skill packages. |
minara scenarios {pending|list|approve|reject} | Manage learned scenarios (requires SCENARIO_LEARNING=1). |
minara model {list|use <id>|show} | Inspect or switch the active LLM model. |
minara tools {list|show <name>} | Enumerate tools or dump a tool's schema. |
minara config {list|path|get|set} | Read or write safety.json and financial-profile.json. |
minara gateway {list|add|test|remove} [provider] | Configure outbound messaging channels. |
minara memory export [<out>] [--sign] | Snapshot learned memory to a markdown tree. |
minara memory import <in> [--apply] | Round-trip the markdown tree back in. |
minara login <provider> / minara logout <provider> | Sign in to or out of a provider (minara, openai, anthropic, openrouter, xai). |
minara auth status | Show all configured auth profiles. |
minara doctor [--fix] | Health check; --fix runs idempotent maintenance. |
minara update | Update Minara to the latest version. |
minara migrate | Initialize or migrate the SQLite schema. |
Maintainer-only commands (script-risk, btc-cycle, compression-stats)
live in the full CLI reference.