A Claude Code mod that draws a map of the agent's work hit 1000 stars in 10 days
The author asked a Claude Code agent to draw its own work and turned the picture into a mod. The model sits in the center, surrounded by ten stations: files, terminal, network, memory and more. In ten days the repository collected 1000 stars. On November 11, at users' request, the author shipped 14 releases in a single day. The mod only observes and changes nothing, so the author turned down block buttons and skins. The takeaway for extension authors: a narrow focus and written principles earn more trust than a pile of features.
AI-processed from Habr AI; edited by Hamidun News
When an agent works in a terminal, all you see is a stream of text lines. What is it doing right now: reading files, going out to the network, launching a subagent? You can work it out, but you have to squint at the log. The author of the lot-map mod solved this problem in a simple way. He asked his Claude Code agent to draw how it sees its own workflow, and turned the drawing into an extension. In ten days the repository collected 1000 stars. That is a good result for a small open-source project, and the way the author ran it is even better.
How it works and how it grew
On the map, the model sits in the center, surrounded by ten stations: files, terminal, network, memory, subagents, hooks and others. When the agent calls a tool, a pulse runs to the matching station, and the latest calls are listed below the map. The first version came out on November 9, and the author showed it on r/ClaudeAI with a video. By the night of November 11 it had 100 stars, by November 12 it had 500, and by November 18 it had 1000.
Growth went hand in hand with feedback. On November 11 alone, fourteen versions shipped: almost every request from the comments turned into a release. That is how the map flip, custom colors, a transparent background, a fix for Windows paths and Italian and Portuguese labels appeared. The current version is 0.12.0. Users praise the ring around the center most, which shows how full the context is. There is also a token counter that shows how much each call added to the context.
The terminal, iTerm2 and the Anthropic catalog
Claude Code renders images only in its app and in VS Code; in the terminal, you get plain text lines. The author tried drawing the map with characters and admitted it turned out badly: seven static lines. Then enthusiasts stepped in. One sent a 2000-line pull request in which the mod draws a PNG itself and feeds it to the terminal frame by frame (version 0.6.0). Another built a Braille-font map for terminals without image support, such as Windows Terminal.
Then an ugly failure turned up. One user ran out of memory: iTerm2 grew from 286 MB to 17 GB in five minutes because it stored every frame until the tab was closed. The mod cannot work around this on its side, so version 0.9.0 disabled the image in iTerm2. The author sent a report to the iTerm2 developer, who fixed the bug the next day. Version 0.12.0 brought the image back for iTerm2 starting from 3.7.8.
The Anthropic catalog went worse. To pass validation, the author removed the permission-check hook from the mod (version 0.4.0), and two rows disappeared from the map. In the end a rejection came anyway: the catalog accepts mods only from verified organizations. The hook returned in 0.5.0. The lesson is simple: don't bend your product to fit a platform until you know its terms.
What was rejected and why the mod earned trust
The author turned down skins with steampunk and comets: the map exists so you can see at a glance what the agent is doing, and a comet is just decoration. He turned down buttons that could block the agent's network or terminal access: the mod only watches and changes nothing, and trust rests on that. He also turned down a layer for other agents, because nobody had run the map with anything but Claude Code. Ports live in separate repositories.
On day five, the author wrote down six principles: the mod changes nothing; labels carry only a name, never the content; it costs almost nothing to run; a failure on the map does not interfere with the agent's work; the map stays calm; and the user's settings stay as they are. Each principle lists the test that protects it. For the first, a test checks that an event is passed on exactly as it arrived.
For the third, there are measurements against a time budget. The repository contains a list of everything the mod requests from Claude Code, and a check on every pull request compares the code against it. Network access, file reads and process launches are not on that list.
The second principle was needed before it was written down. The mod sees every call in full: commands, paths, URLs with parameters, and the screen ends up in screenshots. That is why a curl command with a token is reduced to the word curl on the map, and a URL to its host. On day three, someone reading the code found a way to write a URL so that a password still ended up in the label. It was fixed the same day.
Outside checks
A Japanese blogger ran five tasks and forty calls, checking the map every half second. All forty landed on the right station, and the target's name showed up in thirty of them. His conclusion: the map gives an overview but does not replace the log. In Spain, someone ran the mod through a security scanner and manually reviewed ten findings: all turned out to be false positives, with the scanner flagging curl and sudo in tests. Someone built an overlay for Codex on the same files, and someone else added a timeline of turn durations.
For those who write extensions for agents, the takeaway is practical. The narrow "watch only" role made it possible to state verifiable guarantees. A list of principles with tests made it easy to turn down other people's ideas without arguments. The limitations are honest, too: this is an overview, not a replacement for the log, and in terminals without image support the map looks poorer. You can view the mod in a browser at alexeyw.github.io/lot-map, and the code is in the alexeyw/lot-map repository.
- Nov 20, 2026US Outage Wave: Officials See No Attack, Experts Blame Rush to Patch After AI Discoveries
- Nov 20, 2026A Seven-Minute AI Film in 7 Days for $300–400: Blender Blockouts Instead of Live Shooting
- Nov 20, 2026MacRun rents out Mac minis for AI agents at $169 a month and earns ~$2K
- Nov 20, 2026Anthropic goes public: shares open at $111.50 versus an $83 offer price, up 34%
Key Questions Answered
How it works and how it grew?
On the map, the model sits in the center, surrounded by ten stations: files, terminal, network, memory, subagents, hooks and others. When the agent calls a tool, a pulse runs to the matching station, and the latest calls are listed below the map. The first version came out on November 9, and the author showed it on r/ClaudeAI with a video. By the night of November 11 it had 100 stars, by November 12 it had 500, and by November 18 it had 1000. Growth went hand in hand with feedback.
What are the key details on The terminal, iTerm2 and the Anthropic catalog?
Claude Code renders images only in its app and in VS Code; in the terminal, you get plain text lines. The author tried drawing the map with characters and admitted it turned out badly: seven static lines. Then enthusiasts stepped in. One sent a 2000-line pull request in which the mod draws a PNG itself and feeds it to the terminal frame by frame (version 0.6.0). Another built a Braille-font map for terminals without image support, such as Windows Terminal. Then an ugly failure turned up.
What was rejected and why the mod earned trust?
The author turned down skins with steampunk and comets: the map exists so you can see at a glance what the agent is doing, and a comet is just decoration. He turned down buttons that could block the agent's network or terminal access: the mod only watches and changes nothing, and trust rests on that. He also turned down a layer for other agents, because nobody had run the map with anything but Claude Code. Ports live in separate repositories.
Build & Ship Production AI Agents Without Boilerplate Code
Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.
The AI world, distilled — once a week
Seven stories that actually mattered, hand-picked. No noise, no reposts, no press releases.
Done! Check your inbox for a confirmation.