Pair Programmer on GitHub
Complete source code, installation guide, and configuration examples
What Is It?
Ever wished Claude could just see what you’re working on? Now it can. Pair Programmer gives Claude Code eyes and ears—capturing your screen, microphone, and system audio in real-time. No more screenshots, no more copying error messages, no more explaining context. Just hit a keyboard shortcut and get instant AI assistance based on everything Claude has been watching.Why Developers Love It
- Stop Explaining
- Instant Context
- Hands-Free
Your Time Back
No more:- Taking screenshots and pasting them
- Copying error messages to Claude
- Describing what’s on your screen
- Explaining multi-file context
How It Works
Background Recording
An Electron app runs quietly, capturing your screen, mic, and system audio. Everything streams to VideoDB for real-time AI processing.
AI Indexing
VideoDB extracts:
- Visual descriptions from your screen (every 2 seconds)
- Transcripts from your voice
- Summaries from system audio
Context Buffering
Indexed events fill local memory buffers (FIFO queues). Old entries drop as new ones arrive. Nothing written to disk.
Slash Commands
| Command | What It Does |
|---|---|
/record | Start or stop recording session |
/record-status | Check recording state and buffer sizes |
/refresh-context | Fetch latest screen/mic/audio context |
/what-happened | Get AI analysis of recent activity |
/record-config | Set up API key and indexing settings |
/trigger | Activated by Cmd+Shift+A shortcut |
Real-World Scenarios
🐛 Debugging Complex Bugs
🐛 Debugging Complex Bugs
Chasing a bug across multiple files and terminals? Run
/what-happened.Claude sees your recent screen activity, reads terminal output, and suggests where to look next—without you explaining a thing.📚 Learning New Frameworks
📚 Learning New Frameworks
Following a tutorial video while coding along?Claude references what’s on your screen (the tutorial steps) AND what’s in your editor (your implementation) to provide targeted advice that bridges the gap.
👥 Remote Pair Programming
👥 Remote Pair Programming
On a video call discussing code?Claude captures your screen AND the conversation (mic + system audio). Later, ask Claude to summarize what you both decided or reference a specific comment.
🔍 Exploratory Coding
🔍 Exploratory Coding
Experimenting with an unfamiliar API, jumping between docs and Stack Overflow?When something breaks, hit
Cmd+Shift+A for instant analysis based on everything you tried, read, and where it went wrong.Code Review
Code Review
Reviewing a pull request across multiple files?Let Claude watch your screen as you navigate the diff. Ask
/what-happened and get a structured overview of changes reviewed, potential issues, and questions for the author.Tech Stack
Electron 28
Desktop shell with screen capture APIs
Node.js 18+
JavaScript runtime and HTTP API server
VideoDB SDK
Media streaming and AI processing
Cloudflare Tunnel
Secure webhook delivery (auto-created)
Getting Started
Prerequisites
- macOS (Apple Silicon or Intel)
- Node.js 18+
- Claude Code CLI
- VideoDB API key
Start Recording
Run
/record to begin your first capture session. The recorder will automatically:- Prompt for your VideoDB API key (if not configured)
- Configure indexing settings
- Start screen, mic, and audio capture
- Begin AI processing
Privacy & Security
Local Storage - Context buffers stored in memory only, nothing written to disk
API Key Security - Stored locally, masked in output, never transmitted except to VideoDB
Configurable Limits - Control buffer sizes and what gets captured
Secure Webhooks - Cloudflare tunnel auto-created and torn down per session
Complete Setup Guide on GitHub
Detailed installation instructions, troubleshooting tips, and configuration examples