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:

npm run demo:simple

The script creates or resumes a git repo at demo-runs/usb-c-breakout/, initializes it if needed, creates a baseline commit for copperhead’s rollback snapshots, and runs 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 OPENAI_API_KEY or ANTHROPIC_API_KEY.