@tiens.nguyen/gu-cli 1.0.784 → 1.0.785

package/gu_skills.py

@@ -21,8 +21,11 @@ def clean_list(skills) -> list[dict]:
     out = []
     for s in skills or []:
         if isinstance(s, dict) and s.get("name") and s.get("path"):
-            out.append({"name": str(s["name"]), "description": str(s.get("description") or ""),
-                        "path": str(s["path"]), "dir": str(s.get("dir") or os.path.dirname(str(s["path"])))})
+            item = {"name": str(s["name"]), "description": str(s.get("description") or ""),
+                    "path": str(s["path"]), "dir": str(s.get("dir") or os.path.dirname(str(s["path"])))}
+            if s.get("source") == "claude":
+                item["source"] = "claude"  # written for Claude Code — see CLAUDE_NOTE
+            out.append(item)
     return out
 
 
@@ -53,10 +56,67 @@ def find(skills: list[dict], name: str) -> dict | None:
     return next((s for s in skills if s["name"] == n), None)
 
 
-def render(skill: dict, body: str) -> str:
+# A SKILL WRITTEN FOR CLAUDE CODE (task #325) names Claude Code's tools. The instructions are still
+# the instructions; only the tool names differ, and the model is told which of its own to use.
+CLAUDE_NOTE = (
+    "This skill was written for Claude Code, so it names Claude Code's tools. Use yours instead: "
+    "Bash → run_command · Read → read_file_lines / read_text_file · Edit → edit_file / edit_lines · "
+    "Write → create_file · Grep → grep_repo · Glob / LS → list_dir. Tools named mcp__<server>__<tool> "
+    "are the same here. Anything else it names that you do not have (Task, TodoWrite, WebFetch, "
+    "a subagent…): do that part yourself with the tools you do have, or say that you cannot. "
+    "A line written as !`command` was meant to be run before you read this — it was NOT run; "
+    "run it yourself only if the task needs its output."
+)
+
+_ARG_INDEX_RE = re.compile(r"\$ARGUMENTS\[(\d+)\]|\$(\d+)\b")
+
+
+def split_args(request: str) -> list[str]:
+    """`"hello world" second` → ["hello world", "second"] — Claude Code's quoting."""
+    out, cur, quote, any_ = [], "", "", False
+    for ch in request or "":
+        if quote:
+            if ch == quote:
+                quote = ""
+            else:
+                cur += ch
+        elif ch in "\"'":
+            quote, any_ = ch, True
+        elif ch.isspace():
+            if cur or any_:
+                out.append(cur)
+            cur, any_ = "", False
+        else:
+            cur += ch
+    if cur or any_:
+        out.append(cur)
+    return out
+
+
+def substitute(skill: dict, body: str, request: str | None) -> str:
+    """Claude Code's placeholders in a skill body: $ARGUMENTS, $ARGUMENTS[N] / $N, and the skill's
+    own folder. `request` is None when the agent picked the skill itself — there are no arguments
+    then, and the placeholders are left as written rather than emptied."""
+    out = body.replace("${CLAUDE_SKILL_DIR}", skill.get("dir", ""))
+    if request is None:
+        return out
+    args = split_args(request)
+
+    def one(m):
+        i = int(m.group(1) if m.group(1) is not None else m.group(2))
+        return args[i] if i < len(args) else ""
+
+    return _ARG_INDEX_RE.sub(one, out).replace("$ARGUMENTS", request)
+
+
+def render(skill: dict, body: str, request: str | None = None) -> str:
+    claude = skill.get("source") == "claude"
+    if claude:
+        body = substitute(skill, body, request)
     return (f'SKILL "{skill["name"]}" — follow these instructions for this task. Files the skill '
             f'mentions by relative path are in {skill["dir"]}.\n'
-            f"<skill>\n{body}\n</skill>")
+            + (CLAUDE_NOTE + "\n" if claude else "")
+            + f"<skill>\n{body}\n</skill>")
 
 
 def use_skill_text(skills: list[dict], name: str) -> str:

package/hooks-command.mjs

@@ -5,7 +5,7 @@
  *   approve     run this project's hooks (as they are now — an edit needs approving again)
  *   unapprove   stop running them
  */
-import { HOOK_EVENTS, describeHook, readHooks, approveProjectHooks, userSettingsPath } from "./hooks-config.mjs";
+import { HOOK_EVENTS, GU_TO_CLAUDE_EVENT, describeHook, readHooks, approveProjectHooks } from "./hooks-config.mjs";
 
 export const HOOKS_USAGE = "gu hooks [list|approve|unapprove]";
 
