Skip to main content
The CLI is organized around projects. A project is a directory with an env.json mission spec. You scaffold it, run it, analyze it, and turn it into training data.

​
The workflow

1

Scaffold

mkdir or env init create a project and its env.json.
2

Author

Edit env.json to define the scene, phases, success/fail predicates, and reward shaping. See the schema.
3

Run

env run executes the mission in simulation, logging every tick and scoring the result with the LLM judge.
4

Improve

env stats analyzes runs. env finetune, env train, and env lora turn them into better policies and prompts.

​
Command map

AreaCommands
Projectsmkdir, env init, env show
Run & analyzeenv run, env stats, env cache
Actions (needs login)env action create, env action list, env action show, env action remove
Fine-tuneenv finetune, env train, env lora
Accountlogin, logout, whoami
Shellhelp, clear, --version
The full table with flags is in the Command reference.

​
Two ways to run

cadenza                      # interactive shell (tab-complete, Ctrl+C to exit)
cadenza env run my-project   # run one command and exit (scripts, CI)
Inside the shell, omit the leading cadenza: 
> env run my-project --headless
> env stats my-project
Press Tab in the shell to complete commands and env subcommands, and Ctrl+L to clear the screen / redraw the banner.