adom-shotlog

Capture

What gets into shotlog without anyone asking. shotlog installs one Claude Code hook, PostToolUse(Read), in ~/.claude/settings.json. Whenever any AI thread reads an image file, the hook copies that exact file into the shared read-captures channel (a 2-second-capped local HTTP post that can never block the AI). Deliberate adom-shotlog inject calls are unaffected by this switch.

Capture: Auto-capture what AIs read

Every image any AI thread reads is copied into read-captures. If no shotlog is showing anywhere, one auto-opens on your default canvas and brings the read-captures tab to the front. Turn off to stop auto-capturing; deliberate injects still work. Takes effect on the next image an AI reads.

Default: Onor say to your AIturn the shotlog read-hook off

Notifications

How a new shot gets your attention. shotlog never steals the OS foreground: the strongest cue it will ever use is an orange flash. Unseen badges on channel tabs and the page title work regardless of these switches, and the webview keeps receiving every shot in the background no matter what: switch to it yourself and everything is already there.

Notifications: Update alerts (orange flashes)

When new shots arrive: the webview tab highlights orange, the in-app channel tab flashes, and the pup window flashes its taskbar. Unseen badges still show either way; this only controls the orange flashing.

Default: Offor say to your AIturn on the shotlog orange flashes

Notifications: Auto-switch to updated channel

When a shot arrives for another channel, that channel's tab jumps to the front. Turn off to stay where you are; the tab just shows an unseen badge (and flashes, if alerts are on).

Default: Onor say to your AIstop shotlog auto-switching tabs

Notifications: Bring the webview tab forward

When a shot lands and the Shotlog webview is open but behind another tab in its pane, pull it to the front (default). Turn it off if you live in webviews and do not want to be pulled away: you stay on whatever tab you were reading, and the webview still receives every shot (including auto-captures from the read-hook) in the background, so it is fully up to date the moment you switch to it. This is about the Hydrogen tab; the switch above is about channel tabs inside shotlog.

Default: Onor say to your AIstop shotlog pulling its webview tab to the front

Gallery

How cards look in the list. Either way, one click on a thumbnail fills the window and the next click (or Esc) comes back; the ref (#42) and any handle sit in the strip above each thumbnail.

Gallery: Compact cards (image-first)

The gallery is mostly thumbnails: the info text (headline, time, sizes, provenance chips) hides behind the ⓘ chip on each image; hover it to reveal. Turn off for the classic text-above-image cards.

Default: Onor say to your AIturn off shotlog compact mode

Canvas

Which surface shotlog opens on when it has to open one itself. A channel you explicitly opened in pup or webview keeps ITS choice; this covers everything else. Closing a pup window reverts that channel to webview for half an hour. Pup needs Adom Bridge.

Canvas: Default canvas

Where shotlog auto-opens a channel when nobody is watching. Pick the other canvas while you are watching and closing this dialog moves your shotlog there too, after a 3-2-1 countdown you can cancel.

Default: Webviewor say to your AImake shotlog default to pup

Webview layout

Where the shotlog webview lives inside your Hydrogen workspace. Pick ONE of the two layouts below; each shows a real screenshot of what you get, and the settings that only apply to that layout sit inside its box.

Shared pane: shotlog is one more tab inside the webview pane, beside your other webviews — Shotlog sits as a tab beside your other webviews.

Default. Shotlog joins your existing webview pane as one more tab, so it shares that pane's width with your other webviews.

Shared pane: Pane width

The width shotlog uses when it first CREATES the shared pane, as a percent of your workspace (10-50). It only seeds a brand-new pane; it never resizes one you already have unless auto-size is on.

%

Default: 20%or say to your AImake the shotlog webview panel 25% wide

Shared pane: Auto-size the pane

On: every time shotlog opens, it snaps the shared pane back to the width above (rude if you use webviews a lot, hence off). Off: shotlog leaves the pane at whatever width you last dragged it to.

Default: Offor say to your AIturn on shotlog webview auto-sizing

Own column: your webview pane keeps its tabs and width, and shotlog is a separate narrow column at the far right — Shotlog is its own narrow column at the far right.

Shotlog opens as its own narrow third column at the right edge, the width below, so it is always in view while your webviews keep their pane and their width. The editor gives up the space; shotlog never resizes your webview pane.

Own column: Column width

Width of shotlog's own column as a percent of the screen (5-30).

%

Default: 10%or say to your AIopen shotlog as its own 10% column on the right

Default: Shared pane

Storage

How much stays on disk. A janitor runs at startup and every 6 hours; it deletes the oldest files first and never touches a channel that is still receiving shots. The clear button in the header is the manual version: it wipes every channel at once and reports what it freed.

Storage: Keep per channel

The janitor keeps only the newest N shots per channel on disk; older files are deleted as new ones arrive. Turn the switch off to keep every shot (unlimited on disk).

shots

Default: On, 200 shotsor say to your AIkeep only the newest 100 shots per shotlog channel

Storage: Prune idle channels after

Channels with no new shots for this many days are deleted entirely. Turn the switch off to never prune.

days

Default: On, 30 daysor say to your AInever auto-delete idle shotlog channels