---
title: "working-memory"
url: "https://claudemods.dev/en/builds/working-memory-2f0b91"
source: "https://github.com/Hangghost/learning-hacker-claude-mod/tree/main/plugins/working-memory"
source_type: "github"
repo: "https://github.com/Hangghost/learning-hacker-claude-mod/tree/main/plugins/working-memory"
author: "Chen Hung-Lun"
author_handle: "klkh.dj.ai"
stars: 14
category: "Memory & context"
categories: ["memory"]
tags: ["brain", "claude-code", "context-window", "mod", "visualization", "working-memory"]
permission_level: 2
scan_complete: false
install: "claude plugin marketplace add Hangghost/learning-hacker-claude-mod\nclaude plugin install working-memory@learning-hacker-claude-mod"
added: "2026-10-04T10:40:57.261Z"
updated: "2026-10-17T19:15:36Z"
locale: "en"
content_locale: "en"
---

# working-memory

Renders the context window as a brain: tool calls light up the corresponding regions, higher usage makes it more crowded, and compaction triggers sleep-like cleanup.

## Description

working-memory is one of the Claude Code mods in the learning-hacker-claude-mod collection (v0.1.0). `/brain` draws a side view of a brain in a side pane: the frontal lobe corresponds to planning (prompt, TaskCreate/TodoWrite, Skill), the motor cortex to Edit/Write, the parietal lobe to tools such as Bash, the occipital lobe to Read/Grep/Glob, the temporal lobe to WebFetch/WebSearch/MCP tools, and the cerebellum to Agent/SendMessage. As context usage rises, more cells fill with `░`; above 85%, it flashes red. During compaction, a `✦` light wave sweeps from the back of the brain to the forehead to represent sleep-like cleanup. Installation requires Claude Code v2.1.287 or later, through the marketplace `Hangghost/learning-hacker-claude-mod`. However, the GitHub scan failed (the ../types import could not be resolved), and the hook file includes tool.call tool-interception capabilities (level 2); a manual review is needed before deciding whether to proceed.

## Install

```
claude plugin marketplace add Hangghost/learning-hacker-claude-mod
claude plugin install working-memory@learning-hacker-claude-mod
```

## Original README

# learning-hacker-claude-mod

