@sechroom/cli 2026.6.33 → 2026.6.34

package/dist/index.js

@@ -3307,6 +3307,41 @@ function resolveAgents(systemRows, personalRows, surface) {
   return resolveByRole(systemRows, personalRows, surface, AGENT_ROLE_TAG, AGENT_NAME_PREFIX);
 }
 
+// src/setup/skill-resolution-io.ts
+var AGENT_TARGET = { "claude-code": "claude-agent" };
+function agentTargetFor(surface) {
+  return AGENT_TARGET[surface] ?? `${surface}-agent`;
+}
+async function fetchFeedRows(cfg, workspaceId) {
+  try {
+    const client = await makeClient(cfg);
+    const feed = await client.GET("/workspaces/{workspaceId}/memories/feed", {
+      params: {
+        path: { workspaceId },
+        // cascadeWorkspaces: skills land in an "Operator Skills" SUB-workspace;
+        // includeText: the feed omits bodies by default, we need them for SKILL.md.
+        query: { limit: 200, cascadeWorkspaces: true, includeText: true }
+      }
+    }).then((r) => r.data).catch(() => void 0);
+    return feed?.results ?? feed?.Results ?? [];
+  } catch {
+    return [];
+  }
+}
+async function fetchTemplateRows(cfg, personalWorkspaceId) {
+  const [systemRows, personalRows] = await Promise.all([
+    fetchFeedRows(cfg, SYSTEM_WORKSPACE_ID),
+    personalWorkspaceId ? fetchFeedRows(cfg, personalWorkspaceId) : Promise.resolve([])
+  ]);
+  return { systemRows, personalRows };
+}
+function resolveSkillSet(rows, surface) {
+  return resolveSkills(rows.systemRows, rows.personalRows, surface);
+}
+function resolveAgentSet(rows, surface) {
+  return resolveAgents(rows.systemRows, rows.personalRows, agentTargetFor(surface));
+}
+
 // src/setup/skills-lock.ts
 import { existsSync as existsSync6, mkdirSync as mkdirSync6, readFileSync as readFileSync5, writeFileSync as writeFileSync6 } from "fs";
 import { join as join7 } from "path";
@@ -3338,31 +3373,12 @@ function recordMaterialisedSkills(dir, slug, skills, meta = {}) {
 }
 
 // src/setup/skills-offer.ts
-async function fetchFeedRows(cfg, workspaceId) {
-  try {
-    const client = await makeClient(cfg);
-    const feed = await client.GET("/workspaces/{workspaceId}/memories/feed", {
-      params: {
-        path: { workspaceId },
-        // cascadeWorkspaces: skills land in an "Operator Skills" SUB-workspace;
-        // includeText: the feed omits bodies by default, we need them for SKILL.md.
-        query: { limit: 200, cascadeWorkspaces: true, includeText: true }
-      }
-    }).then((r) => r.data).catch(() => void 0);
-    return feed?.results ?? feed?.Results ?? [];
-  } catch {
-    return [];
-  }
-}
 async function maybeOfferSkills(cfg, personalWorkspaceId, opts) {
   const surface = opts.surface ?? "claude-code";
   const configDir = opts.configDir ?? resolveClaudeTargets({})[0].dir;
-  const [systemRows, personalRows] = await Promise.all([
-    fetchFeedRows(cfg, SYSTEM_WORKSPACE_ID),
-    personalWorkspaceId ? fetchFeedRows(cfg, personalWorkspaceId) : Promise.resolve([])
-  ]);
-  const skills = resolveSkills(systemRows, personalRows, surface);
-  const agents = resolveAgents(systemRows, personalRows, surface);
+  const rows = await fetchTemplateRows(cfg, personalWorkspaceId);
+  const skills = resolveSkillSet(rows, surface);
+  const agents = resolveAgentSet(rows, surface);
   if (skills.length === 0 && agents.length === 0) return;
   const sDir = skillsDir(configDir);
   const aDir = agentsDir(configDir);
@@ -4600,10 +4616,6 @@ Examples:
   });
 }
 
-// src/commands/skills.ts
-import { join as join12 } from "path";
-import { existsSync as existsSync10, rmSync as rmSync2 } from "fs";
-
 // src/commands/lane.ts
 var LANE_KEYS = ["code-lane", "design-lane"];
 function showLane(json) {
@@ -4659,72 +4671,159 @@ In a non-primary git worktree the ratified concurrent-session -N suffix is auto-
   );
 }
 
