Simple demo

The quickest end-to-end demo uses the USB-C power breakout brief. It is intentionally small: one connector, passives, a power LED, and output protection.

Run it

From the copperhead checkout:

copperhead demo --model cursor
# or from a checkout:
npm run demo:simple

Both create or resume a git repo at demo-runs/usb-c-breakout/, initialize it if needed, create a baseline commit for copperhead’s rollback snapshots, and run the create pipeline against:

examples/simple/usb-c-breakout.md

You can pass normal create flags after --:

npm run demo:simple -- --model claude
npm run demo:simple -- --interactive

To place the generated demo somewhere else:

COPPERHEAD_DEMO_DIR=/tmp/copperhead-usb-c npm run demo:simple

What to expect

The create pipeline is resumable. If the agent stops during a stage, rerun the same command and it continues from the first incomplete stage.

Run transcripts stay in .copperhead/runs/ inside the demo repo. They are ignored by git, so failed attempts do not make the demo repo dirty.

The demo still uses the real toolchain, so it requires the same things as a normal run: Node.js, kicad-cli, git, and either an authenticated local Codex CLI or an OpenAI/Anthropic API key.