> ## Content Index
> Fetch the complete content index at: https://claudefox.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# lot-map: a live map beside the chat that shows what Claude Code is doing
- URL: https://claudefox.com/lot-map-claude-code-live-activity-map-mod/
- Published: 2026-11-15T21:33:48.000Z
- Updated: 2026-11-17T13:19:18.000Z
- Description: lot-map (alexeyw/lot-map) is a free, MIT-licensed Claude Code mod that draws a live map in a pane beside the chat: tool calls, model steps, hooks, skills and subagents light up ten stations as they run. It runs locally and makes no network requests.
- Author: hupicake
- Tags: Tools

lot-map (GitHub: alexeyw/lot-map) is a Claude Code mod that draws your session as a live map in a pane beside the chat. Ten stations ring a centre labelled CLAUDE (You, Model, Memory, Files, Shell, Network, Browser, Agents, Skills and Hooks), and every tool call, model step, hook and skill sends a pulse out to its station and back. Created on November 9, 2026, it had 882 stars and 93 forks when we checked on November 16\. Version 0.8.0 is dated November 14 in the changelog and was released on GitHub on November 15.

## Quick facts

- What it is: a Claude Code plugin (the README calls it a mod) in TypeScript, installed from its own marketplace, with one command, /lot-map.
- Where it runs: the Claude desktop app, terminal sessions and the VS Code extension. Built and tested on Claude Code 2.1.321 on macOS, the version CI uses, with Node 22 in CI; users report it working on Windows.
- Licence and cost: MIT, free. No account, server or service.
- Languages: English, Russian, Spanish, French, German, Italian and Portuguese labels.

## How to install

At the prompt of a terminal session, the README's command is /plugin install lot-map --marketplace alexeyw/lot-map; answer y to add the marketplace, then pick a scope. From a shell:

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

