CLI Reference
The IronLayer CLI (ironlayer) provides commands for planning, executing, and managing your transformation workflow.
Authentication
ironlayer login
Authenticate with a IronLayer API instance. Stores credentials locally.
ironlayer login --api-url https://app.ironlayer.app --email you@company.com| Flag | Description |
|---|---|
--api-url | API base URL (prompted if not provided) |
--email | Login email (prompted if not provided) |
ironlayer logout
Remove stored credentials.
ironlayer whoami
Show the current authenticated user and tenant.
Planning
ironlayer plan
Generate a deterministic execution plan from a git diff.
ironlayer plan <repo_path> <base_sha> <target_sha>| Argument | Description |
|---|---|
repo_path | Path to the git repository |
base_sha | Base commit SHA (e.g. HEAD~1) |
target_sha | Target commit SHA (e.g. HEAD) |
ironlayer show
Display details of a generated plan.
ironlayer show <plan_id>Execution
ironlayer apply
Execute an approved plan against your Databricks workspace.
ironlayer apply <plan_id> [--auto-approve] [--cluster <size>]| Flag | Description |
|---|---|
--auto-approve | Skip approval prompt |
--cluster | Cluster size override (small, medium, large) |
Backfills
ironlayer backfill
Run a targeted backfill for a specific model and date range.
ironlayer backfill <model_name> --start 2026-01-01 --end 2026-02-01Discovery
ironlayer models
List all discovered SQL models.
ironlayer lineage
Show upstream and downstream dependencies for a model.
ironlayer lineage <model_name> [--direction up|down|both] [--depth N]Migration
ironlayer migrate from-dbt
ironlayer migrate from-dbt <project_path>ironlayer migrate from-sqlmesh
ironlayer migrate from-sqlmesh <project_path>ironlayer migrate from-sql
ironlayer migrate from-sql <sql_directory>Environment Variables
| Variable | Description | Default |
|---|---|---|
IRONLAYER_API_URL | API base URL | Stored from login |
IRONLAYER_TOKEN | Auth token (overrides stored credentials) | — |