video-chat

Video Chat: $ARGUMENTS

Start an interactive Q&A session with a video, progressively building knowledge.

Session Setup

1. Determine the input type from "$ARGUMENTS":

   • If it starts with http:// or https://: use video_create_session with url parameter
   • Otherwise (file path): use video_create_session with file_path parameter

2. For YouTube URLs: check <memory-dir>/gr/media/videos/<video_id>.mp4 first.

   • If present: call video_create_session(file_path="<that local path>") for fastest local reuse.
   • If missing: ask user whether to download via video_create_session(download=true) or stream directly.
   • For local files, call video_create_session(file_path=...) directly.

3. Use description="Interactive Q&A session" for the session creation

4. Present the video title and session info. If download_status is present, explain:

   • "downloaded" + cache_status="cached": "Video downloaded and cached — each turn will be fast and cost-efficient."
   • "downloaded" + cache_status="uncached": "Video downloaded but cache creation failed — still faster than streaming (no re-fetch per turn)."
   • "unavailable": "yt-dlp not found. Install it with brew install yt-dlp for cached sessions. Continuing with streaming."
   • "failed": "Download failed. Continuing with streaming."

Initialize Memory

1. Determine the memory directory: find the .claude/ project memory path for the current working directory. Use Glob on ~/.claude/projects/*/memory/ to find the active project memory path if needed.

2. Generate a slug from the video title: lowercase, hyphens, no special chars, max 50 chars

3. Check if a prior analysis exists at <memory-dir>/gr/video/<slug>/analysis.md

   • If yes: read it, note existing concepts and knowledge states. The chat builds on prior analysis.
   • If no: this chat creates a fresh knowledge entry.

4. Use Write to create <memory-dir>/gr/video-chat/<slug>/analysis.md:

---
source: <youtube-url-or-file-path>
analyzed: <ISO 8601 timestamp>
updated: <ISO 8601 timestamp>
session_id: <session_id>
concepts: []
---

# <Video Title> — Chat Session

> Source: <url-or-path>
> Session started: <YYYY-MM-DD HH:MM>

## Q&A