Go Install This Right Now: The Quiet Second Claude That Reads Over Your Shoulder

Go Install This Right Now: The Quiet Second Claude That Reads Over Your Shoulder
you-should-know.md

Go Install This Right Now: The Quiet Second Claude That Reads Over Your Shoulder

One built-in switch in Claude Code. Off by default. Here’s what it does that the docs don’t tell you.

I’ve watched Claude make a perfectly reasonable decision, mention it once in the middle of a long answer, and keep going. I didn’t read that sentence. Neither do you.

That’s not a character flaw — that’s what delegating means. But somewhere in step 14 of a long task is the call you would have argued with, and it’s sitting in the scrollback between a test run and a file diff.

There’s a switch in Claude Code that catches those, and it’s off by default. Turn it on. It takes one command:

/plugin enable cc-plugin-you-should-know@builtin

The short version — if this box is all you read

  • It’s a second, quiet Claude that rereads your session during long tasks and posts one short line above your prompt when something with real consequences got buried.
  • Most of the time it says nothing — by design.
  • It has no tools and never interrupts the main agent. It can’t touch your files; it can only talk to you.
  • A real one from my sessions: a few tests had been quietly pointed at an old version of a page to get a deploy through. They passed — and no longer tested the page anyone uses.
  • It’s built in: nothing to update or maintain. Off is the same command with disable.
  • The catch: it needs telemetry on, and it isn’t offered on Bedrock, Vertex, or under zero-retention/HIPAA terms.

$ tail -f session.log

What you actually see

● Ran 42 tests ✓ all passed
● Updated 3 files · wrote summary…
Heads up · The fix for the live problem is only on your desktop; the copy everyone else uses still has the old version.
1Learn more2Knew this already0Dismiss
>
A re-creation, not a screenshot — the note sits between the session and your prompt box.

One line, about twenty words, tagged one of two ways:

Heads upAbout this session’s work — a decision Claude made on its own, a step it didn’t highlight, a result that might be off.
You should knowAbout how something works — a system, a concept, a design that matters for what you’re doing.

Learn more opens a hundred-word explainer. From there, Chat in main session drafts a prompt about it into your prompt box, so you can hand it straight to the main Claude.

Nearly nine out of ten notes I took into the session were Heads up. The value isn’t teaching. It’s consequences I’d have missed mid-task.


$ man you-should-know

What the docs don’t tell you

Anthropic documents the switch, not the behavior. I read how the shipped plugin works; here it is in plain words. (Current as I write this — it ships inside Claude Code, so any release can change it.)

When it looks

On every sixth step Claude takes inside one turn — a step being one tool call or one reply. Six steps into a long task, then twelve, then eighteen. Each look is a single, separate model call that rereads the conversation you already have, then speaks once or stays quiet. A quick back-and-forth never reaches six, so it never fires.

What it’s told

Mostly when to shut up. Default to saying nothing. Skip trivia, skip anything you already discussed or clearly understand, skip anything it isn’t confident about. The bar is a real consequence: money, time, wasted work, a wrong result, or a decision you’re in the middle of.

My favorite line in its instructions: “interesting is not the same as important.”

It learns, a little

It won’t repeat a recent note, or a topic you closed with Knew this already. That button is how you stop a topic coming back.

It backs off if you ignore it

Ignore a few notes in a row and it starts skipping checks. Answer any note and it resets.

The exact numbers

It remembers roughly the last fifty notes it showed you. A note you type past clears after a couple of prompts. After three ignored in a row it skips one check, then two, then four, up to sixteen.

Why “default to silence” is the whole design. A reviewer that talks every time is a reviewer you stop reading. Ask anyone who’s tuned a security alert: the tool that pages on everything gets muted, and then it misses the one page that mattered. This plugin is built the other way — a very high bar, a built-in backoff, a memory of what you already know.

It’s only as good as its ability to stay quiet.


$ grep -ri “heads up” ~/sessions/

Does it actually catch anything?

Yes. These are real notes from my own sessions, generalized so they don’t point at any one project. Every one was about something Claude had already done or said in the scrollback — I just hadn’t taken it in.

The tests that stopped testing. To get a deploy through, a few tests had been pointed at an old version of a page. They passed. They no longer checked the page anyone actually uses.

The fix that only lived in one place. The fix for a live problem was on my desktop and nowhere else. The copy everyone else uses was still broken.

The article I didn’t approve. After I’d signed off on a draft, more review rounds rewrote its opening, its subtitle and several of its stories. The version about to ship wasn’t the one I approved.

“Tested” meant “tested on my machine.” A new button had only been tried in my own browser — never in the page readers would actually load.

One more catch

The docs nobody will find. A new how-to got saved somewhere my own tooling doesn’t index, so future sessions looking for it would come up empty.

Most of these are about things being out of sync — a fix in one place but not another, a stale copy, a step done in the wrong order. That’s what slips in long, late sessions spread across several machines.

That’s exactly how I work, which is why it earns its keep for me. It’s worth less if you read every line Claude writes, or your tasks are short.

The receipts

About 80 notes shown in under two weeks. I took 20 of them into the main session — roughly 1 in 4. My tracking misses notes taken while Claude is mid-turn, so the real number is a little higher.


$ cat FINE_PRINT

The honest part

I’d tell every Claude Code user to turn this on. I’d also tell them what they’re turning on.

  • It needs telemetry. If you’ve set DISABLE_TELEMETRY or CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, it won’t show up. Claude Code’s telemetry goes to Anthropic and a third-party logging service, per Anthropic’s own data-usage docs.
  • Its telemetry doesn’t carry the note text.
  • It isn’t offered everywhere.
  • --safe-mode doesn’t stop it. Neither does --bare or turning off all hooks — those affect plugins you installed, not built-in ones. The /plugin switch is the only off switch.
  • You can’t tune it. How often it looks, how high its bar is, and which model it uses are all fixed. Your levers are on/off, Knew this already, and ignoring it.
  • It’s per machine. The switch lives in your local settings — turn it on everywhere you work.
What its telemetry sends, and where it isn’t offered

Telemetry, from the code: which button you pressed, timings, token counts, the version, and a one-word category. Not the note itself. The check is a normal model call to Anthropic on your plan; the plugin can’t make network calls of its own.

Not offered: on Bedrock, Vertex or Foundry; for organizations with zero-data-retention or HIPAA terms; in Claude Desktop’s agent mode. It’s also still rolling out, so some people won’t see it yet.


$ /plugin enable cc-plugin-you-should-know@builtin

Go turn it on

/plugin enable cc-plugin-you-should-know@builtin

Do a real day of work with it — something long — and judge it by one test: when it spoke, was it worth reading? Old news? Press Knew this already. Noise? Ignore it and it backs off.

And if it ever catches the thing you’d have shipped broken, you’ll stop asking whether it was worth one command.


$ cat cost.csv

What it costs

Coming in a follow-up. Every check is one extra model call on the same model you’re working with, rereading the conversation. And it runs outside the session transcript, so tools that estimate your spend from transcripts can’t see it.

So I’m measuring it directly: what it costs per check, per note, and per note that was actually worth reading. When there’s enough data, the numbers and a verdict go here.

Similar Posts

Leave a Reply