Claude Code 세션을 지도로 그리면, 일이 간 곳의 스포크가 닳아 있다

코딩 에이전트의 출력은 기록 그 자체입니다. 스크롤되고, 선형이고, 도구 호출이 마흔 번을 넘어가면 세션의 모양은 이미 사라집니다. 파일 여섯 개를 읽고 테스트를 한 번 돌렸다는 건 압니다. 하지만 일의 대부분이 셸로 갔는지 grep으로 갔는지, 메모리 폴더를 건드리기는 했는지, 컨텍스트 윈도가 얼마나 남았는지는 모릅니다.
lot-map은 그 질문에 답하는 Claude Code 플러그인이고, 채팅 옆에 패널을 하나 띄웁니다. 도구 호출, 모델 단계, 훅, 스킬이 하나하나 패널 중심에서 어느 역으로 펄스를 보냅니다. 뭔가 시작되면 펄스가 날아가고, 끝나면 돌아옵니다. 거부와 오류는 빨갛게 변합니다.
아이디어는 작습니다. 다만 무엇을 그리고 무엇을 빼놓을지에 대해 필요 이상으로 공을 들였습니다.
역
역은 열한 개이고, 각각이 작업의 한 종류입니다.
You는 당신의 메시지, 당신에게 보낸 파일, 작업 목록, 계획, 그리고 승인을 요청받은 것들을 담습니다. Model은 모델 요청과 컨텍스트 압축. Memory는 Claude Code의 메모리 폴더와 options에서 이름을 지정한 것들. Files는 Read, Write, Edit, Grep, Glob, 언어 서버의 코드 인텔리전스, 그리고 파일만 건드리는 셸 명령. Shell은 나머지 모든 명령. Network는 web fetch와 검색, MCP 서버, claude.ai에 둔 것, 네트워크로 나간다고 알려진 셸 명령. Browser는 브라우저 도구. Agents는 서브에이전트, 워크플로, 스케줄, 백그라운드 작업 대기. Skills는 스킬, tool search, 그리고 스킬과 플러그인과 커넥터 카탈로그. Hooks는 호출을 거부하거나 권한을 묻거나 컨텍스트를 더하거나 잠깐 시간을 쓰는 settings 훅입니다.
셸 명령 분류가 공정의 대부분을 차지하고, 필요 이상으로 꼼꼼합니다. 전체 경로로 실행되는 프로그램은 이름으로 읽습니다. 공백이 든 따옴표 경로도 마찬가지라 CURL.EXE는 curl로 셉니다. sudo, env, timeout, nohup, xargs 뒤에 붙은 명령은 그것이 실행하는 명령으로 읽습니다. find -exec는 실행하라고 지시받은 것으로 읽습니다. for, if, while, !, 중괄호 그룹 안의 명령도 그렇고, bash -c나 eval에 넘긴 한 줄도 그렇습니다. npx는 -y가 붙을 때만 Network로 세는데, 이유는 그것이 없으면 대개 이미 설치된 걸 돌리는 경우이기 때문입니다.
Windows에서는 PowerShell 도구를 PowerShell 자신의 이름으로 같은 방식으로 읽습니다. Get-Content와 Select-String은 Files를 켜고, Invoke-WebRequest는 Network를 켭니다.
지도 읽는 법
경로는 메인 루프가 마지막으로 지나온 몇 개의 역을 순서대로 이은 것이고, 가장 최근 구간이 스스로 그려집니다. 한 구간은 40초 남아 있고 20초에 걸쳐 옅어지므로, 작업이 멈추고 1분이 지나면 스포크만 남습니다.
스포크는 쓸수록 굵고 밝아집니다. 이게 이 물건의 핵심입니다. 세션이 끝날 때 지도는 일이 어디로 갔는지 보여 줍니다. 바빠 보이는데 Files에는 가느다란 스포크 하나, Shell에는 굵은 스포크 하나가 있는 세션이라면 이미 말을 다 한 셈입니다.
호출이 도는 동안 역 둘레로 바늘이 두 개 자랍니다. 하나는 1분에 한 바퀴, 다른 하나는 10분에 한 바퀴. 백그라운드로 보낸 작업, 모니터, 백그라운드 서브에이전트, 워크플로는 그것을 시작한 턴이 끝난 뒤에도 켜진 채로 남아 바늘이 계속 자라고, 과제가 완료를 보고할 때까지 이어집니다. 실패한 과제는 빨간 점을 남깁니다.
같이 시작한 호출은 나란히 날아가고 역에 ×3 같은 개수가 붙습니다.
Memory에는 전용 색이 있습니다. 속이 찬 펄스는 Claude가 요청한 기억입니다. 점선 위의 빈 펄스는 훅이 요청 없이 가져온 것입니다. 역 아래 숫자는 전자를 세고, ↓는 후자를 셉니다. 메모리 폴더가 뭔가 하고 있는지 궁금했던 적이 있다면 이건 직접적인 판독입니다.
중심의 링은 세션이 진행되며 채워지고, 이름 위에 퍼센트가 붙습니다. 70퍼센트에서 호박색, 90에서 빨강. 모델을 바꾸면 중심과 Model 역이 몇 초 동안 울리고 피드에 opus 5.5 → fable 5.2 같은 줄이 생깁니다. 같은 폴더의 지난 세션과 다른 모델로 시작할 때도 이게 뜨는데, 자기가 슬그머니 옮겨 가는 걸 잡아내는 은근한 방법입니다.
프라이버시의 선, 그리고 그것이 인정하는 것
README의 그 문장은 통째로 인용할 만합니다. 당신의 기계에서 돌고 어디로도 아무것도 보내지 않는다, 그리고 로컬이라는 것이 눈먼 것과 같은 말은 아니다.
바로 다음 문단이 이유를 설명합니다. 도구 호출을 따라가는 모드가 다 그렇듯 호출은 통째로 건네지고, 거기서 이름만 가져오고 다른 건 건드리지 않습니다. 무엇을 읽고 무엇을 남기는지는 PRIVACY.md에, 그것을 지키게 하는 검사는 PRINCIPLES.md에 있습니다.
이 표현이 좋은 이유는 이 분야가 너무 쉽게 하는 주장을 거절하기 때문입니다. 로컬 도구도 당신이 준 것은 전부 봅니다. "프라이버시"의 정직한 정의는 기계 밖으로 나가는 것에 대한 진술과 읽히는 것에 대한 진술 두 개로 이루어지고, 이 플러그인은 둘 다 적어 두었습니다.
그 말은 이 지도가 행동 요약이라는 뜻이고, 감사 로그는 아닙니다. python -c 안에서 연결을 여는 스크립트는 Shell로 표시됩니다. 분류가 명령 이름을 보기 때문입니다. 히어도큐먼트의 본문은 읽지 않으므로 그것을 통해 쓴 파일은 본문이 무엇이든 Files로 표시됩니다. 한 줄은 앞의 8,000자까지만 읽습니다. 시각화에는 합당한 한계이고 컴플라이언스 기록으로는 실격입니다. 지금 보고 있는 게 어느 쪽인지는 알아 두는 게 좋습니다.
설치
Claude Code 프롬프트에서:
/plugin install lot-map --marketplace alexeyw/lot-map
마켓플레이스를 추가할지 물으면 y라고 답하고 스코프를 고릅니다. 셸에서는:
claude plugin install lot-map --marketplace alexeyw/lot-map
어느 마켓플레이스에도 플러그인이 없다고 하면 마켓플레이스를 먼저 추가합니다:
claude plugin marketplace add alexeyw/lot-map
claude plugin install lot-map@lot-map
데스크톱 앱에서는 프롬프트 상자 옆의 플러스를 누르고 Plugins를 골라 alexeyw/lot-map으로 마켓플레이스를 추가한 다음 플러그인을 추가합니다.
패널은 세션이 시작되면 저절로 열립니다. 터미널에서는 144칸 이상이 필요하고, 그보다 좁으면 /lot-map을 입력합니다. 지도를 그림이나 점자로 달라고 하지 않는 한 글자로만 그립니다. 업데이트에는 명령 두 개가 필요하고 첫 번째는 빼먹을 수 없습니다. claude plugin marketplace update lot-map 다음에 claude plugin update lot-map@lot-map, 그다음 새 세션을 시작합니다. 첫 번째를 건너뛰면 두 번째가 설치된 버전을 최신이라고 보고합니다.
macOS의 Claude Code 2.1.321에서 만들고 시험했으며, Windows에서도 된다는 사용자 보고가 있습니다.
왜 표가 아니라 지도인가
표가 정보는 더 많이 담습니다. 역으로 정렬하고, 시간을 합산하고, 횟수를 내보낼 수 있습니다. 다만 그건 대시보드이기도 하고, 대시보드는 한 번만 열립니다.
지도가 통하는 이유는 그것이 배경적이기 때문입니다. 채팅 옆에 있고, 뭔가 일어나면 움직이고, 읽지 않고도 읽히는 모양을 조금씩 쌓습니다. 한 시간 뒤 닳아 있는 스포크는 원래 보이지 않는 것에 대한 기억 보조 장치입니다. 세션이 주의력과 컨텍스트를 얼마나 썼는지를 역마다 보여 주니까요.
해결하는 문제가 바로 그것입니다. 컨텍스트 관리는 에이전트 작업에서 자기 자신은 보이지 않는 기술입니다. 70퍼센트에서 호박색이 되는 링과, 셸이 세션을 먹었다고 말해 주는 스포크가 있으면 안 보이던 부분이 조금은 덜 안 보이게 됩니다.
플러그인은 alexeyw/lot-map에 있습니다. 설치 전에 PRIVACY.md를 읽어 보세요. 이 분야 전체에 해당하는 조언인데, 여기서는 특히 실천하기 쉽습니다. 저자가 양보를 주장과 같은 문단에 넣어 두었으니까요.
관련 글
서버 한 대, AI 스트리머 한 명: 야간 라이브를 돌리는 코드
open-yoki는 매일 밤 Binance Square에서 방송하는 AI 진행자의 프로덕션 코드로, 성격과 목소리, 돈에 닿는 기능은 걷어냈습니다. headless Chrome이 프레임을 그리고 ffmpeg이 RTMP를 밀며, Markdown 폴더가 그녀의 기분과 올릴 글을 정합니다.
Pinky는 agent에게 당신의 폰을 맡기고, 당신이 허용을 누를 때까지 전송 버튼을 붙잡고 있습니다
Pinky는 어떤 MCP agent든 실제 iPhone이나 Android 폰에 연결하고, 승인을 프롬프트가 아닌 자체 게이트웨이에서 강제합니다. 은행 앱은 보이지 않고 비밀번호 입력란은 손댈 수 없으며, Android 13에서는 agent가 숨겨진 두 번째 화면을 받습니다.
인터페이스의 AI 티를 잡아내고 9단계로 고치는 Claude skill
unslop은 Claude Code, Codex, Antigravity에서 도는 skill로, vibecoded 화면이 어디서 싸구려처럼 보이는지를 먼저 이름 붙여 줍니다. 제품에서 방향을 잡고 나면 디자이너가 redline review를 하듯 패스를 겹쳐 고칩니다. star는 19,413개이고, slop이 무엇인지에 대한 답도 분명합니다.
세계의 법을 git에 넣은 사람들, 이제 법조문도 blame할 수 있다
global-law는 각국 법령을 git 저장소로 보관하고, 커밋 하나가 특정 날짜에 시행된 법 하나에 대응한다. 조문에 log, blame, show, diff를 돌릴 수 있고, 어느 날 각국에서 시행 중이던 법을 확인하고, 코퍼스 전체를 MCP로 어시스턴트에 넘길 수 있다.