Melious
CLI

CLI Overview

Install the Melious CLI and start using AI from your terminal

Melious CLI

The Melious CLI brings AI inference directly to your terminal. Chat with models, review code with AI, generate images, and launch coding tools — all configured to route through the Melious API.


Installation

curl -fsSL https://cdn.melious.ai/install.sh | bash
irm https://cdn.melious.ai/install.ps1 | iex
curl -fsSL https://cdn.melious.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Installs to ~/.melious/bin/ — no sudo or admin required. The installer automatically adds the directory to your PATH.

Verify the installation:

melious version

Quick Start

Authenticate

Log in with your API key from melious.ai/account/api/keys:

melious auth login

The CLI will offer to open the API keys page in your browser, then prompt you to paste your key. It validates the key against the API before saving.

Send Your First Prompt

melious run "Explain quantum computing in one sentence"

Responses stream in real-time by default.

Launch a Coding Tool

melious launch

This starts your default coding tool (OpenCode by default) pre-configured with Melious API routing and your models.


Interactive Mode

Running melious with no subcommand launches the interactive TUI:

melious

The TUI shows your connection status, available model count, and provides a menu-driven interface for:

  • Running the setup wizard
  • Launching coding tools
  • Browsing models
  • Managing configuration
  • Checking for updates

This is the recommended entry point if you're new to the CLI.


Update

The CLI checks for updates automatically in the background (once per 24 hours). To update manually:

melious update

Check for updates without installing:

melious update --check

Uninstall

melious uninstall

The uninstaller prompts you to select what to remove:

  • The melious binary
  • Credentials (~/.melious/credentials.json)
  • Configuration (~/.melious/config.json)
  • Tool configs (~/.melious/tool-configs/)
  • Update cache
  • The entire ~/.melious/ directory

Use --yes to skip prompts and remove everything:

melious uninstall --yes

Next Steps

On this page