name: shotlog description: "Screenshot log viewer and injector. Use when: logging screenshots during debug loops, documenting visual progress, reviewing screenshot history, opening the screenshot log panel, injecting a screenshot into the log. Trigger words: shotlog, screenshot log, shot log, visual log, screenshot history, log screenshot, open shotlog, screenshot viewer."

Shotlog - Screenshot Log

Binary: /usr/local/bin/shotlog Port: 8820

CRITICAL: Always write great descriptions

The --desc flag is the most important part of every inject. The description becomes the filename (slugified), so it needs to be specific and descriptive. Future you (and the user) will read these filenames in the folder to understand what happened.

Bad descriptions:

--desc "screenshot"
--desc "test"
--desc "after fix"
--desc "board"

Good descriptions:

--desc "PCB board layout after routing power traces"
--desc "3D model front view with LED indicators lit"
--desc "Sign placement on rail car side panel verified"
--desc "Schematic after adding decoupling caps to U3"
--desc "Homepage hero section with animation at frame 42"
--desc "Error state when WiFi disconnected"

Think: what was I doing, what am I looking at, and why did I take this shot? Put that in the description.

Quick Start

shotlog serve &
shotlog open --channel my-project
shotlog inject -c my-project -d "Initial board layout before routing" -s av_capture screenshot.png
shotlog health
shotlog install

Commands

shotlog inject

shotlog inject -c CHANNEL -d "DESCRIPTION" -s SOURCE FILE

shotlog paste

Like inject but resizes to max 1400px width first.

shotlog resize

shotlog resize FILE                    # Resize in-place to max 1400px
shotlog resize FILE -o output.png      # Resize to new file
shotlog resize FILE -w 800             # Custom max width

shotlog open

shotlog open -c my-project             # Open webview tab in Hydrogen

shotlog serve

shotlog serve                          # Default port 8820, data in ./screenshots/shotlog
shotlog serve -p 8820 -d ./data        # Custom port and data dir

shotlog health

shotlog health                         # Check if server is running

shotlog install

shotlog install                        # Install skill + bash completions

Integration Pattern

After taking ANY screenshot, always inject it into shotlog with a good description:

# After pup browser_screenshot
SHOT=$(node ~/gallia/server/conduit-cli.js browser_screenshot '{"sessionId":"..."}' | python3 -c "import sys,json; print(json.load(sys.stdin).get('savedTo',''))")
shotlog inject -c my-project -d "Homepage after nav redesign with dropdown open" -s pup_screenshot "$SHOT"

# After av_capture saves to disk
shotlog inject -c my-project -d "3D component viewer showing SOIC-8 package from top" -s av_capture /path/to/screenshot.png

# Resize a large image for AI consumption
shotlog resize large-screenshot.png
shotlog inject -c my-project -d "Full schematic page 2 after DRC cleanup" -s manual large-screenshot.png

Browser Paste

Users can Ctrl+V in the shotlog webview to paste clipboard screenshots. Pasted images are auto-resized to max 1400px width.

Channel Naming

Use the project or task name:

• board-review - PCB layout review
• schematic-check - Schematic verification
• sign-designer - Sign placement work
• debug-session - Active debugging

Output

All commands use colored OK/ERROR output:

OK: Injected pcb-board-layout-after-routing-power-traces.png (1400x765, 538 KB) into channel board-review
OK: Shotlog server running on port 8820 with 3 channel(s)
ERROR: Cannot connect to shotlog on port 8820
Hint: Start with: shotlog serve &