Wise

Explain it once. Wise remembers.

A memory for plain-English explanations of your code, kept outside your repo. When the code changes, you get the diff, not a re-explanation.

claude mcp add wise -- node /path/to/wise/dist/index.js

One MCP server. Nothing is written to your repo. Source on GitHub

127.0.0.1:4319

processOrder stale

~/Documents/identicon › src/orders.ts anchored

What changed since you last read this

Sums the order, then applies ~~a hardcoded 20% tax~~the VAT rate from RATES.

Computes a receipt for an order. Drops any line with a zero quantity, sums what's left into a subtotal, and applies tax on top.

The rate comes from RATES.vat, so a change in tax policy is a config change, not a code change.

What changed in the code

1export function processOrder(order) {1export function processOrder(order) {

2 const items = order.items.filter(nonEmpty);2 const items = order.items.filter(nonEmpty);

⋯ 25 unchanged lines⋯ 25 unchanged lines

28 const sub = sum(items);28 const sub = sum(items);

29 const tax = sub * 0.2; 29 const tax = sub * 0.2; const tax = sub * RATES.vat;

30 return { sub, tax, total: sub + tax };30 return { sub, tax, total: sub + tax };

31}31}

01
Explain it once

Ask your agent to explain a function and remember it. The prose goes to a SQLite store in your home directory. Nothing lands in your repo, and nothing shows up in git status.
02
Ask again whenever

If the code hasn't changed, you get your own explanation back, word for word. No re-reading the function, no waiting for it to be derived a second time.
03
Changed code gives a diff

If it has changed, you get the code as it was, the code as it is, and what you wrote last time, so the explanation gets refreshed rather than rebuilt from nothing.

Install & use

Node 20 or newer, and pnpm. Works with any MCP-compatible client.

# build it
git clone https://github.com/kaleabSolomon/wise
cd wise && pnpm install && pnpm build

# register it, from inside any project
claude mcp add wise -- node /path/to/wise/dist/index.js

# then just ask
Explain resolvePrice and remember it with wise.

# or set it once in AGENTS.md / CLAUDE.md and stop asking
After explaining a symbol, save the explanation with wise.

# build it
git clone https://github.com/kaleabSolomon/wise
cd wise && pnpm install && pnpm build

# add to your client's MCP config. Claude Desktop, Cursor,
# Windsurf, Cline and most MCP-compatible editors take this shape
{
  "mcpServers": {
    "wise": {
      "command": "node",
      "args": ["/path/to/wise/dist/index.js"]
    }
  }
}

# then set it once in AGENTS.md / CLAUDE.md and stop asking
After explaining a symbol, save the explanation with wise.

The viewer runs alongside the server. Read your explanations at 127.0.0.1:4319.

Ask it to install the post-commit hook once, and explanations get flagged stale as you commit, without a reminder to run anything.

An editor extension that shows explanations on hover is in progress.

Explain it once. Wise remembers.

processOrder stale

What changed since you last read this

What changed in the code

Explain it once

Ask again whenever

Changed code gives a diff

Install & use