# Command reference
Every Flux subcommand, generated from the CLI definition.
### `flux init`
Detect the project and write a starter `.flux` file
### `flux build`
Run the full build pipeline (dependency graph, parallel)
### `flux test`
Run the pipeline's test step(s) and their dependencies
### `flux run`
Run a single named step (and its dependencies)
### `flux clean`
Clear the build cache (artifacts, secrets, and runners are kept)
### `flux info`
Show what Flux detects about this project
### `flux ci`
Run a clean, cache-free CI pipeline and record an artifact
### `flux deploy`
Deploy according to the `.flux` deployment block
### `flux rollback`
Roll back the latest deployment to the previous release
### `flux agent`
Run AI agents (planner, reviewer, tester, maintenance, ...)
- `flux agent list` — List the available AI agents
- `flux agent run` — Run an agent and write its report
- `flux agent status` — Show which agent reports have been generated
- `flux agent create` — Scaffold a custom agent definition under `.flux.d/agents/`
- `flux agent install` — Install (register) a custom agent (honest: records it locally)
### `flux runners`
Manage local build runners and declared runner pools
- `flux runners start` — Register this machine as an available build runner
- `flux runners list` — List registered runners and declared pools
### `flux project`
Show repository intelligence: languages, architecture, health
### `flux ask`
Ask a question about this repository (offline, or via `ai.command`)
### `flux github`
GitHub integration: CI scaffolding, PR review, issue planning
- `flux github init` — Scaffold a CI workflow and PR template under `.github/`
- `flux github review` — Review the working tree, or a PR (needs the `gh` CLI)
- `flux github plan` — Turn an issue or a description into an implementation plan
### `flux docs`
Regenerate reference docs from the CLI, agents, and knowledge graph
### `flux dashboard`
Render a self-contained HTML project dashboard
### `flux analytics`
Show build-performance analytics from run history
### `flux lock`
Capture the current environment into `.flux.lock`
### `flux reproduce`
Compare the current environment against `.flux.lock` (reproducibility)
### `flux artifact`
Manage the artifact registry
- `flux artifact push` — Push a file or directory into the registry
- `flux artifact list` — List stored artifacts
### `flux release`
Create a release from stored artifacts
- `flux release create` — Create a release bundling artifacts for a version
### `flux secret`
Manage encrypted secrets
- `flux secret set` — Set (or overwrite) a secret value
- `flux secret list` — List stored secret names (never values)
### `flux plugin`
Inspect, install, or scaffold plugins
- `flux plugin list` — List the plugins Flux knows about
- `flux plugin install` — Install a plugin (registers it locally)
- `flux plugin create` — Scaffold a new plugin with the PDK
- `flux plugin search` — Search the plugin catalog
- `flux plugin verify` — Verify installed plugin manifests
### `flux workspace`
Manage a multi-project workspace
- `flux workspace status` — Show workspace members and which are affected by changes
- `flux workspace build` — Build affected members in dependency order
### `flux policy`
Check the pipeline against declared policies
### `flux status`
A one-screen overview of the project's Flux state
### `flux graph`
Print the pipeline dependency graph
### `flux fmt`
Format the project with its language formatter
### `flux lint`
Lint the project with its language linter
### `flux changelog`
Generate a changelog from git commits
### `flux version`
### `flux deps`
Inspect project dependencies
### `flux doctor`
Diagnose the environment, toolchains, and Flux setup
### `flux validate`
Validate the `.flux` file (syntax, pipeline graph, references)
### `flux verify`
Run the project's full check suite (fmt, clippy, tests)
### `flux explain`
Explain the pipeline in plain language
### `flux format`
Canonically format the `.flux` file in place