Skip to main content
Use the airmux CLI to sign in to a deployment and manage its resources. Install it with uv:

Sign in

Start the browser sign-in flow for your deployment:
The CLI prints a code and opens a browser. Complete sign-in there, then return to the terminal. If the machine has no browser, add --no-browser and open the printed URL yourself. Check the saved context and connection:
status shows the active organization and workspace. Select a different saved organization profile with airmux profiles use <profile>; switch organization with airmux orgs switch <organization> and workspace with airmux workspaces use <workspace>.

Manage a workspace

Create a workspace, then select it for subsequent commands:
Add a provider credential. The command prompts for the secret, so it does not need to appear in shell history:
Create an inference key for applications. Copy the secret when it is printed; it is shown only once:
List policies and recent usage events:
Commands that return resources accept -f json for scripting and -f table for terminal output. For example:
Run airmux <group> <command> --help for command options. See the CLI reference for authentication contexts, output formats, and the full command list.