Home

yanju-scenarios

This repository is the open-source scene pack for Yanjú, not the CLI itself. Each folder is one disposable incident: a broken local stack you diagnose and repair.

Yanjú is local-first. Scenes run on your Docker engine. No accounts, no sign-up, no telemetry.

The CLI clones or caches this repo, then copies only workspace.copy into your working directory. Hidden eval/, chaos/, k6 load, and extra images stay here.

Quickstart

uv tool install yanju
yanju check
yanju init broken-proxy
yanju play

The repo README lists every scene. Open a folder to read its README (problem and expected outcome) before you play.

Next

• Playing a scene: init, play, verify, reset
• Creating a scene: folder contract and checklist
• Contributing: PRs and spoiler policy