# if it says the plugin is not found in any marketplace:
claude plugin marketplace add alexeyw/lot-map
claude plugin install lot-map@lot-map
```

In the desktop app: + next to the prompt box, Plugins, Add marketplace with alexeyw/lot-map, then Add plugin. To update, run claude plugin marketplace update lot-map, then claude plugin update lot-map@lot-map, and start a new session. Installing and updating fetch from GitHub; the mod itself makes no network requests once it runs.

## First run

The pane opens by itself when a session starts. In a terminal it needs at least 144 columns (otherwise type /lot-map) and shows only rows of activity. terminalView set to picture paints the map as an image in iTerm2 3.5+, kitty or Ghostty; braille draws it in dots, for terminals such as Windows Terminal. Both need fullscreen: /tui fullscreen or CLAUDE\_CODE\_NO\_FLICKER=1 claude.

Change options later with /config or claude plugin configure, then restart the session. Worth a first look: language, theme, layout, motion (reduced: nothing flies, spreads or spins) and the memory settings, which say which MCP servers (memoryServers), commands (memoryCommands) or path parts (memoryPaths) light Memory. In VS Code, Zoom out and Zoom in pick one of six map widths from 160 to 400 pixels, and Hide map folds the pane to one line.

![lot-map mid-session: the Files station lit with three calls running, Memory and Model glowing, and a list of recent calls below the map](https://claudefox.com/content/images/lab/2026-11-16/lot-map-claude-code-live-activity-map-mod-img2-8a969c5fa0.png)

A replayed demo session with three file reads running at once. Image: alexeyw/lot-map (MIT)

## What the map shows

Files takes Read, Write, Edit, Grep, Glob and shell commands that only touch files, such as cat, mv and sed. Network takes web fetch and search, MCP servers and commands such as curl, gh, ssh, git push, npm install and, since 0.8.0, kubectl, aws and gcloud. Other shell commands land on Shell. A command is read by its name, so python -c with a socket inside shows as Shell; one behind sudo, xargs or bash -c is read as the command it runs.

A thin route joins the last stations visited and fades after a minute; clock hands grow around a running call. A ring around the centre fills with the context window, amber at 70% and red at 90%. Subagents circle Agents, and errors or hook refusals leave a red count until your next message. Below sit the last 16 rows with timings.

![lot-map with the Hooks and Shell stations marked red after a hook blocked a recursive delete and a test command failed](https://claudefox.com/content/images/lab/2026-11-16/lot-map-claude-code-live-activity-map-mod-img4-39745bf34d.png)

A settings hook refuses a recursive delete; Hooks and Shell carry red counts. Image: alexeyw/lot-map (MIT)

## What stands out

- It is built to watch and change nothing, and shows how that is checked: PRINCIPLES.md ties each of six rules to a test or script.
- The surface is a file you can diff. scripts/surface.txt lists 14 hooks, 13 engine calls, one environment variable (COLORFGBG) and one state key; CI fails on any call not on the list and on any file, process, model or fetch call.
- Labels hold names, not content: a file's last two path parts, a URL's host, never the command line. The exceptions are model-written words, listed under Known limits.
- Measured cost on the author's M1 Pro: about 13 microseconds to name a call, 80 to draw a busy map, 36 ms for the worst input found (a 200,000-character piped command). The terminal picture costs 19 to 20 ms a frame at up to 30 frames a second while moving; braille frames took under 0.25 ms on an Intel PC under Windows 11.
- One board, three renderers: an SVG drawing in the desktop app, a PNG the mod paints itself for picture terminals, and braille cells for the rest.

![The lot-map board drawn in braille dots inside Windows Terminal, with station names and a list of calls underneath](https://claudefox.com/content/images/lab/2026-11-16/lot-map-claude-code-live-activity-map-mod-img8-f4a3f6b62d.png)

The braille view in Windows Terminal, added in 0.8.0\. Image: alexeyw/lot-map (MIT)

## How it was built with Claude

Of 61 commits on main up to November 15, 57 carry a Claude Co-Authored-By trailer: 49 name Claude Fable 5.2, seven Claude Opus 5.5 and one Claude Opus 4.6\. The author, Aleksei Volodin, credited Opus 5.5 on the first two commits and Fable 5.2 after that. Nine other people contributed, including the terminal picture and the braille view. CONTRIBUTING.md welcomes AI-written code but asks contributors to read the diff and run the tests; the design rules are written down in PRINCIPLES.md. The changelog records one rollback: 0.4.0 dropped the permission-check hook, and 0.5.0 restored it.

For what mods can reach and how organisations restrict them, see our earlier piece: https://claudefox.com/what-a-claude-code-mod-can-do-and-the-guard-solo-users-dont-get/

**Try it with your AI.** Installs follow main. This prompt has your agent check the mod against its own stated surface and stop before installing.

```
Check the Claude Code mod lot-map (github.com/alexeyw/lot-map) before I install or
update it. Do not install anything until I confirm.

First run claude --version, git --version and node --version. If any is missing or
fails, stop and tell me.

1. Clone the repository into ~/review/lot-map. If that folder exists and is not empty,
   stop and ask me for another. Run no script from it except the three commands in step
   3.
2. Read PRIVACY.md, PRINCIPLES.md and scripts/surface.txt. Summarise what the mod hooks,
   which engine calls it makes, which environment variable it reads and what it stores
   between sessions.
3. In that folder run claude plugin validate . then claude plugin test . then node
   scripts/check-surface.mjs (all local, no account). Report pass or fail for each with
   the last lines of output. If any fails, stop.
4. Ask me whether lot-map is installed and which version. If it is, run git log
   --oneline v<version>..origin/main (tags look like v0.8.0); if the tag is missing, say
   so and show the last 20 commits. Point out changes to scripts/surface.txt, PRIVACY.md
   or hooks/classify.ts.
5. Show your summary and wait for my confirmation. Only then run claude plugin
   marketplace add alexeyw/lot-map and claude plugin install lot-map@lot-map (to update:
   claude plugin marketplace update lot-map and claude plugin update lot-map@lot-map).

