Command Overview

Koupper CLI commands are organized around one flow: scaffold, run, evolve, operate, and deploy.

Core command groups

Group	Command	Purpose
Scaffold	koupper new	Create scripts or module templates.
Execute	koupper run	Run Kotlin scripts through Octopus runtime.
Module evolution	koupper module	Add scripts and inspect module metadata.
Background jobs	koupper job	List, run, and inspect queued worker jobs.
Deployment	koupper deploy	Package and deploy script/module artifacts.
Infrastructure	koupper infra	Run Terraform lifecycle commands with stable JSON output.
Reconcile	koupper reconcile	Orchestrate infra, preflight, deploy, smoke, and rollback stages.
Capability discovery	koupper provider	List providers and inspect contracts + env requirements.

Typical lifecycle

koupper new module name="demo",version="1.0.0",package="demo.app",template="jobs"
cd demo
koupper run extensions/hello-world.kts
koupper job list
koupper deploy
koupper infra plan --dir=infra --var-file=env/dev.tfvars --json
koupper reconcile run --dir=infra --auto-approve --stages=infra,preflight,deploy,smoke --json

Tips

• Run commands from module root when using module/job/deploy flows.
• Use --json-file with koupper run for stable payload handling in CI shells.
• Use koupper provider info <provider> before wiring integrations to confirm required env vars.