Installation

cmx is a single static binary with no runtime dependencies (SQLite is embedded). Everything runs locally.

Linux / macOS

curl -fsSL https://cmx.llm.kiwi/install.sh | bash

The installer downloads the latest release archive, verifies its SHA-256 checksum and installs the binary to ~/.local/bin/cmx.

Windows (PowerShell)

irm https://cmx.llm.kiwi/install.ps1 | iex

Installs to %USERPROFILE%\.local\bin\cmx.exe.

Verify:

cmx version

Private releases

Releases are distributed from the project’s GitHub releases. If the repository is private, set CMX_GITHUB_TOKEN before running the installer.

Requirements

• A harness that can point a provider at a custom baseURL (OpenCode, Claude Code, Codex, …)
• That’s it — no Node, no Python, no external DB

Where things live

Path	Purpose
~/.local/bin/cmx	binary (Windows: %USERPROFILE%\.local\bin\cmx.exe)
~/.config/cmx/config.json	configuration
~/.local/share/cmx/cmx.sqlite	sessions, summaries, request stats
~/.local/state/cmx/	runtime state (pid, update cache, logs)

On Windows the equivalents live under %AppData%\cmx, %LocalAppData%\cmx and %LocalAppData%\cmx\state.

Uninstall

Linux / macOS

cmx stop
rm ~/.local/bin/cmx
rm -rf ~/.config/cmx ~/.local/share/cmx ~/.local/state/cmx

Windows (PowerShell)

cmx stop
Remove-Item "$env:USERPROFILE\.local\bin\cmx.exe"
Remove-Item -Recurse -Force "$env:AppData\cmx", "$env:LocalAppData\cmx"

Updating

cmx checks for a newer release at most once every 24 hours and prints a notice when one is available. To upgrade on demand:

cmx upgrade       # confirm, stop daemon, replace binary, restart
cmx upgrade -y    # no confirmation prompt

Set CMX_NO_UPDATE_CHECK=1 to disable update checks entirely.