Docs / Demo

RavenClaws terminal demo

Watch an automated walkthrough of RavenClaws v1.1.0 — from version info and binary profile through HTTP server mode, MCP, Docker/K8s deployment, and the verification suite.

Watch the demo

The recording below is an automated asciinema session that runs the scripts/demo.sh script. It showcases 11 sections covering the full RavenClaws feature set.

Demo sections

The demo covers these 11 sections:

# Section What it shows
1 Version & Help --version and --help output with all CLI options
2 Binary Profile File size (5.6 MB), architecture (arm64), linked libraries (3 system libs)
3 Configuration Single-model and multi-model TOML config files
4 Source Modules 24 .rs files, 27,843 lines of Rust, public API surface
5 Test Suite cargo test results — 507+ unit tests, all passing
6 One-Shot Exec --exec mode with LiteLLM — prompt and response
7 HTTP Server --serve mode with /health, /ready, /metrics endpoints
8 MCP Server --mcp-server mode for tool exposure over stdio
9 Docker & K8s Multi-stage Dockerfile and Kubernetes deployment manifests
10 Website Landing page, styles, JS, security headers, version number
11 Verification Suite 15 test modules and the verify.sh orchestrator

Run the demo locally

You can run the same demo script on your machine without recording:

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

# Run the demo (no recording)
./scripts/demo.sh

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

Record your own demo

To record a new asciinema demo:

terminal
# Install asciinema
pip3 install asciinema

# Record the demo
asciinema rec \
  --title "RavenClaws v1.1.0 Demo" \
  --command "./scripts/demo.sh" \
  --overwrite demo.cast

# Upload to asciinema.org
asciinema upload demo.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 script

The demo is driven by scripts/demo.sh in the repository root. It uses simple shell 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 script is designed to be both a live demo and a recording source — it works identically in both modes.