CLI

The infragrid CLI ships with the TypeScript SDK package and uses the same public REST API.

The CLI becomes available through npm when @infragrid/sdk is published. From a source checkout, build the SDK and run node packages/sdk/bin/infragrid.mjs.

Configure

export INFRAGRID_API_KEY="ig_live_..."

Set INFRAGRID_API_URL only for an explicitly selected preview API. The CLI falls back to INFRAGRID_BASE_URL for SDK compatibility.

Commands

infragrid run "Open example.com and summarize the page"
infragrid get <run-id>
infragrid list
infragrid cancel <run-id>

Command	Behavior
`run "task"`	Creates a free-form task, prints progress to stderr, waits, and writes final JSON to stdout
`get <run-id>`	Writes one run as JSON
`list`	Writes the default bounded run list
`cancel <run-id>`	Cancels a run and writes its state

The run command exits successfully only when the terminal status is completed. Other command failures and non-completed task outcomes use a nonzero exit code.

Shell automation

Because progress goes to stderr and resources go to stdout, scripts can capture the final JSON without losing human-readable status:

result="$(infragrid run "Summarize example.com")"
status="$(printf '%s' "$result" | jq -r '.status')"

The current CLI starts free-form browser tasks. Use the SDK or REST API for ordered workflows and published Blueprint lifecycle operations.

Last modified on August 16, 2026

SDKs

Agent tools

Configure

Commands

Shell automation

​Configure

​Commands

​Shell automation

Configure

Commands

Shell automation