agent-session-kill 0.1.0 → 0.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 NPKILL-style cleanup for AI coding-agent session remnants.
 
-`agent-session-kill` scans local Claude Code, Pi/pi-mono, Oh My Pi (OMP), and subagent temp storage, then lets you review and delete stale session artifacts from an interactive terminal UI.
+`agent-session-kill` scans local Claude Code, Pi/pi-mono, Oh My Pi (OMP), GitHub Copilot Chat, and subagent temp storage, then lets you review and delete stale session artifacts from an interactive terminal UI.
 
 ## Why
 
@@ -32,13 +32,36 @@ npx agent-session-kill
 ## Commands
 
 ```bash
-agent-session-kill                         # interactive picker
-agentkill                                  # short alias
-agent-session-kill interactive             # explicit picker
-agent-session-kill scan --older-than 14d   # non-interactive inventory
-agent-session-kill scan --json             # machine-readable inventory
-agent-session-kill clean --dry-run         # non-interactive dry run
-agent-session-kill clean --apply           # apply non-interactive manifest
+# Interactive picker (default)
+agent-session-kill
+agentkill                                           # short alias
+
+# Limit to specific tools
+agent-session-kill --tool copilot                   # Copilot Chat only
+agent-session-kill --tool claude,omp                # multiple tools
+
+# Orphan detection — OMP sessions for deleted projects trashed regardless of age
+agent-session-kill --workspace ~/workspace
+
+# Include cache files as cleanup candidates
+agent-session-kill --include-cache
+
+# Non-interactive inventory
+agent-session-kill scan                             # table output
+agent-session-kill scan --json                      # machine-readable
+agent-session-kill scan --tool copilot --json       # scoped to one tool
+agent-session-kill scan --older-than 7d             # tighter age threshold
+
+# Dry-run manifest (print what would be deleted)
+agent-session-kill clean --dry-run
+agent-session-kill clean --dry-run --include-cache  # include cache in preview
+
+# Apply cleanup
+agent-session-kill clean --apply                    # trash (recoverable)
+agent-session-kill clean --apply --permanent        # permanent delete
+
+# Delegate cleanup to native tools (claude project purge, omp worktree clear)
+agent-session-kill clean --dry-run --delegates
 ```
 
 ## Interactive controls
@@ -63,12 +86,13 @@ Rows that are protected or kept are visible but not selectable.
 | Option | Description | Default |
 | --- | --- | --- |
 | `--older-than <duration>` | Minimum age for stale artifacts. Supports `m`, `h`, `d`. | `14d` |
-| `--tool <name>` | Limit to `claude`, `pi`, `omp`, or `temp`. Repeat or comma-separate. | all |
+| `--tool <name>` | Limit to `claude`, `pi`, `omp`, `temp`, or `copilot`. Repeat or comma-separate. | all |
 | `--include-cache` | Include cache roots as cleanup candidates. | off |
 | `--json` | Print JSON. Always non-interactive. | off |
 | `--delegates` | Run delegated dry-runs (`claude project purge`, `omp worktree clear`). | off |
 | `--home <path>` | Home directory to scan. | current user home |
 | `--temp <path>` | Temp directory to scan. | OS temp dir |
+| `--workspace <path>` | Workspace directory; OMP sessions for projects no longer on disk are flagged as orphaned and trashed regardless of age (scans 2 levels deep). | off |
 | `--dry-run` | Force dry-run mode. | off |
 | `--apply` | Apply cleanup in `clean` mode. | off |
 | `--permanent` | Permanently delete instead of trashing. | off |
@@ -106,6 +130,16 @@ Claude project transcripts under `~/.claude/projects/` are protected from direct
 
 OMP worktrees are handled through `omp worktree clear --dry-run` when delegates are enabled.
 
+### GitHub Copilot Chat (VS Code)
+
+- `ask-agent/`, `plan-agent/`, `explore-agent/`, `logContextRecordings/`, `memory-tool/`
+- `copilot.cli.oldGlobalSessions.json`
+- `copilot.cli.workspaceSessions.*.json`
+- `commandEmbeddings.json`, `settingEmbeddings.json`, `toolEmbeddingsCache.bin`, `copilot-cli-images/` only when `--include-cache` is set
+
+macOS path: `~/Library/Application Support/Code/User/globalStorage/github.copilot-chat`
+Linux path: `~/.config/Code/User/globalStorage/github.copilot-chat`
+
 ### Subagent temp runs
 
 - `<temp>/pi-subagents-*/chain-runs/`
