ClaudeMap

lot-map

A Claude Code plugin that draws a live map of the session in a pane beside the chat — every tool call, model step, hook and skill pulses from the centre to its memory, files, shell, web and agents stations, and everything stays on your machine

Plugins & Agentsclaude codepluginobservabilityvisualizationlocaltypescript

lot-map is a mod for Claude Code: a live map of the work in a pane beside the chat. Every tool call, model step, hook and skill sends a pulse from the centre to its station — memory, files, shell, web and agents — so you see what is at work instead of reading a list of commands. The map layers on detail as the session goes: a thin route line joins the last few stations the main loop went through (legs stay 40 seconds, fade over 20); spokes grow thicker and brighter the more their station is used; two clock hands grow around a station while a call runs (inner one minute, outer ten); background work — a background command, monitor, subagent or workflow — stays lit with its own clock until the task reports it ended, and a failed task leaves a red dot; calls that start together fly side by side and the station carries their number (×3). It runs on your machine and sends nothing anywhere; PRIVACY.md documents what it reads and keeps and PRINCIPLES.md the checks that hold it to that. Install from the Claude Code plugin marketplace; the pane opens by itself when a session starts. In a terminal it needs at least 144 columns — below that it draws text only, and the map can also render as a picture or in braille dots. Built and tested on Claude Code 2.1.321 on macOS; users report it working on Windows as well.

What it does

  • Live stations for memory, files, shell, web and agents, fed by a pulse from every tool call, model step, hook and skill
  • The route: a thin line joins the last few stations the main loop went through, in order; a leg stays 40 seconds and fades over 20, so a minute after work stops only the spokes remain
  • Worn spokes grow thicker and brighter the more their station is used, so the end of a session shows where the work went
  • Clock hands grow around a station while a call runs (inner one minute, outer ten); background work stays lit until the task reports it ended; failed tasks leave a red dot; concurrent calls fly side by side with a ×N count
  • Terminal-aware rendering: needs at least 144 columns, draws text only below that, and the map can render as a picture or in braille dots on request

When to use it

Use when you want to watch a long or autonomous Claude Code run without tailing the transcript — see which stations a refactor touches, notice a background task that never reports back, or glance at the route line to check the main loop is not stuck ping-ponging between two stations.

Getting started

Interactive, at the Claude Code prompt:

/plugin install lot-map --marketplace alexeyw/lot-map

Answer y to add the marketplace, then choose a scope. From a shell:

claude plugin install lot-map --marketplace alexeyw/lot-map

If it answers that the plugin is not found in any marketplace, add the marketplace first:

claude plugin marketplace add alexeyw/lot-map
claude plugin install lot-map@lot-map

In the desktop app: click + next to the prompt box, then Plugins, Add marketplace with alexeyw/lot-map, then Add plugin. The pane opens by itself when a session starts; in a terminal below 144 columns type /lot-map.

Things to know

Local-by-design: the README states it runs on your machine and sends nothing anywhere, and PRIVACY.md documents that like any mod following tool calls it is handed each call whole and takes names from that and nothing else — read both it and PRINCIPLES.md before trusting the framing. Station naming is by command, not intent: a script that opens its own connection shows as Shell; sudo/env/timeout/nohup/xargs wrappers are read as the command they run; here-document text is not read, so a file written through one shows as Files; npx counts as Network only with -y; a line is read up to its first 8,000 characters. Built and tested on Claude Code 2.1.321 on macOS — Windows support is user-reported, not the author's test matrix. MIT. 1,003 stars as of writing (2026-11-19).

Repository

alexeyw/lot-map

Charted

Related on the map

  • clawd-conduit

    Plugin / Agent

    Wire all 15 Claude Code hook events into the Clawd on Desk desktop pet — and turn permission requests into a blocking desktop card.

    • hooks
    • desktop
    • notifications
    • claude-code
  • CometixCode

    Plugin / Agent

    An unofficial Rust 1:1 reimplementation of the Claude Code terminal UI, ported file-for-file onto an iocraft TUI framework.

    • terminal-ui
    • rust
    • reimplementation
    • unofficial
  • Abide

    Plugin / Agent

    Hook-level enforcement for the natural-language rules in AGENTS.md and CLAUDE.md — every edit is judged and violations are repaired in the same turn.

    • hooks
    • code-review
    • rules
    • agents-md