CLI Reference

This section tracks the promoted command surface shown by fluid --help in forge-cli 0.7.9.

Read this first

CLI release examples in this section use 0.7.9
Contract examples use fluidVersion: 0.7.2
fluid version and fluidVersion are different things

Core Workflow

Command	What it is for
`fluid init`	Create a new project (includes `fluid demo` — the 30-second zero-setup variant)
`fluid forge`	AI-assisted scaffolding (includes `fluid skills` for industry knowledge packs)
`fluid validate`	Validate a contract against bundled or fetched FLUID schemas
`fluid plan`	Preview planned execution (includes `fluid viz-graph` for rich visualization)
`fluid apply`	Run a contract or saved plan end-to-end
`fluid status`	One-page summary of the product in the current directory

The newcomer path is usually:

fluid init my-project --quickstart
cd my-project
fluid validate contract.fluid.yaml
fluid plan contract.fluid.yaml
fluid apply contract.fluid.yaml --yes

Generate

Command	What it is for
`fluid generate`	Unified generation entry point (includes `fluid export-opds` — shortcut for the OPDS standard)
`fluid generate transformation`	Emit transformation artifacts such as dbt or SQL
`fluid generate schedule`	Emit Airflow, Dagster, or Prefect scheduling artifacts
`fluid generate ci`	Generate GitHub Actions, GitLab CI, or Jenkins templates
`fluid generate standard`	Export contracts to OPDS, ODCS, ODPS, or ODPS-Bitol

Compatibility note: fluid generate-airflow still exists, but the promoted orchestration path is fluid generate schedule --scheduler airflow.

Integrations

Command	What it is for
`fluid publish`	Publish contracts to configured catalogs
`fluid market`	Search and browse discovered products and blueprints
`fluid import`	Scan existing projects and generate FLUID contracts

Quality & Governance

Command	What it is for
`fluid policy-check`	Run governance and compliance checks from the contract
`fluid diff`	Detect drift from desired state
`fluid test`	Validate the contract against live resources
`fluid verify`	Verify deployed resources still match the contract

Utilities

Command	What it is for
`fluid config`	View and set workspace defaults
`fluid split`	Split a flat contract into fragments
`fluid bundle`	Resolve a multi-file contract into one bundled document
`fluid auth`	Manage provider authentication flows
`fluid doctor`	Run built-in health checks
`fluid providers`	List registered providers
`fluid version`	Show CLI version and environment details

Command discovery

fluid --help
fluid <command> -h

If a page in the docs uses an older command spelling such as fluid forge --mode ..., treat it as historical or compatibility-only unless the page explicitly says it is current.

Need a hand with a specific command, or noticing something out of date? Start a discussion or open an issue — docs PRs welcome.