@@ -132,6 +166,9 @@ Examples:
 - `~/.omp/agent/config.yml`
 - `~/.omp/agent/managed-skills/`
 - `~/.omp/agent/memories/`
+- `~/.../github.copilot-chat/api.json`
+- `~/.../github.copilot-chat/mcpServers.json`
+- `~/.../github.copilot-chat/debugCommand`
 
 ## Safety model
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-session-kill",
-  "version": "0.1.0",
-  "description": "NPKILL-style cleanup for Claude, Pi, and OMP agent session remnants.",
+  "version": "0.2.0",
+  "description": "NPKILL-style cleanup for Claude, Pi, OMP, and GitHub Copilot Chat agent session remnants.",
   "type": "module",
   "license": "MIT",
   "author": "Kyle Brodeur",
@@ -15,6 +15,8 @@
   },
   "keywords": [
     "claude-code",
+    "github-copilot",
+    "copilot",
     "oh-my-pi",
     "pi",
     "sessions",

package/src/cli.js

@@ -9,7 +9,7 @@ import { formatJson, formatTable } from "./format.js";
 import { scanRemnants } from "./scanner.js";
 import { applyManifest } from "./apply.js";
 import { runInteractive } from "./interactive.js";
-const TOOLS = new Set(["claude", "pi", "omp", "temp"]);
+const TOOLS = new Set(["claude", "pi", "omp", "temp", "copilot"]);
 
 function usage() {
   return buildProgram().helpInformation().trimEnd();
@@ -38,6 +38,7 @@ function buildDefaultOptions() {
     tempDir: os.tmpdir(),
     dryRun: false,
     tools: new Set(TOOLS),
+    workspaceDir: undefined,
   };
 }
 
@@ -53,16 +54,17 @@ export function buildProgram() {
 
   program
     .name("agent-session-kill")
-    .description("NPKILL-style cleanup for Claude, Pi, and OMP agent session remnants")
+    .description("NPKILL-style cleanup for Claude, Pi, OMP, and Copilot agent session remnants")
     .exitOverride()
     .allowExcessArguments(false)
     .option("--older-than <duration>", "minimum age to consider stale", "14d")
-    .option("--tool <name>", "limit to claude, pi, omp, or temp; repeat or comma-separate", collectTools, [])
+    .option("--tool <name>", "limit to claude, pi, omp, temp, or copilot; repeat or comma-separate", collectTools, [])
     .option("--include-cache", "include cache roots in cleanup candidates", false)
     .option("--json", "print JSON instead of a table", false)
     .option("--delegates", "run delegate dry-run cleanup commands", false)
     .option("--home <path>", "home directory to scan", os.homedir())
     .option("--temp <path>", "temp directory to scan", os.tmpdir())
+    .option("--workspace <path>", "workspace directory for orphan detection")
     .option("--dry-run", "force dry-run mode", false)
     .option("--permanent", "permanently delete instead of trash", false);
 
@@ -112,6 +114,7 @@ export function parseCliArgs(argv) {
     tempDir: parsed.temp,
     dryRun: parsed.dryRun,
     tools: parsed.tool.length > 0 ? new Set(parsed.tool) : new Set(TOOLS),
+    workspaceDir: parsed.workspace,
   };
 
   if (options.dryRun) {
@@ -156,6 +159,7 @@ export async function main(argv = process.argv.slice(2), io = { stdin: process.s
       apply: false,
       permanent: options.permanent,
       tools: options.tools,
+      workspaceDir: options.workspaceDir,
     }, {
       stdin,
       stdout,
@@ -172,6 +176,7 @@ export async function main(argv = process.argv.slice(2), io = { stdin: process.s
     apply: options.apply,
     permanent: options.permanent,
     tools: options.tools,
+    workspaceDir: options.workspaceDir,
   });
 
   if (args.command === "clean" && !options.apply) {

package/src/protection.js

@@ -15,6 +15,7 @@ const PROTECTED_ROOT_NAMES = new Set([
 ]);
 
 const PROTECTED_FILE_PATTERNS = [
+  /^api\b/i,
   /^auth\b/i,
   /^settings\b/i,
   /^config\b/i,
@@ -100,6 +101,10 @@ function isCachePath(candidate, roots) {
     path.join(roots.piAgentDir, "cache"),
     path.join(roots.ompDir, "cache"),
     path.join(roots.ompAgentDir, "cache"),
+    path.join(roots.copilotChatDir, "commandEmbeddings.json"),
+    path.join(roots.copilotChatDir, "settingEmbeddings.json"),
+    path.join(roots.copilotChatDir, "toolEmbeddingsCache.bin"),
+    path.join(roots.copilotChatDir, "copilot-cli-images"),
   ].some((root) => isInside(candidate, root));
 }
 
@@ -112,6 +117,14 @@ export function isProtectedPath(candidate, roots) {
     return false;
   }
 
+  if (isInside(candidate, roots.copilotChatDir)) {
+    const absCandidate = absolute(candidate);
+    const absBase = absolute(roots.copilotChatDir);
+    if (absCandidate === path.join(absBase, "debugCommand")) return true;
+    if (absCandidate === path.join(absBase, "mcpServers.json")) return true;
+    return isProtectedUnderRoot(candidate, roots.copilotChatDir);
+  }
+
   return [roots.claudeDir, roots.piAgentDir, roots.ompAgentDir].some((root) => isProtectedUnderRoot(candidate, root));
 }
 

package/src/scanner.js

@@ -10,6 +10,10 @@ function buildRoots(options) {
   const piAgentDir = path.join(homeDir, ".pi", "agent");
   const ompDir = path.join(homeDir, ".omp");
   const ompAgentDir = path.join(ompDir, "agent");
+  const copilotChatDir =
+    process.platform === "darwin"
+      ? path.join(homeDir, "Library", "Application Support", "Code", "User", "globalStorage", "github.copilot-chat")
+      : path.join(homeDir, ".config", "Code", "User", "globalStorage", "github.copilot-chat");
 
   return {
     homeDir,
@@ -18,6 +22,7 @@ function buildRoots(options) {
     piAgentDir,
     ompDir,
     ompAgentDir,
+    copilotChatDir,
   };
 }
 
@@ -54,6 +59,23 @@ function staticCandidates(options, roots) {
     );
   }
 
+  if (selected(options, "copilot")) {
+    for (const [dirName, category] of [
+      ["ask-agent", "ask-agent"],
+      ["plan-agent", "plan-agent"],
+      ["explore-agent", "explore-agent"],
+      ["logContextRecordings", "log-context"],
+      ["memory-tool", "memory"],
+    ]) {
+      candidates.push({ tool: "copilot", category, root: path.join(roots.copilotChatDir, dirName) });
+    }
+    candidates.push({ tool: "copilot", category: "sessions", root: path.join(roots.copilotChatDir, "copilot.cli.oldGlobalSessions.json") });
+    for (const name of ["commandEmbeddings.json", "settingEmbeddings.json", "toolEmbeddingsCache.bin"]) {
+      candidates.push({ tool: "copilot", category: "cache", root: path.join(roots.copilotChatDir, name) });
+    }
+    candidates.push({ tool: "copilot", category: "cache", root: path.join(roots.copilotChatDir, "copilot-cli-images") });
+  }
+
   return candidates;
 }
 
@@ -88,7 +110,74 @@ async function tempCandidates(options, roots, errors) {
   return candidates;
 }
 
-function reasonFor({ cacheOptOut, protectedPath, oldEnough }) {
+async function copilotWorkspaceSessionCandidates(options, roots, errors) {
+  if (!selected(options, "copilot")) return [];
+  let dirents;
+  try {
+    dirents = await readdir(roots.copilotChatDir, { withFileTypes: true });
+  } catch (error) {
+    if (error?.code !== "ENOENT") errors.push(`Failed to read ${roots.copilotChatDir}: ${error.message}`);
+    return [];
+  }
+  return dirents
+    .filter(d => d.isFile() && d.name.startsWith("copilot.cli.workspaceSessions"))
+    .map(d => ({ tool: "copilot", category: "workspace-sessions", root: path.join(roots.copilotChatDir, d.name) }));
+}
+
+async function buildWorkspaceProjectIndex(workspaceDir, homeDir) {
+  const known = new Set();
+  known.add(workspaceDir.slice(homeDir.length).replace(/\//g, "-"));
+
+  let topDirents;
+  try {
+    topDirents = await readdir(workspaceDir, { withFileTypes: true });
+  } catch { return known; }
+
+  for (const dirent of topDirents) {
+    if (!dirent.isDirectory() || dirent.isSymbolicLink()) continue;
+    const p = path.join(workspaceDir, dirent.name);
+    known.add(p.slice(homeDir.length).replace(/\//g, "-"));
+    try {
+      const sub = await readdir(p, { withFileTypes: true });
+      for (const s of sub) {
+        if (!s.isDirectory() || s.isSymbolicLink()) continue;
+        const sp = path.join(p, s.name);
+        known.add(sp.slice(homeDir.length).replace(/\//g, "-"));
+      }
+    } catch {}
+  }
+  return known;
+}
+
+async function findOrphanedOmpSessionDirs(roots, workspaceDir, errors) {
+  const orphaned = new Set();
+  const sessionsRoot = path.join(roots.ompAgentDir, "sessions");
+  let dirents;
+  try {
+    dirents = await readdir(sessionsRoot, { withFileTypes: true });
+  } catch (error) {
+    if (error?.code !== "ENOENT") errors.push(`Failed to read ${sessionsRoot}: ${error.message}`);
+    return orphaned;
+  }
+
+  const workspaceEncoded = workspaceDir.slice(roots.homeDir.length).replace(/\//g, "-");
+  const prefix = workspaceEncoded + "-";
+  const known = await buildWorkspaceProjectIndex(workspaceDir, roots.homeDir);
+
+  for (const dirent of dirents) {
+    if (!dirent.isDirectory() || dirent.isSymbolicLink()) continue;
+    const name = dirent.name;
+    if (name !== workspaceEncoded && !name.startsWith(prefix)) continue;
+    if (name === prefix) continue;
+    if (!known.has(name)) {
+      orphaned.add(path.join(sessionsRoot, name));
+    }
+  }
+  return orphaned;
+}
+
+
+function reasonFor({ cacheOptOut, protectedPath, oldEnough, isOrphaned }) {
   if (cacheOptOut) {
     return "cache cleanup opt-out";
   }
@@ -97,6 +186,10 @@ function reasonFor({ cacheOptOut, protectedPath, oldEnough }) {
     return "protected path";
   }
 
+  if (isOrphaned) {
+    return "orphaned session";
+  }
+
   if (!oldEnough) {
     return "younger than threshold";
   }
@@ -109,7 +202,10 @@ function entryFor(filePath, stats, candidate, roots, options) {
   const cacheOptOut = classification.cache && !options.includeCache;
   const protectedPath = classification.protected || isProtectedPath(filePath, roots);
   const oldEnough = isOlderThan(stats.mtimeMs, options.nowMs, options.olderThanMs);
-  const action = protectedPath || cacheOptOut || !oldEnough ? "keep" : options.permanent ? "delete" : "trash";
+  const isOrphaned = (options.orphanedDirs?.size ?? 0) > 0 &&
+    [...options.orphanedDirs].some(dir => filePath.startsWith(dir + path.sep));
+  const effectivelyOld = isOrphaned || oldEnough;
+  const action = protectedPath || cacheOptOut || !effectivelyOld ? "keep" : options.permanent ? "delete" : "trash";
 
   return {
     tool: candidate.tool,
@@ -119,7 +215,7 @@ function entryFor(filePath, stats, candidate, roots, options) {
     sizeBytes: stats.size,
     modifiedMs: stats.mtimeMs,
     action,
-    reason: reasonFor({ cacheOptOut, protectedPath, oldEnough }),
+    reason: reasonFor({ cacheOptOut, protectedPath, oldEnough, isOrphaned }),
     protected: protectedPath,
   };
 }
@@ -196,13 +292,21 @@ export async function scanRemnants(options) {
   const roots = buildRoots(options);
   const errors = [];
   const entries = [];
+
+  const orphanedDirs = options.workspaceDir
+    ? await findOrphanedOmpSessionDirs(roots, options.workspaceDir, errors)
+    : new Set();
+
+  const effectiveOptions = { ...options, orphanedDirs };
+
   const candidates = [
-    ...staticCandidates(options, roots),
-    ...(await tempCandidates(options, roots, errors)),
+    ...staticCandidates(effectiveOptions, roots),
+    ...(await tempCandidates(effectiveOptions, roots, errors)),
+    ...(await copilotWorkspaceSessionCandidates(effectiveOptions, roots, errors)),
   ];
 
   for (const candidate of candidates) {
-    await walkCandidate(candidate, roots, options, entries, errors);
+    await walkCandidate(candidate, roots, effectiveOptions, entries, errors);
   }
 
   entries.sort((a, b) => a.path.localeCompare(b.path));