Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content
Minima CLI

Installation

The minima harness is distributed as a self-contained native binary through the mubit-ai/homebrew-minima Homebrew tap. Install it, authenticate, and start.

Prerequisites

  • Homebrew (macOS or Linux).
  • A Mubit API key (MUBIT_API_KEY) — routing + memory-backend auth. Get one from the Mubit console, or run minima auth (see below) to have it created and stored for you.
  • At least one LLM provider key — the harness runs the model itself, so you need a key for whichever provider(s) you want to call: OpenAI, Anthropic, Google Gemini, DeepSeek, xAI, Groq, or OpenRouter. Local runtimes (Ollama, vLLM, LM Studio) need no key.

Install with Homebrew

brew install mubit-ai/minima/minima

That taps mubit-ai/homebrew-minima and installs the minima formula in one step. Prefer to tap explicitly? It's equivalent to:

brew tap mubit-ai/minima
brew install minima

Verify it's on your PATH, and upgrade later with Homebrew:

minima --help
brew upgrade minima      # pull the latest release
ℹ️Note

The Homebrew formula ships the compiled binary, which bundles no OS keychain module — so credentials fall back to a ~/.minima-harness/config.env file (mode 0600). See Configuration.

Build from source (for development)

Contributing to the harness? Build the binary yourself from the packages/tui workspace with Bun ≥ 1.2:

cd packages/tui
bun install
bun test          # hermetic test suite (no network, no keys)
bun run check     # tsc --noEmit
bun run lint      # biome
bun run build     # -> dist/minima (a self-contained native binary)
./dist/minima --help

Put dist/minima on your PATH (or symlink it) to invoke it as minima from any repo.

First-time setup

Pick one of the two paths below.

Recommended — browser login

minima auth opens your browser, signs you in to Mubit, provisions a Mubit project scoped to the current repo, stores your MUBIT_API_KEY, and records the project mapping for per-repo memory isolation. Already running the TUI? The /auth slash command runs the same flow.

cd your-repo
minima auth
# Opens the browser to authorize; on success stores MUBIT_API_KEY (+ MINIMA_URL)
# and writes the repo → project mapping to ~/.minima-harness/projects.json
ℹ️Note

minima auth accepts --region eu|us to choose a Mubit region. The console URL defaults to https://console.mubit.ai and can be overridden with MUBIT_CONSOLE_URL.

Manual — set credentials directly

If you already have keys, store them with minima config:

minima config set MUBIT_API_KEY   mbt_…
minima config set OPENAI_API_KEY  sk-…
# or ANTHROPIC_API_KEY / GEMINI_API_KEY / DEEPSEEK_API_KEY / …

Secrets go to your OS keychain when available, otherwise to ~/.minima-harness/config.env (mode 0600). See Configuration for the full precedence rules and every key.

Start

minima            # interactive TUI (default)
minima -p "explain this repo"          # one-shot answer, then exit
minima --mode json "refactor foo" | jq # machine-readable event stream
💡Tip

MUBIT_API_KEY (routing) plus one provider key is enough to start. From there, --offline bypasses the recommender and --model / --provider pin a specific model. See CLI usage.