Do not edit my settings, touch credential files or delete anything. Finish with the
Claude Code and lot-map versions, each check's result, and what you could not check.
```

## Known limits

- What it reads: Claude Code hands such a mod the whole input of every call, including command lines, paths, file text and subagent prompts. lot-map keeps names, except that shell, monitor and subagent descriptions are the model's words, shown unchecked up to 120 characters. Off by default: hookReasons (a refusal's first line, 72 characters), subagentNames (40 characters) and hookRecords, which counts a \[#123\] number in any hook's text.
- What it keeps: the session's rows; between sessions, the last model's name per folder, stored under the folder's full path (usually containing your account name), and two VS Code pane settings.
- Updates follow main, and SECURITY.md says only the latest version gets fixes, from a maintainer working alone.
- On Team and Enterprise logins, open issue #54 reports a built-in guard skipping the mod's classic.\* hooks with a notice on every prompt and tool call, so the Hooks station cannot work there.
- The context ring shows the share of the whole window, not distance to a custom compaction threshold (#53).
- VS Code on Windows: one user saw only alt text until switching tabs (issue #69).
- The braille view drops the route, clock hands and fades. Open requests include an MCP station (#55) and one-word skins (#67).

## Related on claudefox

- [PhoneBox turns an old Android phone into a desk panel and control deck for Windows, Linux and macOS](https://claudefox.com/phonebox-old-android-phone-desk-panel/)
- [BLA (bla-agents): a CLI and MCP server that trips AI reverse-engineering limits on release files](https://claudefox.com/bla-agents-mcp-cli-ai-reverse-engineering-defense/)
- [llama-modchip runs the 284B DeepSeek-V4-Flash on a 64 GB PC with no GPU, using patched llama.cpp](https://claudefox.com/llama-modchip-deepseek-v4-flash-64gb-cpu/)
- [Reverse-engineering 10 paid apps with Opus 5.5 and REA](https://claudefox.com/reverse-engineering-10-paid-apps-with-opus-5-5-and-rea/)

## Problems and feedback

Bugs go to GitHub issues, with the lot-map and Claude Code versions. Security problems, such as a label that shows content, go privately through the Security tab. Pull requests target the next branch.

## FAQ

Does lot-map send my work anywhere? No. PRIVACY.md says it makes no network requests and has no telemetry, analytics or crash reports; it reads no files and runs no processes.

Why does my update say I already have the latest version? Run claude plugin marketplace update lot-map before claude plugin update lot-map@lot-map, then start a new session.

Why does the Hooks station stay dark on a Team or Enterprise login? Issue #54 reports that a built-in guard skips the mod's classic.\* hooks there. An opt-out was agreed but not merged when we checked.

How do I remove what it stored? Uninstall the plugin; PRIVACY.md says that removes the model names and VS Code pane settings it keeps.

Source: [GitHub: alexeyw/lot-map](https://github.com/alexeyw/lot-map?ref=claudefox.com), [lot-map README](https://github.com/alexeyw/lot-map/blob/main/README.md?ref=claudefox.com), [lot-map PRIVACY.md](https://github.com/alexeyw/lot-map/blob/main/PRIVACY.md?ref=claudefox.com), [lot-map PRINCIPLES.md](https://github.com/alexeyw/lot-map/blob/main/PRINCIPLES.md?ref=claudefox.com), [lot-map CHANGELOG.md](https://github.com/alexeyw/lot-map/blob/main/CHANGELOG.md?ref=claudefox.com), [lot-map CONTRIBUTING.md](https://github.com/alexeyw/lot-map/blob/main/CONTRIBUTING.md?ref=claudefox.com), [lot-map SECURITY.md](https://github.com/alexeyw/lot-map/blob/main/SECURITY.md?ref=claudefox.com), [lot-map plugin manifest](https://github.com/alexeyw/lot-map/blob/main/.claude-plugin/plugin.json?ref=claudefox.com), [lot-map surface list](https://github.com/alexeyw/lot-map/blob/main/scripts/surface.txt?ref=claudefox.com), [lot-map CI workflow](https://github.com/alexeyw/lot-map/blob/main/.github/workflows/check.yml?ref=claudefox.com), [lot-map releases](https://github.com/alexeyw/lot-map/releases?ref=claudefox.com), [lot-map commit history](https://github.com/alexeyw/lot-map/commits/main?ref=claudefox.com), [Issue #54: Team/Enterprise guard skips classic hooks](https://github.com/alexeyw/lot-map/issues/54?ref=claudefox.com), [Issue #53: context ring and custom compaction](https://github.com/alexeyw/lot-map/issues/53?ref=claudefox.com), [Issue #69: VS Code on Windows first render](https://github.com/alexeyw/lot-map/issues/69?ref=claudefox.com)

This story first appeared in the [claudefox daily briefing for November 16, 2026](https://claudefox.com/daily-2026-11-16/).