How mmeookamy/herdr-always-need-cats works
This repository adds pixel-art cat features to the Herdr desktop app, with Claude Code usage and agent state driving sidebar, notification, pane-header, and animated-strip experiences. Users can also browse, resume, and delete saved Claude sessions. The graph includes the documented hooks, usage status line, update check, and sprite-generation capability. Some runtime modules and integrations are unsampled; their links are included only where the README or excerpts establish them.
Main entry points: strip-cats/main.js Walking cat strip · make_sprites.py Sprite generator · usage-cat/main.js Usage cat · claude-sessions/main.js Session browser
Components 20
Usage and updates
- Usage cat
usage-cat/main.js - Usage status line
statusline.py - Usage state file
- Update checker
updates.py - Update state
Agent experiences
- Agent list cats
agents-cats/main.js - Walking cat strip
strip-cats/main.js - Claude event hooks
hook.py - Cat notifications
toast-cats/main.js - Cat pane headers
pane-cats/main.js
Session browser
- Sessions shortcut
sessions-footer/main.js - Session browser
claude-sessions/main.js - Session reader
claude-sessions/sessions.py - Claude session files
- Session cache
Cat artwork
- Cat drawings
tools/drawings.py - Sprite generator
tools/make_sprites.py
Other components
- Herdr user
- Herdr app
- Claude Code
Connections 29
- Herdr user → Herdr app: uses
README.md - Herdr app → Usage cat: renders
README.md - Claude Code → Usage status line: provides status
README.md - Usage status line → Usage state file: writes
README.md - Usage cat → Usage state file: polls
README.md - Usage cat → Update checker: runs checks
usage-cat/main.js - Update checker → Update state: writes
- Usage cat → Update state: reads
usage-cat/main.js - Herdr app → Agent list cats: renders
README.md - Herdr app → Walking cat strip: renders
README.md - Claude Code → Claude event hooks: dispatches events
README.md - Claude event hooks → Walking cat strip: supplies agent activity
README.md - Herdr app → Cat notifications: renders notifications
README.md - Herdr app → Cat pane headers: renders headers
README.md - Walking cat strip → Cat pane headers: shares status
pane-cats/main.js - Walking cat strip → Agent list cats: shares coat choice
README.md - Walking cat strip → Cat notifications: shares coat choice
README.md - Herdr user → Sessions shortcut: opens sessions
sessions-footer/main.js - Sessions shortcut → Session browser: opens
sessions-footer/main.js - Herdr user → Session browser: filters and selects
README.md - Session browser → Session reader: runs
claude-sessions/main.js - Session reader → Claude session files: reads and deletes
README.md - Session reader → Session cache: caches metadata
README.md - Session browser → Herdr app: resumes or shows
README.md - Cat drawings → Sprite generator: supplies drawings
tools/make_sprites.py - Sprite generator → Agent list cats: generates cat sprites
README.md - Sprite generator → Usage cat: generates cat sprites
README.md - Sprite generator → Cat notifications: generates cat sprites
README.md - Sprite generator → Walking cat strip: generates cat sprites