Scherzo Cloud Cli

Scherzo Cloud CLI

Scherzo Cloud CLI turns repeatable engineering work into explicit, durable workflows. Define commands and coding agents in one repository-owned YAML file, connect typed outputs to downstream steps, run independent work concurrently, and retain a result you can inspect instead of reconstructing what happened from terminal scrollback.

The CLI is the open-source command-line and runner executable for Scherzo Cloud. It can run workflows locally with Pi, Claude Code, and Codex, or serve them from an enrolled outbound runner. The project is early, but the local workflow engine and its authoring, execution, and inspection tools are available today.

Why Scherzo

Coding-agent automation often begins as a loose sequence of shell commands, prompts, and copy-and-paste handoffs. That approach becomes difficult to repeat, supervise, and recover once work spans several tools or agents. Scherzo gives the work a runtime:

• One graph for commands and agents. Express control flow and typed data flow in a workflow dependency graph instead of coordinating scripts and model sessions by hand.
• Parallel work with explicit handoffs. Let independent steps run concurrently, pass text, schema-validated JSON, and files to downstream work, and export Git branch results when a workflow changes a repository.
• Durable execution. Follow progress in the terminal, inspect retained runs later, recover bounded step failures, and retry eligible runs explicitly.
• Repository-owned automation. Version workflows, prompts, attachments, and result schemas beside the code they operate on.
• Validate before you spend. Resolve the complete workflow bundle and check its graph, references, types, files, and policy offline before starting commands or consuming model tokens.

What you can build

Use Scherzo to:

• run tests, linters, builds, and several independent code reviews in parallel, then combine their findings in one final artifact/PR;
• h