Docs / Demo

RavenClaws demo suite

Five focused asciinema recordings, each showcasing a different aspect of RavenClaws v1.2.0 — from a 30-second quickstart to a full deployment walkthrough.

The five demos

Instead of one long recording, we split the walkthrough into five focused demos. Each targets a specific audience and can be watched independently.

1. Quickstart ~30s

Audience: New users. Shows version info, binary profile, configuration file, and one-shot --exec mode.

2. Architecture ~45s

Audience: Developers. Shows source modules, unit test suite, multi-agent patterns, self-healing engine, and graceful degradation.

3. Server & MCP ~40s

Audience: Operators. Shows HTTP server mode (/health, /ready, /metrics), MCP stdio server, and MCP SSE server.

4. Resilience ~35s

Audience: SREs / platform engineers. Shows the self-healing engine, circuit breaker states (Closed → Open → Half-Open), exponential backoff with jitter, and failure tracking.

5. Deployment ~40s

Audience: DevOps. Shows Docker multi-stage build, distroless container, Kubernetes manifests, Helm chart, website, and verification suite.

Run the demos locally

Each demo is a standalone shell script in scripts/demos/. You can run them without recording:

terminal
# Prerequisites: Rust 1.86+, a built binary
cargo build --release

# Run any demo (no recording)
./scripts/demos/demo-quickstart.sh
./scripts/demos/demo-architecture.sh
./scripts/demos/demo-server-mcp.sh
./scripts/demos/demo-resilience.sh
./scripts/demos/demo-deployment.sh

# Or run all demos sequentially
for d in scripts/demos/demo-*.sh; do "$d"; done

For the quickstart demo's --exec section, you'll need an LLM provider running. The script auto-detects LiteLLM on localhost:4000. If no provider is available, it falls back to showing config validation.

Record your own demos

To record a new asciinema demo:

terminal
# Install asciinema
pip3 install asciinema

# Record a single demo
asciinema rec \
  --title "RavenClaws v1.2.0 — Quickstart" \
  --command "./scripts/demos/demo-quickstart.sh" \
  --overwrite demo-quickstart.cast

# Upload to asciinema.org
asciinema upload demo-quickstart.cast

Unauthenticated uploads are automatically deleted after 7 days. To preserve recordings permanently, link the CLI to an asciinema.org account by following the authentication URL printed after upload.

The demo scripts

Each demo is driven by a standalone shell script in scripts/demos/. They use simple helpers:

  • section "TITLE" — prints a section header
  • type_cmd command args... — prints the command then runs it
  • sleep N — pauses for readability in the recording

The scripts are designed to be both live demos and recording sources — they work identically in both modes. See scripts/demos/README.md for full documentation.