+// src/setup/materialise.ts
+import { existsSync as existsSync10, mkdirSync as mkdirSync8, rmSync as rmSync2, writeFileSync as writeFileSync8 } from "fs";
+import { join as join12 } from "path";
+var CLIENT_SURFACE = "claude-code";
+function writeSkills(dir, skills, surface) {
+  const written = [];
+  for (const s of skills) {
+    mkdirSync8(join12(dir, s.name), { recursive: true });
+    writeFileSync8(join12(dir, s.name, "SKILL.md"), s.body.endsWith("\n") ? s.body : s.body + "\n");
+    written.push(s.name);
+  }
+  if (written.length) recordMaterialisedSkills(dir, DEFAULT_SKILLS_SLUG, written, { surface });
+  return written;
+}
+function writeAgents(dir, agents, surface) {
+  if (agents.length) mkdirSync8(dir, { recursive: true });
+  const written = [];
+  for (const a of agents) {
+    const file = `${a.name}.md`;
+    writeFileSync8(join12(dir, file), a.body.endsWith("\n") ? a.body : a.body + "\n");
+    written.push(file);
+  }
+  if (written.length) recordMaterialisedSkills(dir, DEFAULT_SKILLS_SLUG, written, { surface });
+  return written;
+}
+var SKILL_SPEC = { kind: "skill", dir: skillsDir, resolve: resolveSkillSet, write: writeSkills };
+var AGENT_SPEC = { kind: "agent", dir: agentsDir, resolve: resolveAgentSet, write: writeAgents };
+function scopeOf(opts) {
+  return opts.local ? "project" : resolveScope(opts.scope);
+}
+async function runInstall(spec, cmd, opts) {
+  const g = cmd.optsWithGlobals();
+  let scope;
+  try {
+    scope = scopeOf(opts);
+  } catch (err2) {
+    return fail(err2.message);
+  }
+  const cfg = resolveConfig(g);
+  const dryRun = Boolean(opts.dryRun);
+  const json = Boolean(g.json || opts.json);
+  const targets = resolveClaudeTargets({ override: g.claudeConfigDir, scope, cwd: process.cwd() });
+  const personalWorkspaceId = await getPersonalWorkspaceId(cfg);
+  const rows = await fetchTemplateRows(cfg, personalWorkspaceId);
+  const items = spec.resolve(rows, CLIENT_SURFACE);
+  const results = targets.map((t) => {
+    const dir = spec.dir(t.dir);
+    const written = dryRun ? items.map((i) => i.name) : spec.write(dir, items, CLIENT_SURFACE);
+    return { dir, label: t.label, written };
+  });
+  if (json) return emit({ kind: spec.kind, dryRun, available: items.length, targets: results }, true);
+  if (items.length === 0) {
+    console.log(style.dim(`No ${spec.kind}s available to install \u2014 is the bundle installed for your account?`));
+    return;
+  }
+  for (const r of results) {
+    console.log(
+      `${dryRun ? "" : style.green("\u2713 ")}${dryRun ? "would write" : "wrote"} ${r.written.length} ${spec.kind}(s) ${style.dim("\u2192")} ${r.dir}`
+    );
+    if (dryRun) for (const i of items) console.log(`    ${i.name} ${style.dim(`[${i.source}]`)}`);
+  }
+}
+function runList(spec, cmd, opts) {
+  const g = cmd.optsWithGlobals();
+  let scope;
+  try {
+    scope = scopeOf(opts);
+  } catch (err2) {
+    return fail(err2.message);
+  }
+  const json = Boolean(g.json || opts.json);
+  const targets = resolveClaudeTargets({ override: g.claudeConfigDir, scope, cwd: process.cwd() });
+  const out = targets.map((t) => {
+    const dir = spec.dir(t.dir);
+    const lock = readSkillsLock(dir);
+    const entries = Object.entries(lock).flatMap(
+      ([slug, e]) => (e.skills ?? []).map((name) => ({ slug, name, present: existsSync10(join12(dir, name)) }))
+    );
+    return { dir, label: t.label, entries };
+  });
+  if (json) return emit({ kind: spec.kind, targets: out }, true);
+  let any = false;
+  for (const t of out) {
+    if (t.entries.length === 0) continue;
+    any = true;
+    console.log(style.bold(t.dir) + ":");
+    for (const e of t.entries) {
+      const flag = e.present ? "" : style.dim("(missing) ");
+      console.log(`  ${flag}${e.name} ${style.dim(`[${e.slug}]`)}`);
+    }
+  }
+  if (!any) console.log(style.dim(`No ${spec.kind}s materialised. Run \`sechroom ${spec.kind}s install\`.`));
+}
+function runClean(spec, cmd, opts, slugArg) {
+  const g = cmd.optsWithGlobals();
+  const slug = slugArg || DEFAULT_SKILLS_SLUG;
+  let scope;
+  try {
+    scope = scopeOf(opts);
+  } catch (err2) {
+    return fail(err2.message);
+  }
+  const json = Boolean(g.json || opts.json);
+  const targets = resolveClaudeTargets({ override: g.claudeConfigDir, scope, cwd: process.cwd() });
+  const cleaned = [];
+  const missing = [];
+  for (const t of targets) {
+    const dir = spec.dir(t.dir);
+    const lock = readSkillsLock(dir);
+    const entry = lock[slug];
+    if (!entry) {
+      missing.push(join12(dir, SKILLS_LOCK));
+      continue;
+    }
+    const removed = [];
+    for (const name of entry.skills) {
+      const p = join12(dir, name);
+      if (existsSync10(p)) {
+        rmSync2(p, { recursive: true, force: true });
+        removed.push(name);
+      }
+    }
+    delete lock[slug];
+    writeSkillsLock(dir, lock);
+    cleaned.push({ dir, removed });
+  }
+  if (cleaned.length === 0) {
+    return fail(`No materialised ${spec.kind}s recorded for '${slug}' in ${missing.join(", ")}.`);
+  }
+  if (json) return emit({ kind: spec.kind, slug, cleaned, missing }, true);
+  for (const c of cleaned) {
+    console.log(style.green(`Removed ${c.removed.length} ${spec.kind}(s) for ${slug} from ${c.dir}`));
+  }
+}
+
 // src/commands/skills.ts
 function registerSkills(program2) {
-  const skills = program2.command("skills").description("Manage operator skills (materialised by `onboard`)");
+  const skills = program2.command("skills").description("Manage operator skills (install to disk, list, clean)");
   skills.addHelpText(
     "after",
     `
 Examples:
-  $ sechroom skills list
+  $ sechroom skills install                 materialise your installed skills to ~/.claude/skills
+  $ sechroom skills install --scope project  write them to ./.claude/skills instead
+  $ sechroom skills list                     what's materialised on disk
+  $ sechroom skills clean                    remove the materialised skill files
   $ sechroom skills set-lane --code-lane claude-code-chris --design-lane claude-design-chris
-  $ sechroom skills lane
-  $ sechroom skills clean
 
-To install/refresh skills, run 'sechroom onboard' (it offers to materialise them).`
+`
   );
-  skills.command("list").description("List your installed bundles (GET /me/bundle-installs)").option("--json", "machine output").action(async (opts, cmd) => {
-    const client = await makeClient(resolveConfig(cmd.optsWithGlobals()));
-    const data = await runApi("reading your installs", () => client.GET("/me/bundle-installs", {}));
-    if (opts.json) return emit(data, true);
-    const installs = data?.installs ?? data?.Installs ?? [];
-    if (installs.length === 0) return console.log(style.dim("No bundles installed."));
-    installs.forEach((i) => {
-      const inst = i.instance ?? i.Instance ?? "";
-      const tag = inst ? style.dim(` [${inst}]`) : "";
-      console.log(`  ${i.bundleSlug ?? i.BundleSlug}@${i.bundleVersion ?? i.BundleVersion ?? "?"}${tag}`);
-    });
-  });
-  skills.command("clean [slug]").description(`Remove skill files materialised by onboard (default ${DEFAULT_SKILLS_SLUG})`).option("--scope <scope>", "global (config dir / CLAUDE_CONFIG_DIR) or project (<cwd>/.claude) \u2014 default global").option("--local", "alias for --scope project").option("--json", "machine output").action(async (slugArg, opts, cmd) => {
-    const g = cmd.optsWithGlobals();
-    const slug = slugArg || DEFAULT_SKILLS_SLUG;
-    let scope;
-    try {
-      scope = opts.local ? "project" : resolveScope(opts.scope);
-    } catch (err2) {
-      return fail(err2.message);
-    }
-    const targets = resolveClaudeTargets({ override: g.claudeConfigDir, scope, cwd: process.cwd() });
-    const cleaned = [];
-    const missing = [];
-    for (const t of targets) {
-      const dir = skillsDir(t.dir);
-      const lock = readSkillsLock(dir);
-      const entry = lock[slug];
-      if (!entry) {
-        missing.push(join12(dir, SKILLS_LOCK));
-        continue;
-      }
-      const removed = [];
-      for (const name of entry.skills) {
-        const skillPath = join12(dir, name);
-        if (existsSync10(skillPath)) {
-          rmSync2(skillPath, { recursive: true, force: true });
-          removed.push(name);
-        }
-      }
-      delete lock[slug];
-      writeSkillsLock(dir, lock);
-      cleaned.push({ dir, removed });
-    }
-    if (cleaned.length === 0) {
-      return fail(`No materialised skills recorded for '${slug}' in ${missing.join(", ")}.`);
-    }
-    if (opts.json) return emit({ slug, cleaned, missing }, true);
-    for (const { dir, removed } of cleaned) {
-      console.log(style.green(`Removed ${removed.length} skill(s) for ${slug} from ${dir}`));
-    }
-  });
+  skills.command("install").description("Materialise your installed skills to disk (the already-installed bundle \u2014 no server install)").option("--scope <scope>", "global (config dir / CLAUDE_CONFIG_DIR) or project (<cwd>/.claude) \u2014 default global").option("--local", "alias for --scope project").option("--dry-run", "print what would be written; write nothing").option("--json", "machine output").action((opts, cmd) => runInstall(SKILL_SPEC, cmd, opts));
+  skills.command("list").description("List the skills materialised on disk (per resolved config dir)").option("--scope <scope>", "global (config dir / CLAUDE_CONFIG_DIR) or project (<cwd>/.claude) \u2014 default global").option("--local", "alias for --scope project").option("--json", "machine output").action((opts, cmd) => runList(SKILL_SPEC, cmd, opts));
+  skills.command("clean [slug]").description(`Remove skill files materialised to disk (default ${DEFAULT_SKILLS_SLUG})`).option("--scope <scope>", "global (config dir / CLAUDE_CONFIG_DIR) or project (<cwd>/.claude) \u2014 default global").option("--local", "alias for --scope project").option("--json", "machine output").action((slugArg, opts, cmd) => runClean(SKILL_SPEC, cmd, opts, slugArg));
   skills.command("set-lane").description("Alias of `sechroom lane set` (kept for back-compat) \u2014 write this checkout's lane pin").option("--code-lane <id>", "code-surface lane id (e.g. claude-code-chris)").option("--design-lane <id>", "design / substrate-authoring lane id (e.g. claude-design-chris)").option("--json", "machine output").action(
     (opts, cmd) => setLane({
       codeLane: opts.codeLane,
@@ -4795,6 +4894,27 @@ To install/refresh skills, run 'sechroom onboard' (it offers to materialise them
   });
 }
 
+// src/commands/agents.ts
+function registerAgents(program2) {
+  const agents = program2.command("agents").description("Manage operator subagents (install to disk, list, clean)");
+  agents.addHelpText(
+    "after",
+    `
+Examples:
+  $ sechroom agents install                 materialise your installed agents to ~/.claude/agents
+  $ sechroom agents install --scope project  write them to ./.claude/agents instead
+  $ sechroom agents install --claude-config-dir ~/.claude-abcs   target another instance
+  $ sechroom agents list                     what's materialised on disk
+  $ sechroom agents clean                    remove the materialised agent files
+
+Agents are resolved from the agent target (target:claude-agent), the dispatchable
+workers your loop skills call (e.g. find-prior-art \u2192 substrate-miner).`
+  );
+  agents.command("install").description("Materialise your installed subagents to disk (the already-installed bundle \u2014 no server install)").option("--scope <scope>", "global (config dir / CLAUDE_CONFIG_DIR) or project (<cwd>/.claude) \u2014 default global").option("--local", "alias for --scope project").option("--dry-run", "print what would be written; write nothing").option("--json", "machine output").action((opts, cmd) => runInstall(AGENT_SPEC, cmd, opts));
+  agents.command("list").description("List the subagents materialised on disk (per resolved config dir)").option("--scope <scope>", "global (config dir / CLAUDE_CONFIG_DIR) or project (<cwd>/.claude) \u2014 default global").option("--local", "alias for --scope project").option("--json", "machine output").action((opts, cmd) => runList(AGENT_SPEC, cmd, opts));
+  agents.command("clean [slug]").description(`Remove subagent files materialised to disk (default ${DEFAULT_SKILLS_SLUG})`).option("--scope <scope>", "global (config dir / CLAUDE_CONFIG_DIR) or project (<cwd>/.claude) \u2014 default global").option("--local", "alias for --scope project").option("--json", "machine output").action((slugArg, opts, cmd) => runClean(AGENT_SPEC, cmd, opts, slugArg));
+}
+
 // src/commands/reset.ts
 import { homedir as homedir4 } from "os";
 import { join as join13 } from "path";
@@ -5021,6 +5141,7 @@ registerNamespace(program);
 registerOnboard(program);
 registerSweep(program);
 registerSkills(program);
+registerAgents(program);
 registerLane(program);
 registerReset(program);
 program.parseAsync().catch((err2) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sechroom/cli",
-  "version": "2026.6.33",
+  "version": "2026.6.34",
   "description": "Sechroom CLI — a thin, generated client over the Sechroom HTTP API. An agent/human surface alongside MCP.",
   "type": "module",
   "license": "UNLICENSED",