Installation

Install CompressiusMaximus on Linux, macOS, or Windows.

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

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.

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

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.

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

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

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.

Last updated Sep 1, 2026