Ps Tube Summary

Before doing any network work, check if this video was already summarized:

python3 "$HOME/.local/share/personal-skills/scripts/tube/lookup_history.py" "<URL>"

• Exit 0 (found): Parse the JSON output. Present the cached result in clean markdown — title, summary, key points, and the date it was summarized. Then ask: "Already summarized on <date>. Use cached result? Pass --refresh to force re-download." If the user says yes or does not respond, stop here.
• Exit 1 (not found): Continue to Step 2.

Step 2 — Check dependencies

bash "$HOME/.local/share/personal-skills/scripts/tube/check_deps.sh"

If the script exits non-zero (user declined to install), stop.

Step 3 — Extract the video ID

Parse the video ID from the URL:

• youtube.com/watch?v=VIDEO_ID → extract v= param
• youtu.be/VIDEO_ID → extract path segment
• youtube.com/shorts/VIDEO_ID → extract path segment

Step 4 — Fetch the video title

yt-dlp --skip-download --print "%(title)s" "<URL>"

Step 5 — Get the transcript

bash "$HOME/.local/share/personal-skills/scripts/tube/get_transcript.sh" "<URL>"

Capture the full output as the transcript text.

Step 6 — Summarize

Using the transcript (or video description if no transcript was available), produce:

1. Summary — 3–5 sentence overview: what the video is about, the main argument, and the conclusion.
2. Key Points — bulleted list of 5–10 concrete takeaways or facts.

Step 7 — Output to user immediately

Use ASCII tree / hierarchy style for all output. Format as follows:

<VIDEO_ID> — <title>
├── URL       : <url>
├── Duration  : <duration if available>
└── Fetched   : <date>

SUMMARY
└── <3–5 sentence overview: what the video is about, main argument, conclusion>

KEY POINTS
├── <point 1>
├── <point 2>
├── <point 3>
├── <point 4>
├── <point 5>
└── <point N>

Then on a new line: "Browse all history with /ps:web. Want a diagram for this? (y/n)"

Step 8 — Save to history (run immediately, do not wait for diagram)

python3 "$HOME/.local/share/personal-skills/scripts/tube/save_summary.py" \
  --video-id "<VIDEO_ID>" \
  --url "<URL>" \
  --title "<TITLE>" \
  --summary "<SUMMARY_TEXT>" \
  --key-points "<KEY_POINTS_TEXT>" \
  --transcript "<TRANSCRIPT_FIRST_4000_CHARS>"

Step 9 — Diagram (only if user says yes)

If the user replies y or yes:

bash "$HOME/.local/share/personal-skills/scripts/excalidraw/check_deps.sh" 2>/dev/null && echo "ok" || echo "skip"

If skip: tell the user excalidraw deps are not installed and stop.

If ok: generate a full architectural/technical diagram — not a summary. Include all technical details, flows, components, trade-offs, and code patterns from the video. Write to /tmp/tube_diagram.excalidraw, render:

REFS="$HOME/.local/share/personal-skills/scripts/excalidraw/references"
cd "$REFS" && uv run python render_excalidraw.py /tmp/tube_diagram.excalidraw --output /tmp/tube_diagram.png

Display PNG with the Read tool. Then update the saved entry — save_summary.py will automatically copy the PNG from /tmp/ to a persistent ~/.youtube-summary/diagrams/<video_id>.png:

python3 "$HOME/.local/share/personal-skills/scripts/tube/save_summary.py" \
  --video-id "<VIDEO_ID>" \
  --url "<URL>" \
  --title "<TITLE>" \
  --summary "<SUMMARY_TEXT>" \
  --key-points "<KEY_POINTS_TEXT>" \
  --transcript "<TRANSCRIPT_FIRST_4000_CHARS>" \
  --diagram-png "/tmp/tube_diagram.png"