Learning Hacker 的 [Claude Code mods](https://code.claude.com/docs/en/plugins/mods/overview) 合集。主題有兩個：把 agent 的運作畫成看得懂的東西，以及讓「同時開好幾個 Claude Code session 分工」這件事變順。

> 狀態：照現狀提供（as-is），作為示範與實用工具分享，不提供支援。

## 收錄的 mod

| mod | 做什麼 | 版本 |
|---|---|---|
| [`dispatch-board`](plugins/dispatch-board) | 多個 session 分工時的派工看板：讀你寫的 mission 檔，顯示誰完成、誰在跑、誰在等你，狀態轉換時跳 toast | 0.1.0 |
| [`handoff-runner`](plugins/handoff-runner) | bg session 在 worktree 做完的分支，由你在面板按一顆按鈕快轉進 main，執行前檢查、執行後驗證 | 0.1.0 |
| [`working-memory`](plugins/working-memory) | 把 context window 畫成一顆腦：工具呼叫點亮對應腦區，用量越滿越擁擠，compact 時睡眠整理 | 0.1.0 |

每個 mod 都可以單獨安裝，不用全裝。

## 安裝

需要 Claude Code **v2.1.287 以上**（`claude --version` 確認）。

先加入 marketplace（一次就好）：

```
/plugin marketplace add Hangghost/learning-hacker-claude-mod
```

再挑想要的裝：

```
/plugin install dispatch-board@learning-hacker-claude-mod
/plugin install handoff-runner@learning-hacker-claude-mod
/plugin install working-memory@learning-hacker-claude-mod
```

在 shell 裡用 `claude plugin marketplace add …`、`claude plugin install …` 也可以。已開著的 session 執行 `/reload-plugins` 載入。

**更新**：第三方 marketplace 的自動更新預設關閉。可在 `/plugin` 的 Marketplaces 分頁對本 marketplace 選 Enable auto-update，或手動執行 `/plugin marketplace update learning-hacker-claude-mod`。

## dispatch-board：多 session 派工看板

同時開幾個 session 各做一段工作時，你很難一眼看出誰做完了、誰卡住在等你。dispatch-board 讀你寫的 mission 檔，在提示框上方放一行摘要，`/dispatch` 打開完整面板。

- mission 檔是一個 JSON：列出節點、負責的 session 名稱、完成條件（一條 shell 指令，結束碼 0 代表完成）
- 面板分成「需要你／跑著／做完待收斂」，完成條件跑不起來時顯示「無法判定」，不會被當成還在跑
- session 狀態取自 `claude agents --json`
- `/dispatch demo` 用假資料試看畫面

**安全邊界**：完成條件是 shell 指令，mod 會執行它，所以 mission 檔**只從使用者層級的目錄讀**（預設 `~/.claude/missions/`），不讀任何專案目錄或 repo 內的檔案，也不接受專案設定改掉這個目錄。clone 一個陌生 repo 不會讓 mod 執行對方寫的指令。

mission 檔格式與範例見 [plugins/dispatch-board/README.md](plugins/dispatch-board/README.md)。

## handoff-runner：一鍵把 worktree 分支落地

背景 session 在自己的 worktree 做完一條分支後，要併進 main，但 main 正被你的主 checkout 持有，背景 session 動不了它。handoff-runner 讓 session 簽發一張「交接單」，你在 `/handoff` 面板看過步驟後按「執行」，由 mod 完成 fast-forward。

- Claude 可以呼叫工具 `handoff_issue` 簽發交接單，也可以用 `/handoff issue <branch> [target]` 手動簽發
- 交接單放在 `<git common dir>/handoffs/`，在 `.git` 裡面，不會被 commit
- 執行前檢查：分支沒有前進、目標可以 fast-forward、持有目標分支的 worktree 在落地路徑上沒有未提交的修改
- 執行後驗證：目標分支確實前進到該 commit
- 預設**不** push，可在設定開啟

**安全邊界**：交接單**只帶參數**（分支、目標、釘住的 commit），不帶任何指令。要執行的 git 步驟由 mod 依參數產生，執行前比對「畫面上顯示的步驟」與「實際要跑的步驟」完全一致，並只允許 fast-forward、帶預期舊值的 ref 更新、非強制的 push。偽造的交接單最多只能讓自己從面板消失，不能讓 mod 執行別的指令。

細節見 [plugins/handoff-runner/README.md](plugins/handoff-runner/README.md)。

## working-memory：把 context 畫成一顆腦

`/brain` 在側邊開一個 pane，畫出一顆側面的腦（左邊是前額）。

| 腦區 | 比喻 | 什麼時候亮 |
|---|---|---|
| 額葉 | 規劃 | 送出 prompt、TaskCreate／TodoWrite、Skill |
| 運動皮質 | 動手改 | Edit、Write |
| 頂葉 | 操作環境 | Bash 與其他工具 |
| 枕葉 | 閱讀 | Read、Grep、Glob |
| 顳葉 | 聽外界 | WebFetch、WebSearch、MCP 工具 |
| 小腦 | 分身協作 | Agent、SendMessage |

- context 用量越高，腦裡被 `░` 填滿的格子越多；超過 85% 會紅色閃爍
- compact 時，一道 `✦` 光波從後腦掃到前額，代表「睡眠整理記憶」

腦區對應是比喻，不是神經科學主張。

## 安裝前看看它會做什麼

mod 不在沙盒裡執行，會以你的權限跑在 Claude Code 內。建議安裝前先讀原始碼，或 clone 後執行 `claude plugin validate ./plugins/<名稱>`，看它處理哪些事件、呼叫哪些能力。以下是 v0.1.0 的結果：

**dispatch-board**

```
hooks: session.start, command.run{command=dispatch}, ui.close, ui.render{component=AbovePrompt},
       ui.render{component=Pane, requestId=dispatch-board}
calls: $.clock.every, $.clock.now, $.command.register, $.env.get, $.fs.exists, $.fs.list, $.fs.read,
       $.fs.stat, $.process.run, $.session.cwd, $.session.root, $.settings.read, $.state.get,
       $.state.set, $.ui.close, $.ui.copy, $.ui.open, $.ui.resolve, $.ui.toast
```

`$.process.run` 只用來跑你 mission 檔裡的完成條件（`/bin/sh -c`，每條 5 秒逾時）和 `claude agents --json`；檔案只讀不寫；不連網、不呼叫模型、不送 prompt。

**handoff-runner**

```
hooks: session.start, tool.call{tool=mcp__handoff-runner__handoff_issue}, command.run{command=handoff},
       ui.close, ui.render{component=AbovePrompt}, ui.render{component=Pane, requestId=handoff-runner}
calls: $.clock.every, $.command.register, $.fs.list, $.fs.read, $.fs.write, $.process.run,
       $.session.cwd, $.state.get, $.state.set, $.tool.register, $.ui.close, $.ui.open,
       $.ui.resolve, $.ui.toast
```

檔案只讀寫 `<git common dir>/handoffs/` 底下；`$.process.run` 只跑唯讀的 git 檢查、交接單的鎖，以及你按下「執行」後的落地步驟；只有開啟 push 時才連網；不呼叫模型、不送 prompt。

**working-memory**

```
hooks: session.start, command.run{command=brain}, prompt.submit, tool.call,
       session.measure, session.compact, ui.render{component=Pane, requestId=working-memory}
calls: $.clock.every, $.command.register, $.session.usage, $.state.get, $.state.set,
       $.ui.open, $.ui.resolve
```

只讀工具呼叫的名稱與參數摘要來畫圖，不讀寫檔案、不啟動程式、不連網、不呼叫模型。

## 開發

```bash
claude --plugin-dir ./plugins/<名稱>   # 單次載入
claude plugin test ./plugins/<名稱>     # 跑測試
```

handoff-runner 另有兩支需要 Node 23.6 以上的測試：`node plugins/handoff-runner/tests/real-git.mjs`（在暫存 repo 上用真的 git 落地）與 `node plugins/handoff-runner/tests/boundary.mjs`（檢查執行入口只有一個）。

各 plugin 的 `tsconfig.json` 依賴 `.claude-plugin/types/`，那是 Claude Code 產生的型別檔，不放進 repo。

## English

A collection of Claude Code mods by Learning Hacker. Shared as-is, without support. Each mod installs on its own.

```
/plugin marketplace add Hangghost/learning-hacker-claude-mod
/plugin install dispatch-board@learning-hacker-claude-mod
/plugin install handoff-runner@learning-hacker-claude-mod
/plugin install working-memory@learning-hacker-claude-mod
```

Requires Claude Code v2.1.287+.

- **dispatch-board**: a board for running several Claude Code sessions in parallel. Reads mission files you write (nodes, the session responsible, a shell command that exits 0 when done) and shows who is done, who is running and who is waiting on you. Mission files are read only from a user-level directory (default `~/.claude/missions/`), never from a project, so cloning a repo cannot make it run someone else's commands.
- **handoff-runner**: lets a background session that finished a branch in its own worktree issue a handoff ticket, which you land into `main` with one button. Tickets carry only parameters (branch, target, pinned commit); the git steps are derived by the mod, checked before running and verified after. Push is off by default.
- **working-memory**: draws your context window as a brain. Tool calls light up regions, the brain fills up as context grows, and compaction plays a "sleep" sweep.

## License

MIT


Showcase: 【實用工具】Claude Mod 真的是太好用了！
因為 Claude Mod 可以解決「派工 skill」的一個大痛點！

之前的「派工 skill」可以在一個「主對話」規劃任務後，
派出多個「子對話」去工作，最後再回報結果整合回「主對話」。

但是會遇到需要頻繁到主畫面查看「子對話」進度
甚至有指令被 guard 擋住，或是有問題要回答時
還要切進「子對話」處理。
❗這樣的操作其實認知負荷很重，常常切進去要回想才能繼續回答

所以我用 Claude Mod 做了一個「派工儀表板」dispatch mod
❇️ 可以在主對話看到所有子對話的運行狀況 ❇️
所以可以不用切來切去就可以知道所有狀況了～
而且是「依照派工任務分類」的（Claude Code 目前無法自動分類）！！！

另外一件事就是常常有一些收尾動作容易被 guard 擋下
比如說 git push, git merge 等操作，也要切進子任務下指令。
所以我也做了一個 handoff mod
❇️ 可以直接在主對話審核通過後，直接背景執行相關指令 ❇️

現在可以專心在「主對話」討論策略和規劃之後的實作計劃了～
Dispatch / Handoff mods; repo in author reply
