@tricknowtech/context 0.2.0 → 0.3.0

package/README.md

@@ -10,7 +10,31 @@ npx @tricknowtech/context init
 
 ## The problem
 
-Open the same project on a second machine and the assistant knows nothing. Your instruction files travel with the repo, but the parts that actually accumulate — the per-project memory, your custom skills, and the thread of what you were doing — live in `~/.claude` and never leave the machine that built them.
+Open the same project on a second machine and your assistant knows nothing. Instruction files travel with the repo, but the parts that actually accumulate — per-project memory, custom skills and prompts, and the thread of what you were doing — live in your home directory and never leave the machine that built them.
+
+## Works with the tool you actually use
+
+Assistants are detected automatically, from what's installed and what the repo already contains:
+
+| Tool | Project files | User-global |
+|---|---|---|
+| Claude Code | `CLAUDE.md`, `.claude/**` | memory, skills, agents, plans |
+| OpenAI Codex | `AGENTS.md`, `.codex/**` | `AGENTS.md`, `config.toml`, prompts |
+| Cursor | `.cursorrules`, `.cursor/rules/**` | global rules |
+| GitHub Copilot | `.github/copilot-instructions.md`, instructions, prompts | — |
+| Gemini CLI | `GEMINI.md`, `.gemini/**` | `GEMINI.md`, settings, commands |
+| Windsurf | `.windsurfrules`, `.windsurf/**` | — |
+| Cline | `.clinerules` | — |
+| Aider | `CONVENTIONS.md`, `.aider.conf.yml` | — |
+| Continue | `.continue/**` | — |
+
+Each tool's home-directory config is namespaced in the store (`assistants/codex/…`) and restored to the right place on the other machine — `~/.codex`, `~/.gemini`, `~/.claude` — even when that machine's home and project paths are completely different.
+
+This also works across a *team* on different tools: a Cursor user's rules sync for a Claude user, because detection keys off what's in the repo, not just what's installed locally. Pin it explicitly if you'd rather:
+
+```json
+{ "assistants": ["claude", "codex"] }
+```
 
 ## What it does
 

package/dist/{chunk-6GB2SN2L.js → chunk-BLEGQVXA.js}

