Skip to main content
The Blacksmith CLI is the programmatic way to pull your organization’s usage and cost data: billable minutes, estimated spend, and storage costs, broken down by day, repository, workflow, job, or runner type. Every command outputs JSON by default, so you can pipe results into jq, spreadsheets, dashboards, or your internal cost reporting and chargeback workflows without scraping the dashboard. For scripts and CI, authenticate with an organization token instead of a personal login.

​
blacksmith usage

Billing-oriented Actions usage for the authenticated organization: jobs, billable minutes, billing minutes, runtime minutes, estimated cost, daily totals, and requested breakdowns.

​
blacksmith usage storage

Sticky disk storage usage for a time range: current/peak/average GB, GB-hours, and estimated cost from the hourly storage billing ledger.

​
blacksmith runners catalog

Lists every Blacksmith runner SKU as a deterministic table of metadata: label, vCPUs, memory, architecture, OS, and cost per minute.