# firectl (Fireworks CLI) **firectl** is the official command-line interface for [[Fireworks AI]]. It lets developers create, deploy, and manage Fireworks resources (models, deployments, fine-tuning jobs, datasets, deployed LoRAs, accounts) without leaving the terminal. ## Why it matters The Fireworks web console is fine for clicking around. Anything repeatable; CI/CD pipelines, deployment automation, fine-tuning workflows, multi-environment setups; needs a CLI. firectl is that surface. It's also what you reach for to script anything against Fireworks infrastructure that you'd otherwise do by hand. ## Installation Cross-platform; macOS, Linux, Windows. - **Homebrew** (recommended on macOS): `brew tap fw-ai/firectl && brew install firectl` - **Manual binary download** for macOS (Apple Silicon and x86_64), Linux x86_64, and Windows 64-bit - **Self-upgrade**: `sudo firectl upgrade` ## Authentication 1. `firectl signin`; opens a browser flow to authenticate against your Fireworks account 2. For Custom SSO, pass `--account-id <id>` 3. `firectl whoami`; verifies which account is currently active Credentials are cached locally; signin is a one-time setup per machine. ## Core capabilities - **Resource lifecycle**; create, list, get, update, and delete Fireworks resources from the terminal - **Model deployments**; deploy open-weights or fine-tuned models behind serverless or dedicated endpoints - **Fine-tuning**; launch and monitor fine-tuning jobs - **Account management**; switch accounts, check version, upgrade the binary ## Typical use cases - Scripted, reproducible deployments instead of clicking through the dashboard - CI/CD pipelines that deploy or update models on push - Fine-tuning workflows where job configuration lives in version control - Multi-environment setups (dev / staging / prod) with distinct deployments ## Who it's for Developers and DevOps/MLOps engineers who treat Fireworks infrastructure as part of an automated pipeline rather than a console to click through. If you already use the [[GitHub CLI (gh)]] or similar tools, firectl fits the same mental model. ## My take Every serious inference provider needs a CLI before its product is taken seriously by engineering teams. firectl is the table-stakes version of that for [[Fireworks AI]]; it's clean, well-documented, and matches the patterns developers already know from other infrastructure CLIs. Pair it with [[Fireworks AI Fire Pass]] for personal agentic-coding work, or with Fireworks deployments in production, and the dashboard becomes optional. ## References - https://docs.fireworks.ai/tools-sdks/firectl/firectl ## Related - [[Fireworks AI]] - [[Fireworks AI Fire Pass]] - [[Command Line Interface (CLI)]] - [[GitHub CLI (gh)]]