terminal-session-replay

# Terminal Session Replay

## What This Does

A CLI tool to record, replay, and export terminal sessions. Captures commands, outputs, and timing for later review, documentation, or sharing with teammates. Wraps the standard `script` command with a simpler interface and additional features.

Key features:
- **Record sessions** - Start recording terminal session with a simple command
- **Replay sessions** - Play back recorded sessions with original timing
- **Export to markdown** - Convert sessions to readable documentation
- **Session management** - List, view, and delete recorded sessions
- **Metadata support** - Add titles, descriptions, and tags to sessions
- **Timing control** - Adjust playback speed or skip timing for quick review

## How To Use

### Record a session:
```bash
./scripts/main.py record --output session1
```

### Replay a session:
```bash
./scripts/main.py replay --input session1
```

### Export to markdown:
```bash
./scripts/main.py export --input session1 --output session1.md
```

### List recorded sessions:
```bash
./scripts/main.py list
```

### Full command reference:
```bash
./scripts/main.py help
```

## Commands

- `record`: Start recording a terminal session
  - `--output`: Session name (default: timestamp-based)
  - `--title`: Session title for metadata
  - `--desc`: Session description
  - `--tags`: Comma-separated tags
  
- `replay`: Replay a recorded session
  - `--input`: Session name to replay
  - `--speed`: Playback speed multiplier (default: 1.0)
  - `--no-timing`: Skip timing, display immediately
  
- `export`: Export session to markdown
  - `--input`: Session name to export
  - `--output`: Output markdown file (default: session_name.md)
  - `--include-timing`: Include timing information in export
  
- `list`: List all recorded sessions
  - `--filter-tags`: Filter by tags
  
- `info`: Show session metadata
  - `--input`: Session name
  
- `delete`: Delete a session
  - `--input`: Session name to delete

## Output

Sessions are sto...

# Terminal Session Replay

A CLI tool to record, replay, and export terminal sessions for debugging, documentation, and sharing.

## Quick Start

```bash
# Record a session
./scripts/main.py record --output my-session

# Replay it
./scripts/main.py replay --input my-session

# Export to markdown
./scripts/main.py export --input my-session --output SESSION.md
```

## Features

- **Easy recording** - Simple command to start/stop recording
- **Accurate replay** - Play back with original timing
- **Documentation export** - Convert sessions to markdown
- **Session management** - List, view, delete recordings
- **Metadata** - Add titles, descriptions, tags

## Installation

This skill is installed via OpenClaw. Requires `script` command (available on Linux/macOS).

## Usage

### Recording
```bash
./scripts/main.py record --output session-name --title "Session Title"
```
Press Ctrl+D or type `exit` to stop recording.

### Replaying
```bash
./scripts/main.py replay --input session-name --speed 1.5
```
Use `--speed` to adjust playback speed.

### Exporting
```bash
./scripts/main.py export --input session-name --output documentation.md
```

### Listing Sessions
```bash
./scripts/main.py list
```

## Storage

Sessions are stored in `~/.terminal-sessions/`:
- `.typescript` - Terminal recording
- `.timing` - Timing data  
- `.meta.json` - Metadata

## Requirements

- Python 3.6+
- `script` command (usually pre-installed)
- Linux/macOS (Windows requires WSL/Cygwin)

## License

MIT