From 6e82fbac206fb5865beff98663717637b6f61296 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 13 Aug 2026 12:43:04 +0000 Subject: [PATCH] docs(mcp): why the primer hook lives in the repo, not only in the plugin MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit #3212 recorded that web session containers don't load marketplace plugins, but mcp_server/README.md never said it — so the section reads as if the repo hook and the codekeeper-plugin hook are two ways to do the same thing, and a future reader has no reason not to delete one. Names the cause: the container starts with SKIP_PLUGIN_MARKETPLACE=true, so no plugin directory and no CLAUDE_PLUGIN_ROOT exist and the plugin's hook cannot run or report. Skills sync into those containers; plugins do not. Links to codekeeper-plugin#3 for the evidence rather than repeating it here. Docs only. No code, no behaviour change. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01UsK3m6urmrmCJTxe46x5rP --- mcp_server/README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/mcp_server/README.md b/mcp_server/README.md index e612d67de..91d1510fb 100644 --- a/mcp_server/README.md +++ b/mcp_server/README.md @@ -120,6 +120,14 @@ curl -sS -H "Authorization: Bearer $CODEKEEPER_PAT" \ ### משיכה אוטומטית בפתיחת סשן +**למה ההוק יושב בריפו ולא רק בפלאגין.** אותה התנהגות ארוזה גם כפלאגין +([`amirbiron/codekeeper-plugin`](https://github.com/amirbiron/codekeeper-plugin)), אבל +קונטיינר של סשן Claude Code בדפדפן עולה עם `SKIP_PLUGIN_MARKETPLACE=true` ואינו טוען +פלאגינים מהמרקטפלייס כלל: אין תיקיית `plugins`, אין `CLAUDE_PLUGIN_ROOT`, וההוק של +הפלאגין לא רץ — ומכיוון שלא רץ, גם אינו יכול לדווח על כך. סקילים ברמת חשבון כן +מסונכרנים לסביבות האלה; פלאגינים לא. העותק שבריפו הוא מה שגורם לפריימר להיטען שם. +הראיות ובדיקות ההבחנה מרוכזות ב‑[codekeeper-plugin#3](https://github.com/amirbiron/codekeeper-plugin/pull/3). + `.claude/settings.json` בשורש הריפו מגדיר `SessionStart` hook מסוג `command` שמריץ את `.claude/hooks/codekeeper-primer.sh` בכל פתיחת סשן של Claude Code על הריפו הזה. הסקריפט מבצע את ה‑`curl` בעצמו, קורא את קוד הסטטוס ומגיב לפי המשמעות.