Skip to main content

Commands

Core

CommandDescription
ubx initScaffold a new ubx project
ubx validateType-check .iac files without deploying
ubx planPreview changes
ubx applyCompile and deploy
ubx destroyTear down resources
ubx refreshSync state with actual cloud
ubx outputShow stack outputs
ubx fmtFormat .iac files canonically

AI Commands

CommandDescription
ubx explainPlain-English explanation of your infrastructure
ubx fixAuto-fix validation errors using AI
ubx suggestGenerate .iac blocks from natural language
ubx reviewSecurity, cost, and best practices review
ubx upgradeDetect and apply deprecated resource upgrades

State & Schema

CommandDescription
ubx stateState management (list, show, rm, mv)
ubx schemaProvider schemas (sync, list)
ubx convertConvert Terraform or Pulumi code to ubx

Developer Tools

CommandDescription
ubx testRun .test.iac test files
ubx consoleInteractive expression REPL
ubx docsOpen or list resource documentation
ubx graphVisualize resource dependency graph

Auth & Registry

CommandDescription
ubx authConfigure cloud provider credentials
ubx aiManage AI feature configuration
ubx publishPublish a component to the Strata registry
ubx completionGenerate shell completion scripts
ubx versionShow ubx version

Global Flags

FlagDescription
--config stringConfig file (default: ubx.yaml in project root)
--env stringTarget environment (overrides defaultEnv in ubx.yaml)
--stack stringTarget stack name
--no-colorDisable color output

Common Patterns

ubx validate
ubx validate --compile
ubx plan --env prod
ubx apply --env staging
ubx apply --target unit.aws_s3_bucket_v2.assets
ubx apply --target unit.aws_rds_instance.db --target deploy.helm.backend
ubx output
ubx output --format json
ubx fmt
ubx test
ubx test --verbose
ubx explain
ubx explain --audience exec
ubx fix --dry-run
ubx fix --yes
ubx review --focus security --min-severity high
ubx upgrade --check
ubx state list
ubx state show aws_s3_bucket_v2.assets