Expand description
§rec — CLI Terminal Recorder
rec is a command-line tool for recording, replaying, and exporting terminal
sessions. It captures commands as you work and lets you export them to
executable formats like bash scripts, Makefiles, and CI/CD pipelines.
§Architecture
cli— Command-line argument parsing and dispatch (clap-based)config— Configuration loading and management (TOML-based)recording— Session recording lifecycle (start/stop/status/hook)session— Session data model and storage operationsstorage— XDG-compliant filesystem paths and persistencereplay— Command replay engine with safety controlsexport— Multi-format export (bash, makefile, markdown, etc.)import— Import sessions from shell history filesdoctor— Diagnostic checks for installation healthhooks— Shell hook scripts for bash, zsh, and fisherror— Error types with semantic exit codesmodels— Shared data models (sessions, commands, config)demo— Demo session generation for testing
Modules§
- cli
- Command-line argument parsing and output formatting.
- config
- Configuration loading and management.
- demo
- Interactive demo session generation.
- doctor
- Diagnostic checks for installation health.
- error
- export
- Multi-format session export.
- hooks
- Shell hook scripts for Bash, Zsh, and Fish.
- import
- Import sessions from external sources.
- models
- Shared data models for sessions, commands, and configuration.
- recording
- Session recording lifecycle management.
- replay
- Replay module for executing recorded terminal sessions.
- session
- Session management operations.
- storage
- XDG-compliant filesystem persistence.