simonw/showboat

Health v2 · maintenance only

Adoption not part of the score

1209 stars · 45 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Showboat is a Go CLI tool for creating executable markdown demo documents that mix commentary, runnable code blocks, and captured output. It lets AI agents produce documents that serve as both readable documentation and verifiable proof of work, since a verifier can re-execute all code blocks and confirm outputs still match.

Use cases

• create executable demo documents showing an agent's work
• verify that captured code outputs in a markdown document still reproduce
• build reproducible tutorials with runnable code blocks
• let an AI agent document its work with proof of execution
• append notes, command output, and images to a demo document from the CLI

When to choose

• you want reproducible, verifiable documentation of agent or CLI work
• you need markdown documents whose code blocks can be re-executed to confirm outputs
• you want a simple CLI for incrementally building demo documents

When to avoid

• you need a full notebook environment with interactive execution
• you only want static documentation without executable verification

Facets

cli-tool · maturity active

developer-tools documentation markdown cli developer-tools documentation cli cross-platform windows executable-documents proof-of-work ai-agents reproducibility go-tool markdown-demo command-line macos linux

Member repositories

For agents

markdown · JSON · MCP: product_card(name="simonw/showboat")