simonw

simonw / showboat

Public

Create executable documents that demonstrate an agent's work

548
25
100% credibility
Found Feb 11, 2026 at 152 stars 4x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Go
AI Summary

Showboat builds Markdown documents blending explanations, executable code snippets with captured text or image outputs, enabling easy verification by re-running the code.

How It Works

1
🔍 Discover Showboat

You learn about a handy way to make demo stories that mix your words, actions, and real proof of what happened.

2
📥 Set it up on your computer

You quickly get the tool ready with a simple download, so it's easy to use right away.

3
📖 Start your demo notebook

You begin a new file with a fun title, like 'How I Set Up My Project', and it adds the date.

4
💭 Write helpful notes

You add friendly explanations about what you're doing next, like chatting in a story.

5
⚡ Run steps and grab results

You try commands or scripts, and it magically captures the exact words or pictures they produce to include.

6
🔄 Fix if something's off

If the last bit isn't quite right, you just take it away and try again.

7
🔍 Double-check everything

You re-play all the steps to confirm the results still match perfectly every time.

🎉 Share your trusted story

Your complete demo is ready to show others, proving your work with readable proof anyone can verify.

Sign up to see the full architecture

6 more

Sign Up Free

Star Growth

See how this repo grew from 152 to 548 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is showboat?

Showboat is a Go CLI tool that builds markdown documents blending prose, executable code blocks, and captured outputs—turning static READMEs into verifiable demos. Start with `showboat init file.md "Title"`, add notes via `showboat note`, run bash or python commands with `showboat exec file.md bash "ls -la"` to capture output, snap images via `showboat image`, then verify reproducibility using `showboat verify`. It solves the problem of proving workflows like creating executable bash scripts, GitHub tokens, or Python projects by letting anyone re-execute and diff results.

Why is it gaining traction?

Unlike plain markdown or notebooks, Showboat pairs every code block with its exact output, verifiable on any machine via a single command—outputs drift? `verify` diffs them instantly. The `extract` command spits out rebuild CLI steps, and `pop` undoes mistakes without manual edits. Developers dig the stdin support for piping code and cross-language exec (bash, python, even PowerShell), making agent-generated demos trustworthy.

Who should use this?

AI agent builders demoing tasks like creating GitHub repos from local folders, SSH keys, personal access tokens, or executable shell scripts on Linux. Tutorial writers covering "how to create executable from Python script" or Maven JARs who want reproducible proofs. Devs scripting GitHub Actions or apps needing shareable, self-proving walkthroughs.

Verdict

Grab it for agent demos or tutorials—72 stars and 1.0% credibility score scream early days, but polished docs, PyPI packaging, and full test coverage make it reliable now. Watch for wider adoption.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.