👋 New to open source?
Thanks for considering contributing to Mutiny.
This issue is intentionally beginner-friendly.
If you get stuck, ask questions in the comments.
We're happy to help.
Context
SVG placeholders already ship under docs/assets/ (hero, campaign, policy, tests, regressions, cli-run, storyboard). README still needs real visual proof of the product loop.
Goal
Add at least one real still (CLI or Hosted) or a short mutiny-demo.gif of init → run → test, and point README at it.
Why it matters
Placeholders prove layout; real captures prove the product. This is the highest-leverage non-code contribution for OSS discovery.
Acceptance criteria
Suggested files
docs/assets/* (new PNG/GIF; keep SVGs as fallback unless replacing)
README.md (Screenshots & demo)
docs/assets/README.md (instructions already exist)
Out of scope
- Redesigning Hosted UI, regenerating all SVGs, or large video files
Hints
- Easiest win: terminal capture of
cd examples/openai_support_agent && uv run mutiny run --no-hosted → cli-run.png.
- Or record a short GIF of init → run → test per
docs/assets/README.md.
- Scrub API keys / personal paths from captures before committing.
Difficulty
S · docs / media · no application code required (was catalog #4)
Docs
👋 New to open source?
Thanks for considering contributing to Mutiny.
This issue is intentionally beginner-friendly.
If you get stuck, ask questions in the comments.
We're happy to help.
Context
SVG placeholders already ship under
docs/assets/(hero,campaign,policy,tests,regressions,cli-run,storyboard). README still needs real visual proof of the product loop.Goal
Add at least one real still (CLI or Hosted) or a short
mutiny-demo.gifof init → run → test, and point README at it.Why it matters
Placeholders prove layout; real captures prove the product. This is the highest-leverage non-code contribution for OSS discovery.
Acceptance criteria
*.png/*.webpordocs/assets/mutiny-demo.gif(keep files reasonably sized, ideally < ~2 MB)docs/assets/README.md(basename swap is fine)Suggested files
docs/assets/*(new PNG/GIF; keep SVGs as fallback unless replacing)README.md(Screenshots & demo)docs/assets/README.md(instructions already exist)Out of scope
Hints
cd examples/openai_support_agent && uv run mutiny run --no-hosted→cli-run.png.docs/assets/README.md.Difficulty
S · docs / media · no application code required (was catalog #4)
Docs