Routes each task to the optimal model, runs adversarial multi-model debates for high-stakes decisions, and persists behavioral memory across sessions. Bring your own API keys. Total cost: ~$5/month.

Quick Start

Install

Recommended — install globally via NPM (requires Node.js ≥ 20) or Bun (requires Bun ≥ 1.x):

Using NPM:

npm install -g muonroi-cli

Using Bun:

bun add -g muonroi-cli

Once installed, run:

muonroi-cli

Alternative — Prebuilt standalone binary (requires access to the GitHub repository):

Linux / macOS:

# Note: Requires github authorization if the repository is private
curl -fsSL https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.sh | bash

Windows PowerShell:

# Note: Requires github authorization if the repository is private
irm https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.ps1 | iex

The installers download a bun --compile binary from GitHub Releases — single executable, all native deps bundled, no Node/Bun/build tools required.

First run

On first launch the CLI shows a wizard that:

1. Lists supported providers (currently DeepSeek and SiliconFlow).
2. Offers four ways to add credentials: paste an API key, import an encrypted bundle (keys export/keys import), sync from Bitwarden, or skip and add later via /providers inside the TUI.

After setup, role routing auto-balances across enabled providers:

// ~/.muonroi-cli/user-settings.json (generated by the wizard — edit if needed)
{
  "defaultProvider": "deepseek",
  "providers": {
    "deepseek":    { "enabled": true },
    "siliconflow": { "enabled": true }
  },
  "roleModels": {
    "leader":    "deepseek-v4-pro",
    "implement": "deepseek-v4-flash",
    "verify":    "deepseek-v4-pro",
    "research":  "deepseek-v4-flash"
  }
}

Moving keys between devices

# Source device — encrypts every stored key into one passphrase-protected file
muonroi-cli keys export ~/muonroi-keys.json

# Move the file via any channel (USB, Drive, AirDrop, email...)

# Target device — same passphrase rehydrates the OS keychain
muonroi-cli keys import ~/muonroi-keys.json

Inside the TUI press /providers then B to sync directly from a Bitwarden vault instead.

Updates

The CLI checks npm once per day on startup and prompts when a newer version is available. Set autoUpdate: true in user-settings.json to skip the prompt and update silently. Manual: muonroi-cli update.

Documentation

Full documentation at docs.muonroi.com/docs/cli

| Topic | Link | |---|---| | Overview & architecture | CLI Overview | | Multi-Model Council | Council Debate Guide | | Prompt Intelligence Layer | PIL Pipeline Guide | | Experience Engine | Experience Engine Guide | | Agent Harness | Agent Harness Guide | | Settings reference | CLI Settings Reference | | Commands reference | Commands Reference | | Providers reference | Providers Reference |

Development

git clone https://github.com/muonroi/muonroi-cli.git
cd muonroi-cli && bun install

bun run dev           # run from source
bun run typecheck     # type check
bun run test          # vitest
bun run lint          # biome check
bun run build:binary  # standalone binary

License

MIT