# simonw/showboat

Create executable documents that demonstrate an agent's work

Repository: https://github.com/simonw/showboat
Canonical: https://ross.abutalabs.com/products/showboat
Language: Go
License: Apache-2.0
License Family: permissive
Last push: 2026-03-14T21:07:00+00:00

## Health v2 (maintenance only)
Score: 60/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 72, release rhythm 72, longevity 14
- inputs: {"age_days": 208, "days_push": 172, "days_rel": 191, "gap_med": 1.5, "n_releases_24m": 7}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1209, forks 45 (observed 2026-08-28T04:03:59.866139+00:00)

## What it is
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
- artifact type: cli-tool
- maturity: active
- function: developer-tools, documentation, markdown, cli
- domain: developer-tools, documentation
- platform: cli, cross-platform, windows
- tags: executable-documents, proof-of-work, ai-agents, reproducibility, go-tool, markdown-demo, command-line, macos, linux

## Member repositories
- simonw/showboat (main) score 60

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:59.866139+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:18:36.807274+00:00, confidence not recorded.
  - readme: https://github.com/simonw/showboat (fetched 2026-08-28T04:03:59.866139+00:00, sha da26b4983e08)
- Data as of 2026-08-30T08:39:29.467469+00:00.