CLI
Command Reference
Complete reference for all Melious CLI commands, flags, and configuration
| Command | Description |
|---|
melious auth login | Set up authentication (interactive) |
melious auth status | Show authentication status |
melious auth logout | Remove credentials |
| Command | Description |
|---|
melious config show | Show full configuration |
melious config get <key> | Read a config value |
melious config set <key> <value> | Set a config value |
melious config edit | Open config in editor |
melious config reset | Reset to defaults |
| Command | Description |
|---|
melious models | List available models |
melious models info <model-id> | Show model details |
Flags for melious models:
| Flag | Type | Default | Description |
|---|
--category | string | — | Filter: chat, embedding, image, tts, stt |
--sort | string | name | Sort by: name, context |
See the full model catalog at Models or browse melious.ai/hub.
| Command | Description |
|---|
melious run [prompt] | Send a prompt to the API |
melious run -i | Interactive chat mode |
See Chat & Prompts for all flags and examples.
| Command | Description |
|---|
melious diff | Review unstaged changes |
melious diff --staged | Review staged changes |
melious diff <ref> | Review a branch comparison or commit |
See Code Review for all flags and examples.
| Command | Description |
|---|
melious image [prompt] | Generate an image from a text prompt |
See Image Generation for all flags and examples.
| Command | Description |
|---|
melious launch [tool] | Start a coding tool with Melious |
See Coding Tools for all flags, tool details, and examples.
| Command | Description |
|---|
melious tools | Show status of supported tools |
melious tools install [tool] | Install a coding tool (--all for all) |
melious tools check | Check tools and prerequisites |
melious tools update [tool] | Update installed tool(s) |
melious tools info <tool> | Show tool details |
melious tools model <tool> [model] | Get or set per-tool model override |
melious tools diagnose [tool] | Run diagnostics and offer fixes |
melious tools fix-path | Add tool directories to PATH |
See Managing Tools for details.
| Command | Description |
|---|
melious usage | Show usage summary |
melious usage history | Show recent usage history |
melious usage keys | Show per-API-key breakdown |
melious usage env | Show environmental impact |
See Usage & Impact for details.
| Command | Description |
|---|
melious ping | Test API connection (shows latency and model count) |
melious version | Show version (--verbose for build details) |
melious update | Update the CLI (--check to only check) |
melious uninstall | Remove melious from your system (--yes to skip prompts) |
melious setup | Re-run the full setup wizard |
melious completion <shell> | Generate shell completions |
These flags work with every command:
| Flag | Type | Default | Description |
|---|
--api-key | string | — | API key for this invocation |
--json | bool | false | JSON output (where supported) |
--no-color | bool | false | Disable colored output |
--verbose | bool | false | Verbose output |
--quiet | bool | false | Minimal output |
| Variable | Description |
|---|
MELIOUS_API_KEY | API key (takes precedence over credentials file) |
NO_COLOR | Disable colored output (no-color.org) |
VISUAL | Preferred editor for config edit |
EDITOR | Fallback editor for config edit |
These are set automatically when you use melious launch:
| Variable | Set by | Description |
|---|
OPENCODE_CONFIG | OpenCode | Path to generated OpenCode config |
ANTHROPIC_BASE_URL | Claude Code | Melious API base URL |
ANTHROPIC_AUTH_TOKEN | Claude Code | API key as Bearer token |
ANTHROPIC_MODEL | Claude Code | Main model |
ANTHROPIC_SMALL_FAST_MODEL | Claude Code | Lightweight model |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | Claude Code | Disables telemetry |
API_TIMEOUT_MS | Claude Code | Request timeout (3000000ms) |
VIBE_HOME | Vibe | Path to Vibe config directory |
| Preset | Description |
|---|
balanced | Default. Balanced cost, speed, and quality |
speed | Prioritize low latency |
price | Prioritize lowest cost |
eco | Prioritize renewable energy and low carbon |
Applied via --preset flag or defaults.preset config. Internally adds a suffix to the model ID (e.g., model:speed).
Generate completion scripts for your shell:
# Add to ~/.bashrc for persistent completions
melious completion bash >> ~/.bashrc
source ~/.bashrc
# Enable completions if not already
echo "autoload -U compinit; compinit" >> ~/.zshrc
# Install completion
melious completion zsh > "${fpath[1]}/_melious"
source ~/.zshrc
melious completion fish > ~/.config/fish/completions/melious.fish
# Add to $PROFILE for persistent completions
melious completion powershell >> $PROFILE
Completions are context-aware — model names, preset names, and tool names are completed dynamically.
| Path | Contents |
|---|
~/.melious/ | Melious CLI data directory |
~/.melious/bin/melious | CLI binary |
~/.melious/config.json | Configuration |
~/.melious/credentials.json | API key and auth data |
~/.melious/tool-configs/ | Per-tool generated configs |
~/.melious/update-state.json | Cached update check state |
