Enable cc-plugin-you-should-know@builtin, fix 'not installed'
Enable You should know with /plugin enable cc-plugin-you-should-know@builtin on Claude Code 2.1.287+. Seeing 'is not installed in this project'? Here are the four causes.
On Claude Code ≥2.1.287, Claude Mods let plugins modify deeper behavior. The built-in mod You should know is a side agent that flags things you or Claude might miss on longer tasks, and it is off by default. Turn it on with /plugin enable cc-plugin-you-should-know@builtin (CHANGELOG: first-party sessions with telemetry on; docs: show disabled in /plugin if available for your org). Mods run with your permissions, so install only what you trust.
If the command answers is not installed in this project, the fix is in the section of that name below. This guide covers the enable path, not the Desktop --desktop guide (Desktop) and not the Claude Tag Channels guide (Channels).
TL;DR: Version floor 2.1.287+. Enable command:
/plugin enable cc-plugin-you-should-know@builtin. You should know is disabled by default. Checked 2026-10-02.
What Claude Mods are
CHANGELOG 2.1.287 (anthropics/claude-code):
Added Claude Mods: plugins may now modify deeper behavior
Official Mods overview (fetched 2026-10-02): a mod is a plugin that changes how Claude Code looks and behaves. It is made of JavaScript or TypeScript event handlers that run inside Claude Code, unlike settings hooks (shell/HTTP/prompt in a settings file), skills, or MCP servers.
Version floor: Claude Code v2.1.287 or later. Mods are on by default. Check with claude --version and update if older.
Trust: a mod runs with your permissions: it can read/write files, start processes, make network requests, see your session, and approve tool calls. Install only from authors and marketplaces you trust. See also permissions.
In a session, /plugin shows a dim line under the tabs with the active mod count (for example 1 mod active · first-mod). Early-access env CLAUDE_CODE_ENABLE_FUNCTION_HOOKS is ignored on 2.1.287+, and setting it to 0 does not keep mods off.
Enable You should know
CHANGELOG 2.1.287:
Added You should know, a built-in mod where a side agent watches your back and flags things you or Claude might miss. Turn it on with
/plugin enable cc-plugin-you-should-know@builtin(for first-party sessions with telemetry on)
Official mods overview built-in table (same-day):
Name in /plugin | Behavior | Default | How to enable / disable |
|---|---|---|---|
cc-plugin-you-should-know | Side agent watches longer tasks; shows a note above the prompt when it finds something worth knowing | Disabled by default | Enable: /plugin enable cc-plugin-you-should-know@builtin. Listed in the Installed tab under Built-in if available for your org. Disable again in /plugin. |
Exact enable string (the only one documented):
/plugin enable cc-plugin-you-should-know@builtin
-
Confirm Claude Code ≥2.1.287 (
claude --version). -
In a session, run the enable command above.
-
If you do not see it, open
/plugin→ Installed and look under Built-in (availability can depend on org). -
To turn it off later, disable it in
/plugin.
CHANGELOG gate: first-party sessions with telemetry on. The fix section below lists every documented reason the mod is missing; none has a workaround for org policy (checked 2026-10-22).
This is a built-in mod (@builtin), not the same as installing an Agent Skill from the marketplace (marketplace).
The Claude moves worth stealing, by email
Workflows tested on real jobs, sent only when they are worth it. Free.
Fix: Plugin is not installed in this project
If /plugin enable cc-plugin-you-should-know@builtin answers Plugin "cc-plugin-you-should-know@builtin" is not installed in this project, the mod is missing from your /plugin list. Anthropic's You should know docs (read 2026-10-22) say the list only includes it when Claude Code talks to the Claude API directly, with a claude.ai login or a Console API key, and the mod is available for your organization.
Work down this list:
- First session after an install or upgrade. The feature flags the mod depends on have not arrived yet. Quit Claude Code, start it again, and rerun the command.
- Telemetry is off. A session with
DISABLE_TELEMETRYset does not fetch those flags, so the mod never appears. Unset it for this shell, start a new session, and retry. - You connect through a gateway or a key helper. An LLM gateway, a Claude apps gateway, or an
apiKeyHelperkey hides the mod. There is no documented workaround: it needs a direct claude.ai or Console connection. - Your organization does not offer it. Open
/plugin, go to Installed, and look under Built-in. If it is not there after the three checks above, your admin side is the blocker, not your command.
The error does not mean the string is wrong: cc-plugin-you-should-know@builtin is the only documented name.
What it costs
Each check is a background request to the same model your session uses, and it counts toward your plan's usage limits or your API bill. The docs say the mod's own instructions, several thousand tokens, and the side agent's reply are billed in full on every check, while the conversation is read from the prompt cache.
On a plan where you already hit the 5-hour window, leave it off for long sessions. To watch the checks, set CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG=1 before you start Claude Code.
Not these guides
| Thing | Role | Where |
|---|---|---|
| Claude Mods + You should know enable | This guide | CHANGELOG 2.1.287 · mods overview |
claude --desktop / /desktop | CLI↔Desktop bridge | Desktop guide |
| Claude Tag Channels | Slack / Channels guide | Channels guide |
| Tool permission config | Permissions deep-dive | Permissions |
| Full mod authoring / UI gallery | Developer deep-dive | Official mods docs only, out of scope here |
This page doesn't cover writing your own mod, interface galleries, or org admin policy. Anthropic's mods docs are the place for those.
Pitfalls
- Expecting You should know on without enable: it is off by default.
- Running Claude Code <2.1.287: Mods / You should know need the version floor.
- Ignoring the CHANGELOG telemetry / first-party session gate. There is no other documented enable path.
- Treating a Marketplace Agent Skills install as the same as
@builtinmod enable. - Ignoring trust: mods can read files, use the network, and approve tools.
FAQ
What version do I need?
Claude Code v2.1.287 or later. Run claude --version. Mods require that floor and are on by default (Mods overview).
What is the exact enable command?
/plugin enable cc-plugin-you-should-know@builtin
Same string in CHANGELOG 2.1.287 and the official interactive-mode docs. No CLI flag for it is documented.
Why does it say "is not installed in this project"?
Because /plugin does not list the mod in that session. That happens on the first session after an upgrade, with DISABLE_TELEMETRY set, through a gateway or apiKeyHelper, or when your organization does not offer it. Restart once, then check those in order.
Is this the same as Claude Desktop or Channels?
No. Desktop bridge → how-do-i-use-claude-code-desktop. Channels / Claude Tag → how-do-i-use-claude-code-channels. This page covers enabling Mods and You should know only.
Are mods safe by default?
They run with your permissions. Official docs warn: install only what you trust. Review hooks/calls with claude plugin validate on third-party mods before install when you can.
How do I turn You should know off?
Run /plugin disable cc-plugin-you-should-know@builtin, or turn it off in the Installed tab of /plugin. Built-in mods cannot be uninstalled.
Close
Recap: ≥2.1.287 · /plugin enable cc-plugin-you-should-know@builtin · off by default · trust your installs. Related: Desktop · Channels · permissions · marketplace.
Sources (2026-10-02, error and cost sections 2026-10-22): You should know docs · CHANGELOG.md HEAD 2.1.287 · Mods overview · Plugins overview · Install plugins.
