CLI Installation

The ironq CLI interacts with the on-chain program directly from the terminal.

Install from crates.io

cargo install ironq-cli

Build from Source

cd ironq
cargo build -p ironq-cli --release
# Binary at target/release/ironq

Configuration

The CLI reads configuration from multiple sources (in priority order):

1. CLI flags (highest priority)
2. .ironq.toml in the current directory or ~/.config/ironq/config.toml
3. Solana CLI config (~/.config/solana/cli/config.yml)

Global Flags

--json                     Output as JSON for programmatic consumption
--cluster <URL>            Override Solana RPC URL
--keypair <PATH>           Override wallet keypair path
--queue-authority <PUBKEY> Use another authority's queue
--yes                      Skip confirmation prompts
--dry-run                  Simulate without sending
--decimals <N>             Token decimal places for display
--verbose                  Verbose output

JSON Output

Every command supports --json for scripting:

ironq --json status | jq '.total_jobs_created'
ironq --json job list --status open | jq '.[].job_id'