CLI
The briq command for humans, and for installing the MCP server into your clients.
The CLI ships as briq-cli with the binary briq. It is built with commander and
@clack/prompts, and talks to the same REST API as everything else.
npm install -g briq-cli
# or run without installing
npx briq-cli --helpAuthentication
briq login # browser-based, stores a session key in ~/.config/briq
briq keys create # mint an API key (or a sub-key with --parent) for the current team
export BRIQ_API_KEY=… # any command also accepts the key from the environmentCommands
| Command | What it does |
|---|---|
briq run <recipe | image> | Create and start a briq. --stack, --size, --ttl, --env K=V, --port |
briq ls | List briqs with state, size, image, cost and stop time |
briq exec <id> -- <cmd…> | Run a command inside a briq; --stdin pipes standard input |
briq logs <id> -f | Print logs; -f follows |
briq expose <id> <port> | Publish a port; --mode public|token |
briq stop <id> / briq start <id> | Stop keeps the disk; start resumes |
briq rm <id> | Destroy |
briq extend <id> --minutes 30 | Push stopsAt |
briq recipes | List the catalog with params and outputs |
briq quota | Remaining spend and concurrency for the key |
briq mcp install <client> | Write the MCP config for claude, cursor or codex |
Examples
briq run postgres
# bq_7kq2m9x1p4ab running postgres:16 small cost so far €0.00 stops at 18:42
# DATABASE_URL=postgres://postgres:…@db.s1.internal:5432/app
briq exec bq_7kq2m9x1p4ab -- psql -U postgres -c 'select version()'
briq logs bq_7kq2m9x1p4ab -f
briq rm bq_7kq2m9x1p4abbriq run ghcr.io/acme/api:pr-412 --stack checkout --port 3000 --env NODE_ENV=test
briq expose bq_9a2fk3m8q1zt 3000 --mode tokenInstalling the MCP server
briq mcp install claude # runs `claude mcp add briq --transport http …`
briq mcp install cursor # writes .cursor/mcp.json
briq mcp install codex # writes ~/.codex/config.tomlEach command prints what it wrote and where. The key is read from BRIQ_API_KEY or from your
login session.