← ブログに戻る
Ai読了目安 13 分

Claude Code のセッションを地図にする、作業が向かった先ほど擦り切れたスポーク

公開日 2026年11月15日
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 が Network になるのは -y 付きのときだけで、理由は、付けなければたいてい既にインストール済みのものを走らせているだけだから。

Windows では PowerShell ツールを PowerShell 自身の名前で同じように読む。Get-Content と Select-String は Files を点灯させ、Invoke-WebRequest は Network を点灯させる。

地図の読み方

ルートはメインループが最後に通った数駅を順につないだもので、最新の区間が自分で描かれていく。区間は 40 秒残り、20 秒かけて薄れる。だから作業が止まって一分たつと、スポークだけが残る。

スポークは使われるほど太く明るくなる。ここがこの仕組みの肝で、セッションの終わりに地図は作業がどこへ行ったかを示す。忙しそうに見えるのに Files のスポークが一本細く、Shell のスポークが太いセッションは、それだけで何かを語っている。

呼び出しが走っている間、駅のまわりに二本の針が伸びる。一本は一分で一周、もう一本は十分で一周。バックグラウンドに送られた作業、モニター、バックグラウンドのサブエージェント、ワークフローは、それを始めたターンが終わっても点いたままで、針も伸び続け、タスクが完了を報告するまで続く。失敗したタスクは赤い点を残す。

同時に始まった呼び出しは並んで飛び、駅に ×3 のようなカウントが付く。

Memory には専用の色がある。中身の詰まったパルスは Claude が求めた記憶。破線の上の中抜きのパルスは、フックが求められずに持ち込んだもの。駅の下の数字は前者を数え、↓ は後者を数える。メモリフォルダが何かしているのか気になったことがあるなら、これは直接の読み取りだ。

中心の環はセッションが進むにつれて埋まり、名前の上にパーセントが出る。70 パーセントで琥珀色、90 で赤。モデルを変えると中心と Model の駅が数秒鳴り、フィードに opus 5.5 → fable 5.2 のような行が加わる。同じフォルダの前回のセッションと違うモデルで始まったときにも同じことが起きる。自分がずれていくのに気づくための、さりげない仕掛けだ。

プライバシーの線と、それが認めていること

README の一文はそのまま引く価値がある。あなたのマシンで動き、どこにも何も送らない。そして、ローカルであることは盲目であることを意味しない。

続く段落が理由を説明する。ツール呼び出しを追う mod はどれもそうだが、呼び出しはまるごと渡され、そこから名前だけを取り、他には何もしない。何を読み何を保持するかは 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 を読むこと。この分野全体に言える助言だが、ここでは特に実行しやすい。著者が譲歩を主張と同じ段落に置いているからだ。

関連記事

Pinky は agent に自分のスマホを操作させる。送信ボタンは、あなたが許可を押すまで押さえたまま

Pinky はどんな MCP agent でも本物の iPhone や Android につなぎ、承認をプロンプトではなく自前のゲートウェイで強制する。銀行アプリは見えず、パスワード欄は通行止め、Android 13 では agent に隠れた2枚目の画面が渡される。

サーバー1台、AI配信者1人:夜のライブ配信を動かすコードの中身

open-yoki は、毎晩 Binance Square で配信する AI ホストの本番コードで、人格・声・お金に関わる機能は取り除かれています。headless Chrome がフレームを描き、ffmpeg が RTMP を押し、Markdown フォルダが彼女の気分と投稿内容を決めます。

SoduWork の依頼は、チャットが止まったときではなく、依頼した人が承認したときに終わる

SoduWork はセルフホストのワークベンチだ。依頼には着手前に受け入れ基準が書かれ、納品は別の harness がレビューし、最後は人が承認する。うまくいった進め方はプラグインとして保存され、チームの他の人がそのまま実行できる。

世界の法律を git に入れた人がいる。だから法令も blame できる

global-law は各国の法令を git リポジトリとして持ち、1 つの commit が既知の日に効力を持った 1 つの法律にあたる。条文に対して log、blame、show、diff を実行でき、ある日の各国の施行状況を調べ、コーパス全体を MCP 経由でアシスタントに渡せる。