@@ -13,7 +13,9 @@ function printGroups(hooks, print, indent = "  ") {
   for (const ev of HOOK_EVENTS) {
     for (const g of hooks[ev] ?? []) {
       const on = g.matcher ? `  (tools: ${g.matcher})` : "";
-      for (const h of g.hooks) print(`${indent}${ev.padEnd(11)} ${describeHook(h)}${on}`);
+      // A Claude Code hook is listed under the name it has in Claude's file.
+      const name = g.dialect === "claude" ? GU_TO_CLAUDE_EVENT[ev] : ev;
+      for (const h of g.hooks) print(`${indent}${name.padEnd(g.dialect === "claude" ? 16 : 11)} ${describeHook(h)}${on}`);
     }
   }
 }
@@ -24,33 +26,36 @@ export async function runHooksCommand(words, { cwd = process.cwd(), print = cons
     if (sub === "list" || sub === "ls") {
       const r = readHooks({ cwd });
       for (const w of r.warnings) print(w, "warn");
+      const claude = r.source === "claude";
       const nUser = Object.keys(r.user).length;
       const nProj = Object.keys(r.project).length;
+      if (claude) print("Claude Code's hooks (/switch-skill) — gu runs them with Claude's event and tool names.", "dim");
       if (!nUser && !nProj) {
-        print("No hooks.");
-        print(`Add them under "hooks" in ${userSettingsPath()} — events: ${HOOK_EVENTS.join(", ")}.`, "dim");
-        return 0;
+        print(claude ? `No hooks gu can run in ${r.userFile} or ${r.projectFile}.` : "No hooks.");
+        if (!claude) print(`Add them under "hooks" in ${r.userFile} — events: ${HOOK_EVENTS.join(", ")}.`, "dim");
       }
       if (nUser) {
-        print(`Yours (${userSettingsPath()}):`, "ok");
+        print(`Yours (${r.userFile}):`, "ok");
         printGroups(r.user, (l) => print(l, "dim"));
       }
       if (nProj) {
         print(
           r.projectApproved
-            ? "This project's (./.gonext/settings.json) — approved:"
-            : "This project's (./.gonext/settings.json) — NOT running until you approve them:",
+            ? `This project's (${r.projectFile}) — approved:`
+            : `This project's (${r.projectFile}) — NOT running until you approve them:`,
           r.projectApproved ? "ok" : "warn"
         );
         printGroups(r.project, (l) => print(l, "dim"));
         if (!r.projectApproved) print("Check the commands above, then:  /hooks approve", "dim");
       }
+      // What Claude Code would run and gu does not — a guard nobody runs must not look active.
+      for (const n of r.notes) print(n, "warn");
       return 0;
     }
     if (sub === "approve" || sub === "unapprove") {
       const r = readHooks({ cwd });
       if (!Object.keys(r.project).length) {
-        print("This folder has no hooks of its own (./.gonext/settings.json).", "warn");
+        print(`This folder has no hooks of its own (${r.projectFile}).`, "warn");
         return 1;
       }
       approveProjectHooks({ cwd, approve: sub === "approve" });

package/hooks-config.mjs

@@ -18,6 +18,21 @@
  * them for that folder — and the approval is of their exact content (a hash): an edited hooks
  * block needs approving again. The approval lives in YOUR settings file, never the project's.
  *
+ * CLAUDE CODE'S HOOKS (#325). A folder that chose "Claude's skills" (/switch-skill) reads its hooks
+ * from Claude Code's own settings instead:
+ *   ~/.claude/settings.json                                       yours
+ *   <project>/.claude/settings.json, .claude/settings.local.json  the project's — approved here first
+ * Those are filed under CLAUDE's event names and match CLAUDE's tool names, and the commands expect
+ * Claude's input. So each group is marked `dialect: "claude"`, and the agent speaks Claude's
+ * vocabulary to it (gu_hooks.py): SessionStart / UserPromptSubmit / PostToolUse / Stop at gu's four
+ * moments, Edit / Write / Read / Grep / Glob / Bash for gu's tools, Claude's field names on stdin.
+ * Tested with a real Claude memory hook: with the folder switched and nothing translated it never
+ * ran; with only the event names translated it ran and recorded nothing.
+ * What gu cannot honour is SAID, never skipped in silence: an event gu has no moment for
+ * (PreToolUse — a guard someone may be relying on), a hook that is not a command, a hook limited by
+ * an `if` rule gu cannot evaluate. Read-only: gu never writes Claude's settings files; the approval
+ * of a project's hooks is still kept in ~/.gonext/settings.json.
+ *
  * THE SESSION. onStart fires on the first turn of a gu session. The terminal writes a new session
  * id into the folder's session file when it starts (and on /reset); sessionForTurn reads it back so
  * the agent can tell "new session" from "next turn" with nothing added to the API.
@@ -26,6 +41,7 @@ import { createHash } from "node:crypto";
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
+import { resolveSkillSource, sessionFileFor, sourceDirName } from "./skill-source.mjs";
 
 export const HOOK_EVENTS = ["onStart", "onAsk", "onToolDone", "onTurnEnd"];
 /** Claude Code's names → gu's. Only used to tell the user what to rename. */
@@ -36,8 +52,13 @@ export const CLAUDE_EVENT_NAMES = {
   Stop: "onTurnEnd",
 };
 
-export const userSettingsPath = (home = homedir()) => join(home, ".gonext", "settings.json");
-export const projectSettingsPath = (cwd) => join(cwd, ".gonext", "settings.json");
+/** gu's moment → Claude Code's event: the name a Claude hook is filed under, and is told it is. */
+export const GU_TO_CLAUDE_EVENT = Object.fromEntries(Object.entries(CLAUDE_EVENT_NAMES).map(([c, g]) => [g, c]));
+
+export const userSettingsPath = (home = homedir(), source = "gu") => join(home, sourceDirName(source), "settings.json");
+export const projectSettingsPath = (cwd, source = "gu") => join(cwd, sourceDirName(source), "settings.json");
+/** Claude Code's per-project file that is not committed — still a file in the project's folder. */
+export const projectLocalSettingsPath = (cwd) => join(cwd, ".claude", "settings.local.json");
 
 const isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
 
@@ -56,11 +77,54 @@ function readJson(file) {
   }
 }
 
-/** A settings file's hooks, cleaned: only gu events, only command hooks. → { hooks, warnings } */
-export function cleanHooks(raw, where) {
+/**
+ * A settings file's hooks, cleaned: only gu events, only command hooks. → { hooks, warnings, notes }
+ *
+ * `source: "claude"` reads the file as Claude Code wrote it: the keys are Claude's event names, the
+ * result is filed under gu's four moments with `dialect: "claude"` on every group. `notes` name
+ * what was left out and why — said by /hooks, not at every start.
+ */
+export function cleanHooks(raw, where, source = "gu") {
   const hooks = {};
   const warnings = [];
-  if (!isObj(raw)) return { hooks, warnings };
+  const notes = [];
+  if (!isObj(raw)) return { hooks, warnings, notes };
+  if (source === "claude") {
+    for (const [event, groups] of Object.entries(raw)) {
+      const gu = CLAUDE_EVENT_NAMES[event];
+      const list = Array.isArray(groups) ? groups.filter(isObj) : [];
+      if (!gu) {
+        const n = list.reduce((a, g) => a + (Array.isArray(g.hooks) ? g.hooks.length : 0), 0);
+        if (n) notes.push(`${where}: ${n} ${event} hook${n === 1 ? "" : "s"} — gu has no such moment, so ${n === 1 ? "it is" : "they are"} NOT run here.`);
+        continue;
+      }
+      for (const g of list) {
+        const hs = [];
+        for (const h of Array.isArray(g.hooks) ? g.hooks : []) {
+          if (!isObj(h)) continue;
+          const type = String(h.type ?? "command");
+          if (type !== "command") {
+            notes.push(`${where}: a ${event} hook of type "${type}" — gu runs command hooks only. Not run here.`);
+            continue;
+          }
+          if (!String(h.command ?? "").trim()) continue;
+          if (h.if !== undefined) {
+            // Narrowed by a permission rule gu cannot evaluate: running it everywhere would be wrong.
+            notes.push(`${where}: a ${event} hook limited by if: ${JSON.stringify(h.if)} — gu cannot evaluate that. Not run here.`);
+            continue;
+          }
+          hs.push({
+            type: "command",
+            command: String(h.command),
+            ...(Array.isArray(h.args) ? { args: h.args.map(String) } : {}),
+            ...(Number.isFinite(h.timeout) && h.timeout > 0 ? { timeout: h.timeout } : {}),
+          });
+        }
+        if (hs.length) (hooks[gu] ??= []).push({ matcher: String(g.matcher ?? ""), hooks: hs, dialect: "claude" });
+      }
+    }
+    return { hooks, warnings, notes };
+  }
   for (const [event, groups] of Object.entries(raw)) {
     if (!HOOK_EVENTS.includes(event)) {
       const gu = CLAUDE_EVENT_NAMES[event];
@@ -87,7 +151,7 @@ export function cleanHooks(raw, where) {
     }
     if (kept.length) hooks[event] = kept;
   }
-  return { hooks, warnings };
+  return { hooks, warnings, notes };
 }
 
 /** The exact content being approved — any edit changes it. */
@@ -95,36 +159,72 @@ export function hooksFingerprint(hooks) {
   return createHash("sha256").update(JSON.stringify(hooks ?? {})).digest("hex").slice(0, 16);
 }
 
-/** → { user, project, projectApproved, projectPending, warnings } */
-export function readHooks({ cwd, home = homedir() } = {}) {
+/** How each source's files are NAMED to the user (labels in messages — not paths to open). */
+const FILE_LABELS = {
+  gu: { user: "~/.gonext/settings.json", project: ".gonext/settings.json", shown: "./.gonext/settings.json" },
+  claude: { user: "~/.claude/settings.json", project: ".claude/settings.json", shown: "./.claude/settings.json" },
+};
+
+/** Where a folder's approval is kept in gu's settings: one slot per folder and per source. */
+const approvalKey = (cwd, source) => resolve(cwd) + (source === "claude" ? "#claude" : "");
+
+/** Two hook maps, one after the other (Claude's project file, then its local one). */
+function mergeHooks(a, b) {
+  const out = { ...a };
+  for (const [ev, groups] of Object.entries(b)) out[ev] = [...(out[ev] ?? []), ...groups];
+  return out;
+}
+
+/**
+ * `source` = whose hooks ("gu" | "claude"); left out, it is the folder's own choice.
+ * → { user, project, projectApproved, projectPending, warnings, notes, source, userFile, projectFile }
+ */
+export function readHooks({ cwd, home = homedir(), source } = {}) {
+  const src = resolveSkillSource({ source, cwd, home });
+  const label = FILE_LABELS[src];
   const warnings = [];
-  const u = readJson(userSettingsPath(home));
-  if (u.error) warnings.push(`${userSettingsPath(home)} is ${u.error} — its hooks are skipped`);
-  const user = cleanHooks(u.data?.hooks, "~/.gonext/settings.json");
+  const notes = [];
+  const userFile = userSettingsPath(home, src);
+  const u = readJson(userFile);
+  if (u.error) warnings.push(`${userFile} is ${u.error} — its hooks are skipped`);
+  const user = cleanHooks(u.data?.hooks, label.user, src);
   warnings.push(...user.warnings);
-  let project = { hooks: {}, warnings: [] };
+  notes.push(...user.notes);
+  let project = {};
   let projectApproved = false;
-  if (cwd && resolve(projectSettingsPath(cwd)) !== resolve(userSettingsPath(home))) {
-    const p = readJson(projectSettingsPath(cwd));
-    if (p.error) warnings.push(`${projectSettingsPath(cwd)} is ${p.error} — its hooks are skipped`);
-    project = cleanHooks(p.data?.hooks, ".gonext/settings.json");
-    warnings.push(...project.warnings);
-    const approved = u.data?.approvedProjectHooks?.[resolve(cwd)];
-    projectApproved = Object.keys(project.hooks).length > 0 && approved === hooksFingerprint(project.hooks);
+  if (cwd && resolve(projectSettingsPath(cwd, src)) !== resolve(userFile)) {
+    const files = [[projectSettingsPath(cwd, src), label.project]];
+    if (src === "claude") files.push([projectLocalSettingsPath(cwd), ".claude/settings.local.json"]);
+    for (const [file, where] of files) {
+      const p = readJson(file);
+      if (p.error) warnings.push(`${file} is ${p.error} — its hooks are skipped`);
+      const cleaned = cleanHooks(p.data?.hooks, where, src);
+      warnings.push(...cleaned.warnings);
+      notes.push(...cleaned.notes);
+      project = mergeHooks(project, cleaned.hooks);
+    }
+    // gu's OWN settings file holds the approval, whichever source the hooks came from.
+    const own = src === "gu" ? u : readJson(userSettingsPath(home));
+    const approved = own.data?.approvedProjectHooks?.[approvalKey(cwd, src)];
+    projectApproved = Object.keys(project).length > 0 && approved === hooksFingerprint(project);
   }
-  const hasProject = Object.keys(project.hooks).length > 0;
+  const hasProject = Object.keys(project).length > 0;
   return {
     user: user.hooks,
-    project: project.hooks,
+    project,
     projectApproved,
     projectPending: hasProject && !projectApproved,
     warnings,
+    notes,
+    source: src,
+    userFile,
+    projectFile: label.shown,
   };
 }
 
 /** What one turn runs: yours first, then the project's when approved. */
-export function hooksForTurn({ cwd, home = homedir() } = {}) {
-  const r = readHooks({ cwd, home });
+export function hooksForTurn({ cwd, home = homedir(), source } = {}) {
+  const r = readHooks({ cwd, home, source });
   const out = {};
   for (const ev of HOOK_EVENTS) {
     const groups = [...(r.user[ev] ?? []), ...(r.projectApproved ? r.project[ev] ?? [] : [])];
@@ -134,15 +234,15 @@ export function hooksForTurn({ cwd, home = homedir() } = {}) {
 }
 
 /** Approve (or withdraw) this folder's hooks, as they are right now. */
-export function approveProjectHooks({ cwd, home = homedir(), approve = true }) {
-  const r = readHooks({ cwd, home });
-  const file = userSettingsPath(home);
+export function approveProjectHooks({ cwd, home = homedir(), approve = true, source }) {
+  const r = readHooks({ cwd, home, source });
+  const file = userSettingsPath(home); // gu's own, always — Claude's settings are never written
   const { data, error } = readJson(file);
   if (error) throw new Error(`${file} is ${error} — fix or remove it first`);
   const raw = data ?? {};
   raw.approvedProjectHooks = isObj(raw.approvedProjectHooks) ? raw.approvedProjectHooks : {};
-  if (approve) raw.approvedProjectHooks[resolve(cwd)] = hooksFingerprint(r.project);
-  else delete raw.approvedProjectHooks[resolve(cwd)];
+  if (approve) raw.approvedProjectHooks[approvalKey(cwd, r.source)] = hooksFingerprint(r.project);
+  else delete raw.approvedProjectHooks[approvalKey(cwd, r.source)];
   mkdirSync(dirname(file), { recursive: true });
   const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
   writeFileSync(tmp, JSON.stringify(raw, null, 2) + "\n", { encoding: "utf8", mode: 0o600 });
@@ -152,11 +252,8 @@ export function approveProjectHooks({ cwd, home = homedir(), approve = true }) {
 
 /* ---------------------------------------------------------------- the session ------------ */
 
-/** The terminal's per-folder session file — the same name gu-repl.mjs uses. */
-export function sessionFileFor(cwd, home = homedir()) {
-  const hash = createHash("sha256").update(cwd).digest("hex").slice(0, 32);
-  return join(home, ".gonext", "sessions", `${hash}.json`);
-}
+/** The terminal's per-folder session file — the same name gu-repl.mjs uses (skill-source.mjs). */
+export { sessionFileFor };
 
 /** → { id, startedAt } | null. null = no terminal session (the web, or an older terminal). */
 export function sessionForTurn(cwd, home = homedir()) {

package/mcp-command.mjs

@@ -31,6 +31,7 @@ import {
   removeServer,
   setDisabled,
   userConfigPath,
+  userServersPath,
   SERVER_NAME_RE,
 } from "./mcp-config.mjs";
 
@@ -146,15 +147,20 @@ export async function runMcpCommand(words, { cwd = process.cwd(), print = consol
     switch (sub) {
       case "list":
       case "ls": {
-        const { servers, warnings } = listServers({ cwd });
+        const { servers, warnings, source } = listServers({ cwd });
         for (const x of warnings) print(x, "warn");
         if (!servers.length) {
-          print("No MCP servers yet.");
+          print(source === "claude" ? `No MCP servers in Claude Code's setup (${userServersPath(undefined, source)}, ./.mcp.json).` : "No MCP servers yet.");
           print(`Add one:  /mcp add   (or in a shell: ${ADD_USAGE})`, "dim");
           return 0;
         }
         const results = await probe(servers.filter((s) => s.runnable), { cwd });
-        print(`MCP servers — yours in ${userConfigPath()}, this folder's in ./.mcp.json`, "dim");
+        print(
+          source === "claude"
+            ? `MCP servers — Claude Code's: yours in ${userServersPath(undefined, source)}, this folder's in ./.mcp.json  (/switch-skill)`
+            : `MCP servers — yours in ${userConfigPath()}, this folder's in ./.mcp.json`,
+          "dim"
+        );
         for (const s of servers) {
           print(statusLine(s, results[s.name]), results[s.name]?.ok ? "ok" : undefined);
           if (!s.error) print(`    ${describeServer(s)}`, "dim");
@@ -233,8 +239,8 @@ export async function runMcpCommand(words, { cwd = process.cwd(), print = consol
           print(`"${name}" is this project's (./.mcp.json) — it will not start here any more. Edit that file to delete it.`);
           return 0;
         }
-        const found = removeServer({ name });
-        print(found ? `Removed "${name}".` : `No MCP server named "${name}" in ${userConfigPath()}.`, found ? "ok" : "warn");
+        const found = removeServer({ name, cwd });
+        print(found ? `Removed "${name}".` : `No MCP server named "${name}" in ${userServersPath(undefined, listServers({ cwd }).source)}.`, found ? "ok" : "warn");
         return found ? 0 : 1;
       }
       case "enable":

package/mcp-config.mjs

@@ -18,13 +18,27 @@
  * tool is read-only (readOnlyHint) is NOT a rule: the MCP spec says clients must treat those hints
  * as untrusted, and a hostile server would simply claim it.
  *
+ * CLAUDE CODE'S SERVERS (#325). A folder that chose "Claude's skills" (/switch-skill) takes YOUR
+ * servers from Claude Code's own file instead of ~/.gonext/mcp.json:
+ *   ~/.claude.json   projects["<this folder>"].mcpServers   (Claude's "local" scope — this folder only)
+ *   ~/.claude.json   mcpServers                             (Claude's "user" scope — every folder)
+ * The project's .mcp.json is the same file either way. Yours still win over the project's. gu's own
+ * bookkeeping — disabled, the allow/deny rules, which project servers you approved — stays in
+ * ~/.gonext/mcp.json whichever source is chosen: Claude Code's file has no place for it, and gu
+ * reads Claude's setup without Claude ever having to read gu's.
+ *
+ * ~/.claude.json IS CLAUDE CODE'S WHOLE STATE FILE, not a config file of ours. It is only written
+ * when you add or remove a server yourself, and then only its mcpServers entry changes: re-read,
+ * change one key, write back atomically with the file's own permissions.
+ *
  * ONE WRITER SHAPE. Both `gu mcp` and `/mcp` go through updateUserConfig, which re-reads the file,
  * changes one thing and writes it back atomically — keys it does not know are kept. Rebuilding the
  * object from what one side knows is how a settings screen once deleted the other side's entries.
  */
-import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { mkdirSync, readFileSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
+import { resolveSkillSource } from "./skill-source.mjs";
 
 export const SERVER_NAME_RE = /^[A-Za-z0-9_-]{1,64}$/;
 
@@ -34,6 +48,13 @@ export function userConfigPath(home = homedir()) {
 export function projectConfigPath(cwd) {
   return join(cwd, ".mcp.json");
 }
+/** Claude Code's state file — where its user- and local-scope MCP servers are (#325). */
+export function claudeConfigPath(home = homedir()) {
+  return join(home, ".claude.json");
+}
+/** The file YOUR servers are in, for the source in use. */
+export const userServersPath = (home = homedir(), source = "gu") =>
+  source === "claude" ? claudeConfigPath(home) : userConfigPath(home);
 
 function readJson(file) {
   let text;
@@ -67,6 +88,39 @@ export function readUserConfig(home = homedir()) {
 
 const isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
 
+/** Claude Code's servers for this folder → { local, user, error? }. A missing file is no servers. */
+export function readClaudeServers({ cwd, home = homedir() } = {}) {
+  const { data, error } = readJson(claudeConfigPath(home));
+  const proj = cwd && isObj(data?.projects) ? data.projects[resolve(cwd)] : null;
+  return {
+    error,
+    local: isObj(proj?.mcpServers) ? proj.mcpServers : {},
+    user: isObj(data?.mcpServers) ? data.mcpServers : {},
+  };
+}
+
+/**
+ * Change ~/.claude.json: re-read, edit in place, write back atomically, permissions kept. Refused
+ * when the file is not valid JSON — it is Claude Code's, and not ours to "repair".
+ */
+export function updateClaudeConfig(mutate, home = homedir()) {
+  const file = claudeConfigPath(home);
+  const { data, error } = readJson(file);
+  if (error) throw new Error(`${file} is ${error} — fix it first (it is Claude Code's own file)`);
+  const raw = data ?? {};
+  mutate(raw);
+  let mode = 0o600;
+  try {
+    mode = statSync(file).mode & 0o777;
+  } catch {
+    /* a new file: private, as Claude Code makes it */
+  }
+  const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
+  writeFileSync(tmp, JSON.stringify(raw, null, 2) + "\n", { encoding: "utf8", mode });
+  renameSync(tmp, file);
+  return raw;
+}
+
 /** Write ~/.gonext/mcp.json atomically: a crash mid-write leaves the old file, never half of one. */
 function writeUserRaw(raw, home) {
   const file = userConfigPath(home);
@@ -103,12 +157,17 @@ export function normalizeServer(entry) {
 
 /**
  * Every server this folder knows of, with its state.
- * → { servers: [{ name, scope, type, command, args, env, disabled, approved, runnable, error? }], warnings }
+ * `source` = whose servers ("gu" | "claude"); left out, it is the folder's own choice.
+ * scope: "user" (yours, every folder), "local" (Claude's: yours, this folder only), "project".
+ * → { servers: [{ name, scope, type, command, args, env, disabled, approved, runnable, error? }], warnings, source }
  */
-export function listServers({ cwd = process.cwd(), home = homedir() } = {}) {
+export function listServers({ cwd = process.cwd(), home = homedir(), source } = {}) {
+  const src = resolveSkillSource({ source, cwd, home });
   const user = readUserConfig(home);
   const warnings = [];
-  if (user.error) warnings.push(`${userConfigPath(home)} is ${user.error} — its servers are skipped`);
+  if (user.error) {
+    warnings.push(`${userConfigPath(home)} is ${user.error} — ${src === "claude" ? "its rules and approvals are skipped" : "its servers are skipped"}`);
+  }
   const servers = [];
   const seen = new Set();
   const add = (name, entry, scope, approved) => {
@@ -129,7 +188,14 @@ export function listServers({ cwd = process.cwd(), home = homedir() } = {}) {
       runnable: !n.error && !disabled && approved,
     });
   };
-  for (const [name, entry] of Object.entries(user.mcpServers)) add(name, entry, "user", true);
+  if (src === "claude") {
+    const claude = readClaudeServers({ cwd, home });
+    if (claude.error) warnings.push(`${claudeConfigPath(home)} is ${claude.error} — its servers are skipped`);
+    for (const [name, entry] of Object.entries(claude.local)) add(name, entry, "local", true);
+    for (const [name, entry] of Object.entries(claude.user)) add(name, entry, "user", true);
+  } else {
+    for (const [name, entry] of Object.entries(user.mcpServers)) add(name, entry, "user", true);
+  }
   if (cwd) {
     const proj = readJson(projectConfigPath(cwd));
     if (proj.error) warnings.push(`${projectConfigPath(cwd)} is ${proj.error} — its servers are skipped`);
@@ -138,12 +204,12 @@ export function listServers({ cwd = process.cwd(), home = homedir() } = {}) {
       add(name, entry, "project", approvedHere.includes(name));
     }
   }
-  return { servers, warnings };
+  return { servers, warnings, source: src };
 }
 
 /** What the worker hands the agent for one turn: the servers it may start, and the rules. */
-export function mcpForTurn({ cwd, home = homedir() } = {}) {
-  const { servers } = listServers({ cwd, home });
+export function mcpForTurn({ cwd, home = homedir(), source } = {}) {
+  const { servers } = listServers({ cwd, home, source });
   const user = readUserConfig(home);
   return {
     servers: servers
@@ -177,7 +243,7 @@ export function decide({ allow = [], deny = [] }, server, tool) {
 
 /* ---------------------------------------------------------------- changes -------------- */
 
-export function addServer({ name, command, args = [], env = {}, scope = "user", cwd, home = homedir() }) {
+export function addServer({ name, command, args = [], env = {}, scope = "user", cwd, home = homedir(), source }) {
   if (!SERVER_NAME_RE.test(name ?? "")) throw new Error(`"${name}" is not a valid name — use letters, digits, _ or -`);
   if (!String(command ?? "").trim()) throw new Error("no command given");
   const entry = { type: "stdio", command: String(command), args: args.map(String), env };
@@ -196,6 +262,15 @@ export function addServer({ name, command, args = [], env = {}, scope = "user",
     approveProjectServer({ name, cwd, home });
     return { file };
   }
+  if (resolveSkillSource({ source, cwd, home }) === "claude") {
+    // Claude Code's user scope. Its entry, its file; gu's file only forgets a stale "disabled".
+    updateClaudeConfig((raw) => {
+      raw.mcpServers = isObj(raw.mcpServers) ? raw.mcpServers : {};
+      raw.mcpServers[name] = entry;
+    }, home);
+    if (readUserConfig(home).disabled.includes(name)) setDisabled({ name, disabled: false, home });
+    return { file: claudeConfigPath(home) };
+  }
   updateUserConfig((raw) => {
     raw.mcpServers = isObj(raw.mcpServers) ? raw.mcpServers : {};
     raw.mcpServers[name] = entry;
@@ -205,10 +280,23 @@ export function addServer({ name, command, args = [], env = {}, scope = "user",
 }
 
 /** Remove from YOUR file. A project's server cannot be removed from here — only not approved. */
-export function removeServer({ name, home = homedir() }) {
+export function removeServer({ name, home = homedir(), cwd, source }) {
   let found = false;
+  const claude = resolveSkillSource({ source, cwd, home }) === "claude";
+  if (claude) {
+    // From Claude Code's file: this folder's own entry and the every-folder one.
+    const has = readClaudeServers({ cwd, home });
+    if (name in has.local || name in has.user) {
+      updateClaudeConfig((raw) => {
+        if (isObj(raw.mcpServers) && name in raw.mcpServers) delete raw.mcpServers[name];
+        const proj = cwd && isObj(raw.projects) ? raw.projects[resolve(cwd)] : null;
+        if (isObj(proj?.mcpServers) && name in proj.mcpServers) delete proj.mcpServers[name];
+      }, home);
+      found = true;
+    }
+  }
   updateUserConfig((raw) => {
-    if (isObj(raw.mcpServers) && name in raw.mcpServers) {
+    if (!claude && isObj(raw.mcpServers) && name in raw.mcpServers) {
       delete raw.mcpServers[name];
       found = true;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiens.nguyen/gu-cli",
-  "version": "1.0.784",
+  "version": "1.0.785",
   "description": "Gu CLI — the gu terminal plus the local worker that runs agent / OCR / PDF / embedding jobs on your Mac (Ollama / MLX / OpenAI-compatible).",
   "type": "module",
   "license": "MIT",
@@ -41,7 +41,7 @@
     "check:image": "node scripts/image-paste-check.mjs",
     "check:image-clipboard": "node scripts/image-paste-check.mjs --clipboard",
     "test:presets": "node --test tests/open-presets.test.mjs tests/preset-safety.test.mjs tests/preset-more.test.mjs tests/preset-apply.test.mjs tests/preset-full.test.mjs tests/presets-transfer.test.mjs tests/preset-editor.test.mjs tests/load-preset-paste.test.mjs",
-    "test:skills": "python3 scripts/py-tap.py tests/test_skills_mcp_turn.py tests/test_hooks_turn.py tests/test_mcp_client.py && node --test tests/skills.test.mjs tests/mcp-config.test.mjs tests/hooks-config.test.mjs tests/slash-menu.test.mjs tests/conversation-archive.test.mjs",
+    "test:skills": "python3 scripts/py-tap.py tests/test_skills_mcp_turn.py tests/test_hooks_turn.py tests/test_claude_hooks.py tests/test_mcp_client.py && node --test tests/skills.test.mjs tests/mcp-config.test.mjs tests/hooks-config.test.mjs tests/switch-skill.test.mjs tests/slash-menu.test.mjs tests/conversation-archive.test.mjs",
     "capture:turn": "GONEXT_OLLAMA1_LIVE=1 node scripts/capture-turn-fixture.mjs",
     "test:bearer": "node --test tests/bearer-routing.test.mjs tests/bearer-verify.test.mjs",
     "test:bearer-e2e": "bash scripts/bearer-e2e.sh"
@@ -109,6 +109,7 @@
     "powershell-alias.mjs",
     "install-path.mjs",
     "skills.mjs",
+    "skill-source.mjs",
     "mcp-config.mjs",
     "mcp-command.mjs",
     "hooks-config.mjs",