stack-cleaner 1.1.5 → 1.2.1

package/README.md

@@ -14,7 +14,7 @@ Free · open source · runs locally · sends nothing.
 
 Over time, Claude Code accumulates a lot: user-level skills in `~/.claude`, project skills in every repo's `.claude`, plugins from a handful of marketplaces, MCP servers wired into different projects, and a pile of sub-agents. It gets hard to answer simple questions: *what do I actually have? what do I never use? what's duplicated? what can I safely remove?*
 
-This tool answers them. You run one command, it reads your local Claude Code install, and the web app shows everything **grouped by where it lives** (global vs. each project), with **real usage counts**, so you can spot the dead weight and build a one-click cleanup plan.
+This tool answers them. You run one command, it reads your local Claude Code install, and the web app shows everything **grouped by where it lives** (global vs. each project), with **real usage counts** and **automatic duplicate detection**, so you can spot the dead weight, see what's redundant, and build a one-click cleanup plan.
 
 ## How it works
 
@@ -83,6 +83,15 @@ It enumerates **every project** Claude Code knows about (from `~/.claude.json`),
 
 The scan reads your local Claude Code **transcripts** (`~/.claude/projects/*.jsonl`) to count real invocations for **skills, agents, and MCP servers**, so you can finally see what's *installed but never used*, even for the types that carry no usage count in plain config. It extracts **only the tool / skill / agent / MCP-server names, the counts, and the timestamps**, never your prompts, message text, tool arguments, file paths, or command contents. It all stays local until you choose to upload the file. Pass `--no-transcripts` to skip the transcript read entirely. (Skills and plugins also keep their counts from Claude Code's own `skillUsage` / `pluginUsage` tables.)
 
+## Finding duplicates
+
+Claude Code makes it easy to end up with the same thing twice — a standalone skill you installed by hand that a plugin now bundles, the same MCP server wired up from two sources, or same-named copies across global and a project. Stack Cleaner flags these **automatically**:
+
+- **Superseded by a plugin** — a standalone skill, agent, or MCP server that an installed plugin already provides. The plugin's copy stays updated; the loose one won't, so it's the safe one to remove.
+- **Same-name duplicates** and **duplicate MCP servers** — the same item installed two different ways.
+
+Every flagged item explains, in plain language, *what* it duplicates, *where* your copy lives, and *which* one to keep. A **Duplicates** filter and a **"Select N redundant copies"** button turn the whole pile into a one-click cleanup.
+
 ## Privacy & safety
 
 This is the part that matters, because the output describes your tooling.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stack-cleaner",
-  "version": "1.1.5",
+  "version": "1.2.1",
   "private": false,
   "license": "MIT",
   "description": "See, organize, and clean up your Claude Code skills, plugins, MCP servers, and agents (split by global vs. project).",

package/public/scan.mjs

@@ -35,8 +35,8 @@ import os from "node:os";
 import readline from "node:readline";
 import { pathToFileURL } from "node:url";
 
-const SCHEMA_VERSION = 1;
-const GENERATOR = "scan.mjs@1.1.5";
+const SCHEMA_VERSION = 2;
+const GENERATOR = "scan.mjs@1.2.1";
 const HOME = os.homedir();
 const CLAUDE = path.join(HOME, ".claude");
 
@@ -397,6 +397,35 @@ function buildProjectLabels(paths) {
   return labels;
 }
 
+// Enumerate what an installed plugin bundles, by reading its on-disk dir:
+//   <installDir>/skills/<name>/SKILL.md   → skill names
+//   <installDir>/agents/<name>.md         → agent names
+//   <installDir>/.mcp.json mcpServers     → mcp server names
+// Names only — no contents. Returns undefined when nothing is found.
+export function collectPluginBundles(installDir) {
+  if (!installDir || !exists(installDir)) return undefined;
+  const skills = [];
+  const skillsDir = path.join(installDir, "skills");
+  for (const d of listDir(skillsDir, "dir")) {
+    if (exists(path.join(skillsDir, d, "SKILL.md"))) skills.push(d);
+  }
+  const agents = [];
+  const agentsDir = path.join(installDir, "agents");
+  for (const f of listDir(agentsDir, "file")) {
+    if (f.endsWith(".md")) agents.push(f.replace(/\.md$/, ""));
+  }
+  const mcps = [];
+  const mcpCfg = readJSON(path.join(installDir, ".mcp.json"));
+  if (mcpCfg && mcpCfg.mcpServers && typeof mcpCfg.mcpServers === "object") {
+    for (const name of Object.keys(mcpCfg.mcpServers)) mcps.push(name);
+  }
+  const out = {};
+  if (skills.length) out.skills = skills;
+  if (agents.length) out.agents = agents;
+  if (mcps.length) out.mcps = mcps;
+  return Object.keys(out).length ? out : undefined;
+}
+
 // ---------- inventory build ----------
 // Collects every skill / agent / plugin / MCP item from the local install,
 // optionally overlays transcript usage, and returns the inventory OBJECT.
@@ -504,6 +533,7 @@ export async function buildInventory(opts = {}) {
       const installPath = entry && entry.installPath
         ? (entry.installPath.startsWith(HOME) ? tilde(entry.installPath) : "<external>")
         : undefined;
+      const bundles = entry && entry.installPath ? collectPluginBundles(entry.installPath) : undefined;
       items.push({
         // Bare name; the marketplace lives in `source` (matches the demo shape).
         id: `plugin:global:${pluginName}`,
@@ -513,6 +543,7 @@ export async function buildInventory(opts = {}) {
         source: marketplace || "",
         version: entry ? entry.version : undefined,
         path: installPath,
+        bundles,
         usageCount, lastUsedAt, usageClass,
         usageLabel: usageLabel(usageCount, lastUsedAt, usageClass),
         // The CLI wants the full name@marketplace form to uninstall.