CLI & agents

CLI reference

The commoncompute command covers authentication, catalog discovery, quotes, submission, jobs, receipts, and account state.

bash

commoncompute login
commoncompute whoami
commoncompute workloads
commoncompute models
commoncompute quote mlx_llm --units 1 --model qwen3-4b --data-class public
commoncompute submit mlx_llm --payload '{"messages":[{"role":"user","content":"hello"}]}' --model qwen3-4b --data-class public --acknowledge-marketplace-risk --wait

Jobs and receipts

bash

commoncompute jobs list
commoncompute jobs get JOB_ID
commoncompute jobs wait JOB_ID
commoncompute jobs events JOB_ID
commoncompute receipts list
commoncompute receipts get RECEIPT_ID

Scripting

Use --json on data commands for machine-readable output
Use @file for a JSON payload file and @- to read JSON from stdin
Use --max-spend-usd to set a hard per-job ceiling