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.