Record

Start and stop screen recordings with automatic organization and metadata tracking.

Usage

/record start [project-name]    # Start recording
/record stop                    # Stop and save recording
/record pause                   # Pause recording
/record resume                  # Resume paused recording
/record mark [description]      # Mark a good moment while recording
/record status                  # Check current recording status

Purpose

Quick screen recording with:

• One-command start/stop
• Automatic file organization by project
• Timestamp-based naming
• Mark "good takes" while recording
• Metadata for editing later

Implementation

When user runs /record start [project-name]:

1. Initialize Recording

• Detect operating system
• Use native recording tools:
• macOS: screencapture or QuickTime
• Linux: ffmpeg with X11 capture
• Windows: PowerShell screen capture
• Default to 1920x1080, 30fps, H.264

1. Create Directory Structure

   ~/Videos/[project-name]/
   ├── raw/                    # Raw recordings
   ├── markers.json            # Timestamp markers
   └── metadata.json           # Recording metadata

1. Generate Filename

   Format: YYYY-MM-DD-HH-MM-[project-name].mp4
   Example: 2025-01-15-11-47-redis-caching.mp4

1. Create Metadata File

   {
     "project": "redis-caching",
     "startTime": "2025-01-15T11:47:00Z",
     "duration": null,
     "status": "recording",
     "markers": [],
     "resolution": "1920x1080",
     "fps": 30,
     "codec": "h264"
   }

1. Display Status

   🔴 Screen recording started
   Project: redis-caching
   Recording to: ~/Videos/redis-caching/raw/2025-01-15-11-47-redis-caching.mp4

   Commands:
   - /record stop     : Stop and save recording
   - /record pause    : Pause recording
   - /record mark     : Mark a good moment

Marking Moments

When user runs /record mark [description]:

1. Capture Timestamp

• Calculate time elapsed since recording start
• Format as HH:MM:SS

1. Save Marker

   {
     "markers": [
       {
         "timestamp": "00:14:23",
         "description": "Redis integration working!",
         "time": "2025-01-15T12:01:23Z"
       }
     ]
   }

1. Confirm

   📍 Marker added at 00:14:23
   "Redis integration working!"

Stopping Recording

When user runs /record stop:

1. Stop Capture

• Send stop signal to recording process
• Wait for file finalization

1. Calculate Duration

• Measure total recording time
• Update metadata

1. Update Metadata

   {
     "project": "redis-caching",
     "startTime": "2025-01-15T11:47:00Z",
     "endTime": "2025-01-15T12:34:00Z",
     "duration": "00:47:00",
     "status": "completed",
     "markers": [
       {
         "timestamp": "00:14:23",
         "description": "Redis integration working!"
       },
       {
         "timestamp": "00:32:10",
         "description": "Performance test results"
       }
     ],
     "fileSize": "1.2GB",
     "resolution": "1920x1080",
…

1. Display Summary

   ✅ Recording saved: ~/Videos/redis-caching/raw/2025-01-15-11-47-redis-caching.mp4

   Duration: 47 minutes
   File size: 1.2 GB
   Markers: 2

   Markers:
   00:14:23 - Redis integration working!
   00:32:10 - Performance test results

   Ready for editing with video-editor-ai agent

Platform-Specific Recording

macOS

# Using ffmpeg (install with: brew install ffmpeg)
ffmpeg -f avfoundation -framerate 30 -video_size 1920x1080 \
  -i "1:0" -c:v libx264 -preset ultrafast \
  ~/Videos/[project]/raw/[filename].mp4

Linux

# Using ffmpeg with X11
ffmpeg -f x11grab -framerate 30 -video_size 1920x1080 \
  -i :0.0 -c:v libx264 -preset ultrafast \
  ~/Videos/[project]/raw/[filename].mp4

Windows

# Using PowerShell and Windows.Graphics.Capture
# Requires Windows 10 1809+
$recording = Start-ScreenRecording -Path "C:\Videos\[project]\raw\[filename].mp4"

Advanced Features

Audio Recording

/record start [project-name] --with-audio

Captures:

• System audio (application sounds)
• Microphone input (narration)
• Separate audio tracks for mixing

Region Selection

/record start [project-name] --region

Interactive region selector:

• Click and drag to select screen area
• Record only selected region
• Useful for focused tutorials

Webcam Overlay

/record start [project-name] --webcam

Composite recording:

• Screen capture (main)
• Webcam feed (picture-in-picture)
• Configurable position and size

Integration with Other Plugins

This command integrates with:

• build-logger-agent: Auto-suggests when to record based on breakthroughs
• video-editor-ai: Passes recording + markers for automated editing
• demo-video-generator: Coordinates recording for product demos
• batch-recording-scheduler: Manages multiple recording sessions

Examples

Basic Recording

User: /record start redis-tutorial
Claude: 🔴 Screen recording started
        Project: redis-tutorial
        Recording to: ~/Videos/redis-tutorial/raw/2025-01-15-11-47-redis-tutorial.mp4
        Press /record stop when done

[User codes for 30 minutes]

User: /record mark "Cache hit working!"
Claude: 📍 Marker added at 00:14:23
        "Cache hit working!"

[User codes for another 20 minutes]

User: /record stop
Claude: ✅ Recording saved
        Duration: 47 minutes
        File size: 1.2 GB
…