CLI Reference (`harness_cli.py`)

harness_cli.py is the primary entrypoint CLI tool for Workshop Harness powered by Astral uv.

Command Summary Table

Subcommand	Primary Flags	Description
`generate-all`	`--name`, `--topic`, `--stack`, `--dir`	One-click full workshop generation across all 17 skills
`init`	`--name`, `--topic`, `--dir`	Scaffolds basic repository structure & script templates
`audit-compat`	`--stack`	Audits tech stack cross-architecture risks across hardware chipsets
`audit-loop`	`--topic`	Loop engineering multi-persona review for beginner, intermediate, & advanced attendees
`test`	`--target`	Runs code smoke tests & audits relative markdown broken links
`build-pdf`	`--target`	Compiles markdown documentation into publication-ready PDF handouts
`export-codelab`	`--target`, `--output`, `--push`	Exports Open Codelabs manifest bundle (`codelab.yaml`) & pushes via `oc` CLI
`export-colab`	`--target`, `--output`, `--repo`, `--test`	Exports Google Colab interactive notebooks (`.ipynb`) & 'Open in Colab' badges
`test-colab`	`--target`	Runs headless smoke test on Colab notebooks using Google Colab CLI (`colab`)
`build-slides`	`--target`, `--output`, `--export-pdf`	Generates Marp Markdown (`slides.md`) and interactive Web Presentation (`index.html`)

uv run harness_cli.py generate-all \
  --name "my-bwai-workshop" \
  --topic "Local RAG with Gemma 4" \
  --stack "python,ollama,docker"

uv run harness_cli.py build-slides \
  --target my-bwai-workshop

uv run harness_cli.py export-colab \
  --target my-bwai-workshop \
  --repo "JAICHANGPARK/my-bwai-workshop"

uv run harness_cli.py test-colab \
  --target my-bwai-workshop

uv run harness_cli.py export-codelab \
  --target my-bwai-workshop \
  --push

uv run harness_cli.py audit-compat \
  --stack "lmstudio,docker,mlx"

uv run harness_cli.py test \
  --target my-bwai-workshop