── 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

TypeOutput
dockerLanguage-specific multi-stage Dockerfile
docker-composeFull docker-compose.yml (app + DB + monitoring)
infrainfra/<provider>/ — Terraform main, variables, provider
k8sk8s/ — Deployment, Service, Ingress YAML
helmcharts/<name>/ — full Helm chart with templates
ciLanguage-aware CI pipeline (GitHub Actions or GitLab CI)
dbdocker-compose.<db>.yml — database service
makefileMakefile
env.env.example
gitignore.gitignore
grafanagrafana_dashboard.json
alertsalerts.yml — Prometheus alert rules
readmeREADME.md with badges, install and usage sections
pre-commit.pre-commit-config.yaml — language-aware hooks
devcontainer.devcontainer/devcontainer.json
renovaterenovate.json — automated dependency updates
licenseLICENSE — MIT, Apache 2.0, or GPL 3.0
dependabot.github/dependabot.yml
sonarqubesonar-project.properties
sbomsbom.cdx.json — CycloneDX SBOM (uses syft if available)

## Flags

FlagShortDescription
--lang-lLanguage override: go, node, python, java, rust
--name-nApp name (defaults to .exo.yaml or directory name)
--provider-pCloud 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-oWrite 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 docker
exo gen k8s
exo gen ci

Preview before writing

bash
exo gen helm --dry-run
exo gen infra --provider aws --dry-run

Overwrite existing files

bash
exo gen docker --force
exo gen k8s --force

Output to a custom directory

bash
exo gen k8s --output-dir ./deploy/
exo gen helm -o ./charts-out/

New generators

bash
# Full local dev stack
exo gen docker-compose
# Project readme, license, pre-commit hooks
exo gen readme
exo gen license --license-type apache2
exo gen pre-commit
# Security and quality
exo gen sbom # uses syft if installed, else CycloneDX skeleton
exo gen sonarqube
exo gen dependabot

## Config resolution order

Priority (highest wins):

1.CLI flags (--lang, --provider, etc.)
2..exo.yaml in current directory
3.Auto-detector (scans go.mod, package.json, pyproject.toml, Cargo.toml, pom.xml…)
4.Built-in defaults (port 8080, language unknown)