Quickstart

1. Install

Choose one method from the installation guide. For Linux or macOS, the standalone installer is:

curl -sSfL https://compressi.us/install.sh | sh

For Windows, run in PowerShell:

iwr -useb https://compressi.us/install.ps1 | iex

The standalone installers run setup and ask whether to connect ready coding clients. Yes connects those listed. No leaves them on their direct connections and prints the commands for connecting later. If the terminal cannot read an answer, setup reports an error; open an interactive terminal and run cmx setup --ask-connect-ready.

2. Check the gateway and choose a client

cmx --version
cmx status
cmx harness list

If you declined automatic connection, list the providers discovered for your client, then connect one by its displayed ID:

cmx providers codex list
cmx providers codex connect api

For Codex, use api for its OpenAI API sign-in or chatgpt for its ChatGPT sign-in. Other clients have different IDs; see supported clients. You can also open cmx and choose CONFIG. cmx providers <client> list only reports status; it does not connect the client.

If you installed a package without running setup, run cmx setup --ask-connect-ready to make this choice. Plain cmx setup starts the gateway and may connect Codex’s existing sign-in.

3. Confirm a real request

Restart the coding client, then run:

cmx harness verify
cmx stats

Send a short request in the client and run cmx stats again. New activity shows that requests are reaching CMX. A running gateway or a successful harness verify alone does not prove the client sent traffic.

4. Return to a direct connection

cmx providers codex disconnect api

Use the provider ID you connected. For all supported clients, cmx stop restores direct routing before stopping the gateway. A later cmx start may reconnect routes that stop saved; use the provider disconnect command or cmx harness disable <client> when you want to stay direct. See Undo and uninstall.