docs(readme): refresh guides and add live demo

[NovusEdge]

What changed

Describe Stoat as a terminal VM utility for people and AI agents. Shorten the README to an installation quickstart, one main TUI screenshot, and a video link. Refresh the installation, VM, project, recipe, MCP, and troubleshooting guides against the current CLI and source. Add real color Konsole captures and a 23-second recording that includes Alpine XFCE in QEMU.

Why

The documentation contained stale behavior claims and incomplete project and MCP guidance. The new guides describe current behavior and known limits, and the screenshots show real running guests.

Tests run

• just check and just test: gofmt, vet, build, and the full Go test suite
• Live Alpine XFCE and Debian guests; SSH readiness and command execution; project lifecycle
• 164 local documentation links, four TOML reference samples, and media inspection
• Documentation and asset credential scan

Full check, lint, and shellcheck CI must pass before merge. The only change under internal/ is a correction to a sample TOML comment.

Docs

• Documentation and navigation updated

[coderabbitai]

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/docs-live-showcase

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}