/plugin enable cc-plugin-you-should-know@builtin: What Claude Code's You Should Know Mod Does#
Published by Alex Sorokoletov
/plugin enable cc-plugin-you-should-know@builtin turns on You should know, a built-in mod in Claude Code v2.1.287 and later. A side agent re-reads long turns and shows one note above the prompt when Claude made a tradeoff it did not call out or a result may be off. It is off by default, costs tokens per check, and only appears in first-party sessions that fetch feature flags.[1][2]
What it does#
Every check is a separate request to the session's own model. It carries the whole conversation plus the mod's instructions, and it has no tools: it cannot read files, run commands, or change what Claude does. Checks are not written to the session transcript.[2]
The side agent answers with nothing in most checks. When it finds something, the note looks like this:
✦ Heads up · There was a change to how folder sharing starts in June, which may have bumped usage metrics artificially.
1: Learn more 2: Knew this already 0: Dismiss
The tag is Heads up for something about the work in this session (a decision Claude made, a result that may be wrong) and You should know for how a system or concept works. Type the digit alone into an empty prompt to answer. Learn more writes a short explanation, and its Chat in main session option quotes the note into your prompt. Claude never sees a note unless you choose that option.
When it checks#
| Condition | Effect (v2.1.330) |
|---|---|
| Main agent step 6, 12, 18… of a turn | A check runs |
| Turn with fewer than 6 steps | No check |
| Subagent steps | Never trigger a check |
| A note is on screen, or one was already offered this turn | No check |
| A check is already running | No second check |
| You type past notes without answering | After 2 ignored notes, the mod skips the next 1, 2, 4… checks, up to 16. Answering any note resets it |
| Same line as one of the last 50 notes or known topics | Dropped |
The cadence and these limits are the same in v2.1.287 and v2.1.330.
How to turn it on and off#
Turn it on at the Claude Code prompt:
/plugin enable cc-plugin-you-should-know@builtin
Turn it off with /plugin disable cc-plugin-you-should-know@builtin, from the Installed tab of /plugin (under Built-in), or with Turn off suggestions on the Dismissed. line after a note. From a shell, claude plugin enable and claude plugin disable take the same id. /plugin install does not work for it: built-in mods cannot be installed or uninstalled, only enabled.
The state is saved in your user settings:
// ~/.claude/settings.json
{
"enabledPlugins": {
"cc-plugin-you-should-know@builtin": true
}
}
Recent notes and the topics you marked as known are kept in a file that starts with cc-plugin-you-should-know under ~/.claude/plugins/store/. Delete it while no session runs to reset what the mod remembers.[2]
Why it says "isn't installed in this project"#
When the mod is not available, /plugin does not list it and the enable command answers Plugin "cc-plugin-you-should-know@builtin" isn't installed in this project. The debug log says not found in any marketplace, skipping and gives no reason. The mod is available only when every row below holds:[2][3]
| Requirement | Blocks it |
|---|---|
| Claude Code v2.1.287 or later | Older versions |
| Direct connection to the Claude API with a claude.ai account or Console API key | Bedrock, Vertex, Foundry, an LLM gateway, a Claude apps gateway, an apiKeyHelper key, CLAUDE_CODE_CUSTOM_OAUTH_URL |
| Feature flags fetched | DISABLE_TELEMETRY, DO_NOT_TRACK, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, CLAUDE_CODE_DISABLE_FEATURE_FLAGS, DISABLE_GROWTHBOOK |
| Flags already arrived | The first session after an install or upgrade |
| Account not under HIPAA or zero data retention | Those organizations |
| The mod turned on for your account | Server-side rollout; it can appear later on the same version |
| Terminal session | Claude Desktop's Code tab (issue #102573, open) |
An ANTHROPIC_BASE_URL that points at a local proxy also kept it from loading for one user (issue #99071). If any variable in the table is set in your shell or in the env block of settings.json, remove it and start a new session.
What it costs#
Each check bills to your plan's usage limits or your API account. The conversation part is read from the prompt cache, but the instructions (several thousand tokens) and the reply are billed in full on every check, and Learn more adds another request.[2] /usage and the status line do not break out the mod's share (issue #107829). A long agentic turn of 60 steps can run up to 10 checks.
Settings and privacy#
- Notes follow the
languagesetting since v2.1.290; before that they were always in English.[1] CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG=1shows the last 3 checks above the prompt, with step, outcome and time.[3]- Checks go to the same API as your session, with no third party. Telemetry records the outcome and token counts of each check, not the note text. The side agent is told never to repeat secrets, credentials or personal data from the conversation.
Timeline#
| Version | Published (npm) | Change |
|---|---|---|
| v2.1.287 | 2026-10-01 | You should know added, off by default, for first-party sessions with telemetry on[1] |
| v2.1.288 | 2026-10-02 | Notes say "we", "the main agent" or "you" depending on who made a decision[1] |
| v2.1.290 | 2026-10-05 | Notes follow the language setting[1] |
| v2.1.318 | 2026-11-03 | Toasts say "try again" instead of "press 2", which only worked in the terminal[1] |
Should you turn it on?#
Turn it on if you run long agentic turns (6 steps or more) and review the result later: the notes catch tradeoffs Claude made without saying so. Leave it off if you work in short turns (it never runs), if you watch your usage limits closely, or if you use Bedrock, Vertex, a gateway or the Desktop Code tab (it will not load).
FAQ#
Q: Why does /plugin enable cc-plugin-you-should-know@builtin say the plugin isn't installed?
A: The mod is hidden when the session does not fetch feature flags or does not use the first-party API: DISABLE_TELEMETRY, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, Bedrock, Vertex, Foundry, a gateway or an apiKeyHelper key all block it. It also needs v2.1.287 or later and may not be rolled out to your account yet.
Q: Does You should know cost tokens?
A: Yes. Each check is a request on your session's model. The conversation comes from the prompt cache, but several thousand tokens of instructions and the reply are billed on every check, and Learn more adds another request.
Q: How often does it check?
A: On steps 6, 12, 18 and so on of a main-agent turn. Shorter turns never trigger a check, and ignored notes make it skip more checks.
Q: How do I turn it off?
A: Run /plugin disable cc-plugin-you-should-know@builtin, use the Installed tab of /plugin, or pick Turn off suggestions after dismissing a note.
Q: Does Claude see the notes?
A: No. The main agent sees a note only if you choose Chat in main session, which quotes the note into your prompt.
Q: Does it work in Claude Desktop?
A: Not in the Desktop Code tab as of v2.1.330 (issue #102573). Use it in the terminal.
Sources: [1] Claude Code changelog, v2.1.287, v2.1.288, v2.1.290, v2.1.318 | [2] Claude Code docs: You should know suggestions | [3] Claude Code docs: environment variables | Issue #99071 | Issue #102573 | Issue #107829
Related: Claude Code v2.1.287 analysis | CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC in the env-var glossary | DISABLE_TELEMETRY hides models from /model | Claude Code env-var glossary