betamax-docs

Run commands in tmux sessions and save outputs as PNGs or GIFs.

3|1|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/marcus/marcus-skills --skill betamax-docs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: betamax-docs
Source: https://github.com/marcus/marcus-skills/tree/main/skills/betamax-docs
Command: npx skills add https://github.com/marcus/marcus-skills --skill betamax-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Betamax enables deterministic, repeatable terminal captures for documentation and demos by running commands in a controlled tmux environment and saving outputs as PNGs or GIFs.

Core Features & Use Cases

  • Deterministic capture: run commands in tmux sessions and record outputs with configurable presets.
  • Output formats: PNG screenshots and animated GIF demos for easy sharing.
  • Use Case: document CLI tools, onboarding flows, and UI demonstrations with reproducible visuals across environments.

Quick Start

Run betamax capture <command> to create a deterministic screenshot or demo.

Frequently Asked Questions about betamax-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I capture terminal commands for documentation screenshots?▼

Betamax captures terminal commands for documentation by running them in a controlled tmux session and saving outputs as deterministic PNG screenshots, ensuring reproducible visuals across different environments.

Can I create animated GIF demos for CLI tool onboarding flows?▼

Yes, you can create animated GIF demos for CLI tool onboarding by recording command executions within a controlled tmux session, producing reproducible visual demonstrations that remain consistent across environments.

Do I need tmux installed to generate deterministic terminal captures?▼

Yes, tmux must be installed to generate deterministic terminal captures. The tool relies on tmux to create a controlled session environment where commands execute and outputs are recorded reliably as images or GIFs.

How do I configure output directories and themes for terminal screenshots?▼

You configure output directories and themes for terminal screenshots using per-project .betamaxrc files, global configurations, or named presets, which govern output locations, visual themes, and capture timing.

What is the best way to ensure reproducible terminal visuals across environments?▼

The best way to ensure reproducible terminal visuals across environments is to run commands in a controlled tmux session using deterministic capture presets, which standardize output formats and timing for documentation.

Why do my terminal recordings look different each time I run them?▼

Terminal recordings may look different without deterministic capture. By running commands in a controlled tmux session with configured presets for timing and themes, you eliminate environmental variances and ensure identical output.