── CLI REFERENCE ──
exo gen
Generate individual infrastructure components from templates.
## Synopsis
bash
exo gen <type> [flags]## Description
Unlike exo init which generates everything at once, exo gen lets you add or regenerate specific components individually. It reads .exo.yaml for defaults and falls back to auto-detecting your stack — so flags are optional in most cases.
Use --dry-run to preview exactly what would be written, and --force to overwrite existing files. Combine with --output-dir to send output to a custom directory.
## Generator Types
| Type | Output |
|---|---|
docker | Language-specific multi-stage Dockerfile |
docker-compose | Full docker-compose.yml (app + DB + monitoring) |
infra | infra/<provider>/ — Terraform main, variables, provider |
k8s | k8s/ — Deployment, Service, Ingress YAML |
helm | charts/<name>/ — full Helm chart with templates |
ci | Language-aware CI pipeline (GitHub Actions or GitLab CI) |
db | docker-compose.<db>.yml — database service |
makefile | Makefile |
env | .env.example |
gitignore | .gitignore |
grafana | grafana_dashboard.json |
alerts | alerts.yml — Prometheus alert rules |
readme | README.md with badges, install and usage sections |
pre-commit | .pre-commit-config.yaml — language-aware hooks |
devcontainer | .devcontainer/devcontainer.json |
renovate | renovate.json — automated dependency updates |
license | LICENSE — MIT, Apache 2.0, or GPL 3.0 |
dependabot | .github/dependabot.yml |
sonarqube | sonar-project.properties |
sbom | sbom.cdx.json — CycloneDX SBOM (uses syft if available) |
## Flags
| Flag | Short | Description |
|---|---|---|
--lang | -l | Language override: go, node, python, java, rust |
--name | -n | App name (defaults to .exo.yaml or directory name) |
--provider | -p | Cloud provider override: aws, gcp, azure |
--db | — | Database override: postgres, mysql, mongo, redis |
--monitoring | — | Monitoring override: prometheus, none |
--dry-run | — | Preview what would be generated without writing files |
--force | — | Overwrite existing files without prompting |
--output-dir | -o | Write output into this directory instead of CWD |
--license-type | — | License type for exo gen license: mit, apache2, gpl3 |
## Examples
Basic usage (reads .exo.yaml automatically)
bash
exo gen dockerexo gen k8sexo gen ciPreview before writing
bash
exo gen helm --dry-runexo gen infra --provider aws --dry-runOverwrite existing files
bash
exo gen docker --forceexo gen k8s --forceOutput to a custom directory
bash
exo gen k8s --output-dir ./deploy/exo gen helm -o ./charts-out/New generators
bash
# Full local dev stackexo gen docker-compose# Project readme, license, pre-commit hooksexo gen readmeexo gen license --license-type apache2exo gen pre-commit# Security and qualityexo gen sbom # uses syft if installed, else CycloneDX skeletonexo gen sonarqubeexo gen dependabot## Config resolution order
Priority (highest wins):
1.CLI flags (
--lang, --provider, etc.)2.
.exo.yaml in current directory3.Auto-detector (scans go.mod, package.json, pyproject.toml, Cargo.toml, pom.xml…)
4.Built-in defaults (port 8080, language unknown)