How alexeyw/lot-map works
lot-map is a Claude Code mod that turns session and tool activity into a live map and feed in a side pane. Claude Code events are recorded on a session board, with tool inputs classified into stations; the pane then renders the board as a terminal map or graphical map. Separate capabilities include agent activity, hook outcomes, memory attribution, context/model changes, and localized labels. The excerpts show registration, board updates, pane rendering, classification and drawing; other event coverage and persistence behavior is included only where the README documents it.
Main entry points: register.tsx Event registration · map.ts Tool classifier · text.ts Language strings
Components 16
Claude Code integration
- Event registration
hooks/register.tsx
Activity tracking
- Tool classifier
hooks/map.ts - Station activity
hooks/register.tsx - Agent activity
hooks/register.tsx - Hook outcomes
hooks/register.tsx - Memory attribution
hooks/map.ts - Context and model
hooks/register.tsx
Map presentation
- Language strings
hooks/text.ts - Map drawing
hooks/map.ts - Side-pane feed
hooks/register.tsx
Session and settings
- Activity board
hooks/register.tsx - Last model by folder
hooks/register.tsx - Map options
hooks/map.ts - Board types
types/index.d.ts
Other components
- User
- Claude Code
Connections 20
- User → Claude Code: sends messages
README.md - Claude Code → Event registration: emits session events
README.md - Event registration → Tool classifier: uses classification
hooks/register.tsx - Event registration → Station activity: records activity
hooks/register.tsx - Event registration → Agent activity: tracks subagents
hooks/register.tsx - Event registration → Hook outcomes: records outcomes
hooks/register.tsx - Tool classifier → Memory attribution: identifies memory
hooks/map.ts - Event registration → Context and model: records model steps
hooks/register.tsx - Event registration → Activity board: updates and reads
hooks/register.tsx - Event registration → Last model by folder: loads and saves
README.md - Claude Code → Last model by folder: persists model name
README.md - Map options → Tool classifier: configures categories
hooks/map.ts - Event registration → Map options: loads options
hooks/register.tsx - Event registration → Side-pane feed: renders pane
hooks/register.tsx - Side-pane feed → Activity board: reads activity
hooks/register.tsx - Side-pane feed → Map drawing: draws graphical map
hooks/register.tsx - Map drawing → Language strings: uses labels
hooks/map.ts - Event registration → Language strings: loads strings
- User → Side-pane feed: opens map command
README.md - Event registration → Claude Code: queries context usage
README.md