用途：面向 Claude Code 的结对编程技能，在编写代码时录制屏幕与音频，并借助 AI 索引实时记录视觉和音频事件，让 AI 能基于真实屏幕内容和语音进行搜索与回顾。
主要能力与命令：/pair-programmer setup 安装依赖并配置 API key；record 开始屏幕/音频录制；stop 停止录制；search 搜索录制上下文（屏幕、麦克风、音频）；act 根据麦克风中的口头指令执行操作；what-happened 总结近期活动；config 调整索引等设置。具体指令见各 commands 目录下的对应文件。
使用方式：先运行 setup 安装依赖并设置 VIDEO_DB_API_KEY 环境变量；再运行 record 启动录制，会出现选择器 UI 用于选择屏幕和音频来源；录制中事件写入 /tmp/videodb_pp_events.jsonl，也可通过托盘图标（🔴 PP → Stop Recording）停止录制。可选环境变量 VIDEO_DB_BASE_URL 用于指定 API 端点，默认 https://api.videodb.io。
输出文件：/tmp/videodb_pp_pid 保存录制进程 ID；/tmp/videodb_pp_events.jsonl 保存所有 WebSocket 事件（JSONL 格式，每行一个 JSON 对象）；/tmp/videodb_pp_info.json 保存当前会话信息（session_id、rtstream_ids）。事件包含时间戳、通道和数据，通道有 visual_index（屏幕描述，约每 2 秒一条）、transcript（麦克风语音，较稀疏）、audio_index（系统音频摘要，较稀疏）。
读取上下文：不要整文件读取，应使用 CLI 工具过滤。可按通道过滤，如 grep '"channel":"visual_index"' /tmp/videodb_pp_events.jsonl | tail -10；可按关键词跨通道搜索 grep -i 'keyword' ...；也可按时间窗过滤（用 date +%s 取当前 epoch，计算 cutoff，再按 unix_ts 过滤）。语义搜索使用 node search-rtstream.js --query="your query" --cwd=<PROJECT_ROOT>，其中 PROJECT_ROOT 是用户项目目录的绝对路径，需先解析。
限制：需要有效的 VideoDB API key；依赖屏幕录制与音频采集权限；事件为本地临时文件存储。分类：other-ai-tools。