CLI Reference
The foundry CLI scaffolds a platform, reconciles it with the filesystem, runs it locally, generates its CI/CD, and performs database operations. Each command is documented in detail on its own page.
Commands
| Command | What it does | Writes |
|---|---|---|
foundry init | Create or refresh a platform | foundry.json, .foundry/ |
foundry generate | Generate pipeline, scripts, tfvars, and multi-repo thin callers | .github/workflows/deploy.yml, ci/scripts/, ci/iac/{env}/ |
foundry sync | Reconcile manifest ↔ filesystem | .foundry/workspace.yml |
foundry run | Run services locally (Services UI) | — |
foundry db | Liquibase ops with auto SSH tunnels | — |
foundry github | GitHub token + cross-repo discovery | .foundry/config.yml (with --save) |
foundry config | Show toolchain + project status | — |
foundry alias | Manage command aliases | shim binaries |
The shape of a Foundry project
Most commands operate on the current directory and expect a foundry.json at the root. init creates it; sync keeps the workspace map current; run reads the workspace to launch services; generate emits the in-repo CI/CD for a monorepo. db, github, config, and alias are utilities around that core.