cadenza (or cadenza-cli from a source install). Inside
the interactive shell, omit the prefix.
Projects
| Command | Description |
|---|---|
mkdir <name> | Full project scaffold: env.json + main.py + requirements.txt + README. |
env init <name> | Light scaffold: env.json only. |
env show <name> | Render the mission’s zones, objects, and phases. |
Run & analyze
| Command | Flags | Description |
|---|---|---|
env run <name> | --headless, --policy scripted|lora, --xml <path> | Execute the mission, log every tick, and run the LLM judge. Needs the gym extra. |
env stats <name> | None | Motion + reward analytics across cached runs. |
env cache <name> | --keep-last <n>, --older-than <dur>, --clear | Show or prune the project’s .cadenza-env/ directory. |
Actions (require sign-in)
| Command | Flags | Description |
|---|---|---|
env action create <project> <name> | --group, --steps '<a,b,c>', --custom, --frames-file <file>, --robot <name> | Build an action (group macro or custom keyframes), saved locally and synced to your account. |
env action list | None | List your account’s actions. |
env action show <project> <name> | None | Inspect a local action. |
env action remove <project> <name> | None | Delete a local action. |
Fine-tuning
| Command | Flags | Description |
|---|---|---|
env finetune <project> <log> | -o <file> | Emit (prompt, action, reward) records from a run log for VLA training. |
env train <project> | None | Groq LLM-as-Judge rewrites the project’s system prompt. Needs GROQ_API_KEY. |
env lora add <project> "<goal>" | --steps '<...>', --image <path> | Add a goal→action training example. |
env lora data <project> | --finetune <path> | Show the training dataset. |
env lora finetune <project> | --epochs <n>, --lr <lr>, --rank <r>, --gate, --no-env | Fine-tune the LoRA action head. --gate runs the governance scorecard. |
env lora eval <project> | --promote | Run the governance scorecard. |
env lora decode <project> "<goal>" | None | Decode a goal into actions via the trained adapter. |
env lora and env run --policy lora need the lora extra. env run/env show
need the gym extra. See Configuration.Account & shell
| Command | Description |
|---|---|
login <name> <token> | Sign in and save a session to ~/.cadenza/config.json. |
logout | Forget the saved session. |
whoami | Show the signed-in account. |
help | Show the command table. |
clear | Clear the screen. |
--version | Print the version and check for updates. |