@@ -12,8 +12,9 @@ function cwdKey(absPath) {
 function makeTemplate(absPath, ctx) {
   const candidates = [
     [ctx.userClaude, "{userClaude}"],
-    [ctx.project, "{project}"]
-  ].sort((a, b) => b[0].length - a[0].length);
+    [ctx.project, "{project}"],
+    [ctx.home, "{home}"]
+  ].filter(([root]) => Boolean(root)).sort((a, b) => b[0].length - a[0].length);
   let out = absPath;
   for (const [root, token] of candidates) {
     if (absPath === root || absPath.startsWith(root + path.sep)) {
@@ -24,7 +25,7 @@ function makeTemplate(absPath, ctx) {
   return ctx.cwdKey ? out.split(ctx.cwdKey).join("{cwdKey}") : out;
 }
 function resolveTemplate(template, ctx) {
-  const expanded = template.split("{userClaude}").join(ctx.userClaude).split("{project}").join(ctx.project).split("{cwdKey}").join(ctx.cwdKey);
+  const expanded = template.split("{userClaude}").join(ctx.userClaude).split("{project}").join(ctx.project).split("{home}").join(ctx.home).split("{cwdKey}").join(ctx.cwdKey);
   return path.normalize(expanded);
 }
 function toPosix(p) {
@@ -181,6 +182,7 @@ function defaultConfig(projectRoot) {
     name: path2.basename(projectRoot),
     rootHint: projectRoot,
     tiers: ["core", "handoff"],
+    assistants: ["auto"],
     artifactPaths: ["graphify-out"],
     exclude: [...DEFAULT_EXCLUDE],
     remotes: {}
@@ -209,7 +211,9 @@ function loadConfig(projectRoot) {
     ...defaultConfig(projectRoot),
     ...cfg,
     remotes: cfg.remotes ?? {},
-    tiers: cfg.tiers ?? ["core", "handoff"]
+    tiers: cfg.tiers ?? ["core", "handoff"],
+    // Stores written before multi-assistant support have no `assistants` key.
+    assistants: cfg.assistants ?? ["auto"]
   };
 }
 function saveConfig(projectRoot, cfg) {
@@ -217,31 +221,27 @@ function saveConfig(projectRoot, cfg) {
 }
 
 // src/collector.ts
+import fs4 from "fs";
+import path4 from "path";
+
+// src/assistants.ts
 import fs3 from "fs";
+import os2 from "os";
 import path3 from "path";
-var PROJECT_CONTEXT_GLOBS = [
-  "CLAUDE.md",
-  "CLAUDE.local.md",
-  "AGENTS.md",
-  "**/CLAUDE.md",
-  "**/AGENTS.md",
-  ".cursorrules",
-  ".github/copilot-instructions.md",
-  ".claude/settings.json",
-  // `.local.json` variants are gitignored by default, so nothing else carries
-  // them — which makes them exactly the kind of file this tool exists for.
-  ".claude/settings.local.json",
-  ".claude/memory/",
-  ".claude/plans/",
-  ".claude/commands/",
-  ".claude/agents/",
-  ".claude/skills/"
-];
+function filesIn(dir, exclude, prefix) {
+  return walk(dir, { exclude }).map((abs) => ({
+    abs,
+    rel: `${prefix}/${toPosix(path3.relative(dir, abs))}`
+  }));
+}
+function fileIfExists(abs, rel) {
+  return fs3.existsSync(abs) ? [{ abs, rel }] : [];
+}
 function planStem(fileName) {
   return fileName.replace(/\.md$/, "").replace(/-agent-[0-9a-f]+$/i, "");
 }
-function collectPlans(plansDir, projectRoot, exclude) {
-  const all = walk(plansDir, { exclude });
+function relatedByProject(dir, projectRoot, exclude) {
+  const all = walk(dir, { exclude });
   if (all.length === 0) return [];
   const projectName = path3.basename(projectRoot);
   const related = /* @__PURE__ */ new Set();
@@ -263,10 +263,143 @@ function collectPlans(plansDir, projectRoot, exclude) {
   }
   return [...related];
 }
+var ADAPTERS = [
+  {
+    id: "claude",
+    name: "Claude Code",
+    projectGlobs: [
+      "CLAUDE.md",
+      "CLAUDE.local.md",
+      "**/CLAUDE.md",
+      ".claude/settings.json",
+      ".claude/settings.local.json",
+      ".claude/memory/",
+      ".claude/plans/",
+      ".claude/commands/",
+      ".claude/agents/",
+      ".claude/skills/"
+    ],
+    userDir: () => userClaudeDir(),
+    collectUser: (projectRoot, _home, exclude) => {
+      const root = userClaudeDir();
+      const out = [];
+      const key = cwdKey(projectRoot);
+      const projectsDir = path3.join(root, "projects");
+      let keys = [];
+      try {
+        keys = fs3.readdirSync(projectsDir, { withFileTypes: true }).filter((d) => d.isDirectory() && (d.name === key || d.name.startsWith(key + "-"))).map((d) => d.name);
+      } catch {
+        keys = [];
+      }
+      for (const k of keys) {
+        const memDir = path3.join(projectsDir, k, "memory");
+        const prefix = k === key ? "memory" : `memory-sub/${k.slice(key.length + 1)}`;
+        out.push(...filesIn(memDir, exclude, prefix));
+      }
+      out.push(...filesIn(path3.join(root, "skills"), exclude, "skills"));
+      out.push(...filesIn(path3.join(root, "agents"), exclude, "agents"));
+      for (const abs of relatedByProject(path3.join(root, "plans"), projectRoot, exclude)) {
+        out.push({ abs, rel: `plans/${path3.basename(abs)}` });
+      }
+      out.push(...fileIfExists(path3.join(root, "CLAUDE.md"), "user/CLAUDE.md"));
+      out.push(...fileIfExists(path3.join(root, "settings.json"), "user/settings.json"));
+      return out;
+    }
+  },
+  {
+    id: "codex",
+    name: "OpenAI Codex",
+    projectGlobs: ["AGENTS.md", "**/AGENTS.md", ".codex/"],
+    userDir: (home) => path3.join(home, ".codex"),
+    collectUser: (projectRoot, home, exclude) => {
+      const root = path3.join(home, ".codex");
+      const out = [];
+      out.push(...fileIfExists(path3.join(root, "AGENTS.md"), "user/AGENTS.md"));
+      out.push(...fileIfExists(path3.join(root, "config.toml"), "user/config.toml"));
+      out.push(...filesIn(path3.join(root, "prompts"), exclude, "prompts"));
+      return out;
+    }
+  },
+  {
+    id: "cursor",
+    name: "Cursor",
+    // `.cursorrules` is the legacy single-file form; `.cursor/rules/*.mdc` is current.
+    projectGlobs: [".cursorrules", ".cursor/rules/", ".cursor/"],
+    userDir: (home) => path3.join(home, ".cursor"),
+    collectUser: (_projectRoot, home, exclude) => filesIn(path3.join(home, ".cursor", "rules"), exclude, "rules")
+  },
+  {
+    id: "copilot",
+    name: "GitHub Copilot",
+    projectGlobs: [
+      ".github/copilot-instructions.md",
+      ".github/instructions/",
+      ".github/prompts/"
+    ]
+  },
+  {
+    id: "windsurf",
+    name: "Windsurf",
+    projectGlobs: [".windsurfrules", ".windsurf/rules/", ".windsurf/"],
+    userDir: (home) => path3.join(home, ".windsurf")
+  },
+  {
+    id: "gemini",
+    name: "Gemini CLI",
+    projectGlobs: ["GEMINI.md", "**/GEMINI.md", ".gemini/"],
+    userDir: (home) => path3.join(home, ".gemini"),
+    collectUser: (_projectRoot, home, exclude) => {
+      const root = path3.join(home, ".gemini");
+      const out = [];
+      out.push(...fileIfExists(path3.join(root, "GEMINI.md"), "user/GEMINI.md"));
+      out.push(...fileIfExists(path3.join(root, "settings.json"), "user/settings.json"));
+      out.push(...filesIn(path3.join(root, "commands"), exclude, "commands"));
+      return out;
+    }
+  },
+  {
+    id: "cline",
+    name: "Cline",
+    projectGlobs: [".clinerules", ".clinerules/"]
+  },
+  {
+    id: "aider",
+    name: "Aider",
+    projectGlobs: ["CONVENTIONS.md", ".aider.conf.yml", ".aider.conf.yaml"]
+  },
+  {
+    id: "continue",
+    name: "Continue",
+    projectGlobs: [".continue/", ".continuerules"],
+    userDir: (home) => path3.join(home, ".continue")
+  }
+];
+function adapterById(id) {
+  return ADAPTERS.find((a) => a.id === id);
+}
+function homeDir() {
+  return os2.homedir();
+}
+function detectAssistants(projectRoot, projectFiles) {
+  const home = homeDir();
+  return ADAPTERS.filter((a) => {
+    if (a.userDir) {
+      try {
+        if (fs3.existsSync(a.userDir(home))) return true;
+      } catch {
+      }
+    }
+    return projectFiles.some((rel) => matchesAny(rel, a.projectGlobs));
+  });
+}
+
+// src/collector.ts
 function push(out, sourcePath, storePath, tier, sourceRoot, ctx) {
   let size = 0;
   try {
-    size = fs3.statSync(sourcePath).size;
+    const st = fs4.statSync(sourcePath);
+    if (!st.isFile()) return;
+    size = st.size;
   } catch {
     return;
   }
@@ -279,76 +412,66 @@ function push(out, sourcePath, storePath, tier, sourceRoot, ctx) {
     restoreTemplate: makeTemplate(sourcePath, ctx)
   });
 }
+function templateContextFor(projectRoot) {
+  return {
+    userClaude: userClaudeDir(),
+    project: projectRoot,
+    cwdKey: cwdKey(projectRoot),
+    home: homeDir()
+  };
+}
 function collect(projectRoot, cfg, tiers) {
-  const userClaude = userClaudeDir();
-  const key = cwdKey(projectRoot);
-  const ctx = { userClaude, project: projectRoot, cwdKey: key };
+  const ctx = templateContextFor(projectRoot);
+  const home = ctx.home;
   const files = [];
   const skippedTracked = [];
   const exclude = [...HARD_DENY, ...cfg.exclude];
   const tracked = gitTrackedSet(projectRoot);
+  const projectRel = walk(projectRoot, { exclude }).map((abs) => ({
+    abs,
+    rel: toPosix(path4.relative(projectRoot, abs))
+  }));
+  const configured = cfg.assistants && cfg.assistants.length > 0 && !cfg.assistants.includes("auto");
+  const assistants = configured ? cfg.assistants.map(adapterById).filter(Boolean) : detectAssistants(projectRoot, projectRel.map((p) => p.rel));
   if (tiers.includes("core")) {
-    for (const abs of walk(projectRoot, { exclude })) {
-      const rel = toPosix(path3.relative(projectRoot, abs));
-      if (!matchesAny(rel, PROJECT_CONTEXT_GLOBS)) continue;
-      if (tracked.has(abs)) {
-        skippedTracked.push(rel);
-        continue;
+    const claimed = /* @__PURE__ */ new Set();
+    for (const adapter of assistants) {
+      for (const { abs, rel } of projectRel) {
+        if (claimed.has(rel)) continue;
+        if (!matchesAny(rel, adapter.projectGlobs)) continue;
+        claimed.add(rel);
+        if (tracked.has(abs)) {
+          skippedTracked.push(rel);
+          continue;
+        }
+        push(files, abs, `project/${rel}`, "core", "project", ctx);
       }
-      push(files, abs, `project/${rel}`, "core", "project", ctx);
     }
-    const projectsDir = path3.join(userClaude, "projects");
-    let projectKeys = [];
-    try {
-      projectKeys = fs3.readdirSync(projectsDir, { withFileTypes: true }).filter((d) => d.isDirectory() && (d.name === key || d.name.startsWith(key + "-"))).map((d) => d.name);
-    } catch {
-      projectKeys = [];
-    }
-    for (const pk of projectKeys) {
-      const memoryDir = path3.join(projectsDir, pk, "memory");
-      for (const abs of walk(memoryDir, { exclude })) {
-        const rel = toPosix(path3.relative(memoryDir, abs));
-        const storePath = pk === key ? `memory/${rel}` : `memory-sub/${pk.slice(key.length + 1)}/${rel}`;
-        push(files, abs, storePath, "core", "user", ctx);
+    for (const adapter of assistants) {
+      if (!adapter.collectUser) continue;
+      for (const { abs, rel } of adapter.collectUser(projectRoot, home, exclude)) {
+        push(files, abs, `assistants/${adapter.id}/${rel}`, "core", "user", ctx);
       }
     }
-    for (const abs of collectPlans(path3.join(userClaude, "plans"), projectRoot, exclude)) {
-      const rel = toPosix(path3.relative(path3.join(userClaude, "plans"), abs));
-      push(files, abs, `plans/${rel}`, "core", "user", ctx);
-    }
-    const skillsDir = path3.join(userClaude, "skills");
-    for (const abs of walk(skillsDir, { exclude })) {
-      const rel = toPosix(path3.relative(skillsDir, abs));
-      push(files, abs, `skills/${rel}`, "core", "user", ctx);
-    }
-    const agentsDir = path3.join(userClaude, "agents");
-    for (const abs of walk(agentsDir, { exclude })) {
-      const rel = toPosix(path3.relative(agentsDir, abs));
-      push(files, abs, `agents/${rel}`, "core", "user", ctx);
-    }
-    for (const name of ["CLAUDE.md", "settings.json"]) {
-      const abs = path3.join(userClaude, name);
-      if (fs3.existsSync(abs)) push(files, abs, `user/${name}`, "core", "user", ctx);
-    }
   }
   if (tiers.includes("artifacts")) {
     for (const relDir of cfg.artifactPaths) {
-      const absDir = path3.join(projectRoot, relDir);
+      const absDir = path4.join(projectRoot, relDir);
       for (const abs of walk(absDir, { exclude })) {
-        const rel = toPosix(path3.relative(absDir, abs));
+        const rel = toPosix(path4.relative(absDir, abs));
         push(files, abs, `artifacts/${relDir}/${rel}`, "artifacts", "project", ctx);
       }
     }
   }
   if (tiers.includes("transcripts")) {
-    const projDir = path3.join(userClaude, "projects", key);
+    const projDir = path4.join(userClaudeDir(), "projects", ctx.cwdKey);
     for (const abs of walk(projDir, { exclude })) {
-      const rel = toPosix(path3.relative(projDir, abs));
+      const rel = toPosix(path4.relative(projDir, abs));
       if (rel.startsWith("memory/")) continue;
-      push(files, abs, `transcripts/${rel}`, "transcripts", "user", ctx);
+      push(files, abs, `transcripts/claude/${rel}`, "transcripts", "user", ctx);
     }
   }
-  return { files, skippedTracked, ctx };
+  return { files, skippedTracked, assistants, ctx };
 }
 function describeExcluded(projectRoot, tiers) {
   const userClaude = userClaudeDir();
@@ -361,15 +484,17 @@ function describeExcluded(projectRoot, tiers) {
       if (filter && !filter(abs)) continue;
       files++;
       try {
-        bytes += fs3.statSync(abs).size;
+        bytes += fs4.statSync(abs).size;
       } catch {
       }
     }
     return { files, bytes };
   };
   if (!tiers.includes("transcripts")) {
-    const projDir = path3.join(userClaude, "projects", key);
-    const m = measure(projDir, (p) => !p.includes(`${path3.sep}memory${path3.sep}`));
+    const m = measure(
+      path4.join(userClaude, "projects", key),
+      (p) => !p.includes(`${path4.sep}memory${path4.sep}`)
+    );
     if (m.files > 0) {
       out.push({
         label: "session transcripts",
@@ -383,7 +508,7 @@ function describeExcluded(projectRoot, tiers) {
     ["file-history", "edit-undo snapshots", "transient local undo state, not portable context"],
     ["tasks", "task outputs", "session-scoped tool output"]
   ]) {
-    const m = measure(path3.join(userClaude, dir));
+    const m = measure(path4.join(userClaude, dir));
     if (m.files > 0) out.push({ label, ...m, reason });
   }
   return out.filter((g) => g.bytes > 0);
@@ -484,8 +609,8 @@ function isStale(h, newestContentMs) {
 }
 
 // src/scaffold.ts
-import fs4 from "fs";
-import path4 from "path";
+import fs5 from "fs";
+import path5 from "path";
 var SLASH_COMMAND_PATH = ".claude/commands/context.md";
 var SLASH_COMMAND_BODY = `---
 description: Sync this project's LLM context (memory, skills, instructions, handoff)
@@ -535,26 +660,26 @@ Run the context-sync action requested in: $ARGUMENTS
 Run: \`npx @tricknowtech/context status\` and summarize the result.
 `;
 function installSlashCommand(projectRoot) {
-  const dest = path4.join(projectRoot, SLASH_COMMAND_PATH);
-  if (fs4.existsSync(dest)) return { path: SLASH_COMMAND_PATH, written: false };
-  ensureDir(path4.dirname(dest));
-  fs4.writeFileSync(dest, SLASH_COMMAND_BODY, "utf8");
+  const dest = path5.join(projectRoot, SLASH_COMMAND_PATH);
+  if (fs5.existsSync(dest)) return { path: SLASH_COMMAND_PATH, written: false };
+  ensureDir(path5.dirname(dest));
+  fs5.writeFileSync(dest, SLASH_COMMAND_BODY, "utf8");
   return { path: SLASH_COMMAND_PATH, written: true };
 }
 function ensureGitignoreEntries(projectRoot, artifactsEnabled) {
-  const gitignore = path4.join(projectRoot, ".gitignore");
+  const gitignore = path5.join(projectRoot, ".gitignore");
   const wanted = [".contextsync/transcripts/"];
   if (!artifactsEnabled) wanted.push(".contextsync/artifacts/");
   let existing = "";
   try {
-    existing = fs4.readFileSync(gitignore, "utf8");
+    existing = fs5.readFileSync(gitignore, "utf8");
   } catch {
   }
   const lines = new Set(existing.split("\n").map((l) => l.trim()));
   const missing = wanted.filter((w) => !lines.has(w));
   if (missing.length === 0) return [];
   const prefix = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
-  fs4.appendFileSync(
+  fs5.appendFileSync(
     gitignore,
     `${prefix}
 # tricknowtech context-sync \u2014 never commit these tiers
@@ -566,7 +691,7 @@ ${missing.join("\n")}
 }
 
 // src/secrets.ts
-import fs5 from "fs";
+import fs6 from "fs";
 var BENIGN_KEY = /(?:^|[_-])(?:input|output|prompt|completion|total|max|min|num|new|cache|cached|remaining|used|count|context|window|budget|estimated?)[_-]?tokens?$|tokens?[_-]?(?:count|used|limit|remaining|in|out|usage|per|budget)$/i;
 function looksLikeCredential(value) {
   if (/^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)+$/.test(value)) return false;
@@ -620,7 +745,7 @@ function scanFiles(files) {
   for (const file of files) {
     let buf;
     try {
-      buf = fs5.readFileSync(file.sourcePath);
+      buf = fs6.readFileSync(file.sourcePath);
     } catch {
       continue;
     }
@@ -658,8 +783,8 @@ function formatHits(hits) {
 }
 
 // src/store.ts
-import fs6 from "fs";
-import path5 from "path";
+import fs7 from "fs";
+import path6 from "path";
 var MANIFEST_FILE = "manifest.json";
 var LocalStore = class {
   constructor(projectRoot) {
@@ -670,13 +795,13 @@ var LocalStore = class {
     return storeDir(this.projectRoot);
   }
   write(files, projectRoot) {
-    for (const name of fs6.existsSync(this.dir) ? fs6.readdirSync(this.dir) : []) {
+    for (const name of fs7.existsSync(this.dir) ? fs7.readdirSync(this.dir) : []) {
       if (name === "config.json" || name === HANDOFF_FILE) continue;
-      fs6.rmSync(path5.join(this.dir, name), { recursive: true, force: true });
+      fs7.rmSync(path6.join(this.dir, name), { recursive: true, force: true });
     }
     const entries = [];
     for (const file of files) {
-      const dest = path5.join(this.dir, file.storePath);
+      const dest = path6.join(this.dir, file.storePath);
       try {
         copyFile(file.sourcePath, dest);
       } catch {
@@ -697,11 +822,11 @@ var LocalStore = class {
       writtenFrom: projectRoot,
       entries
     };
-    writeJson(path5.join(this.dir, MANIFEST_FILE), manifest);
+    writeJson(path6.join(this.dir, MANIFEST_FILE), manifest);
     return manifest;
   }
   readManifest() {
-    return readJson(path5.join(this.dir, MANIFEST_FILE));
+    return readJson(path6.join(this.dir, MANIFEST_FILE));
   }
   restore(ctx, opts = {}) {
     const manifest = this.readManifest();
@@ -709,12 +834,12 @@ var LocalStore = class {
     const skipped = [];
     if (!manifest) return { restored, skipped };
     for (const entry of manifest.entries) {
-      const src = path5.join(this.dir, entry.storePath);
-      if (!fs6.existsSync(src)) continue;
+      const src = path6.join(this.dir, entry.storePath);
+      if (!fs7.existsSync(src)) continue;
       const dest = resolveTemplate(entry.restoreTemplate, ctx);
-      if (!opts.force && fs6.existsSync(dest)) {
+      if (!opts.force && fs7.existsSync(dest)) {
         try {
-          if (!fs6.readFileSync(dest).equals(fs6.readFileSync(src))) {
+          if (!fs7.readFileSync(dest).equals(fs7.readFileSync(src))) {
             skipped.push(entry.storePath);
             continue;
           }
@@ -724,8 +849,8 @@ var LocalStore = class {
         }
       }
       try {
-        ensureDir(path5.dirname(dest));
-        fs6.copyFileSync(src, dest);
+        ensureDir(path6.dirname(dest));
+        fs7.copyFileSync(src, dest);
         restored.push(entry.storePath);
       } catch {
         skipped.push(entry.storePath);
@@ -734,10 +859,10 @@ var LocalStore = class {
     return { restored, skipped };
   }
   readHandoff() {
-    return readJson(path5.join(this.dir, HANDOFF_FILE));
+    return readJson(path6.join(this.dir, HANDOFF_FILE));
   }
   writeHandoff(handoff) {
-    writeJson(path5.join(this.dir, HANDOFF_FILE), handoff);
+    writeJson(path6.join(this.dir, HANDOFF_FILE), handoff);
   }
 };
 
@@ -766,6 +891,7 @@ export {
   configPath,
   loadConfig,
   saveConfig,
+  templateContextFor,
   collect,
   describeExcluded,
   summarize,