@sooink/ai-session-tidy 0.1.3 → 0.1.4

package/.github/workflows/release.yml

@@ -0,0 +1,57 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+
+      - name: Get version from tag
+        id: version
+        run: echo "version=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+
+      - name: Get previous tag
+        id: prev_tag
+        run: |
+          PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
+          echo "tag=$PREV_TAG" >> $GITHUB_OUTPUT
+
+      - name: Read CHANGELOG
+        id: changelog
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
+          PREV_TAG: ${{ steps.prev_tag.outputs.tag }}
+          CURRENT_TAG: ${{ github.ref_name }}
+          REPO: ${{ github.repository }}
+        run: |
+          # Extract section for this version only (between version header and next ## header)
+          CHANGES=$(sed -n "/^## ${VERSION}$/,/^## /p" CHANGELOG.md | sed '1d;$d')
+
+          # Add Full Changelog link if previous tag exists
+          if [ -n "$PREV_TAG" ]; then
+            LINK="**Full Changelog**: https://github.com/${REPO}/compare/${PREV_TAG}...${CURRENT_TAG}"
+            CHANGES=$(printf "%s\n\n---\n\n%s" "$CHANGES" "$LINK")
+          fi
+
+          echo "changes<<EOF" >> $GITHUB_OUTPUT
+          echo "$CHANGES" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          body: ${{ steps.changelog.outputs.changes }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+## 0.1.4
+
+- Added support for Claude Code tasks
+- Improve macOS background activity attribution for LaunchAgent (displays as `ai-session-tidy`)
+
+## 0.1.3
+
+- Fixed ignored folder patterns to match folders themselves (e.g., `/Downloads`, `/Documents`)
+- Fixed log files not being cleared on service start, causing stale error messages
+- Added TTY checks for interactive mode (`-i`) and confirmation prompts
+- Added helpful error messages in non-TTY environments (scripts/CI)
+- Changed `clean -i` to show clean "Selected items" list after selection
+
+## 0.1.2
+
+- Added system folder ignore patterns for watch mode
+- Added automatic exclusion of macOS system folders (Library, Applications, Downloads, etc.)
+- Added exclusion of hidden folders and node_modules from watching
+
+## 0.1.1
+
+- Fixed npm publish configuration
+
+## 0.1.0
+
+- Added scan command to find orphaned sessions from Claude Code and Cursor
+- Added clean command with interactive mode and trash support
+- Added watch command for automatic cleanup on project deletion
+- Added background daemon with auto-start at login (macOS)
+- Added config command for managing watch paths, delay, and depth

package/README.md

@@ -2,7 +2,7 @@
 
 # AI Session Tidy
 
-**Clean up orphaned sessions from AI coding tools**
+**Automatically clean up orphaned sessions from AI coding tools**
 
 [![npm version](https://img.shields.io/npm/v/@sooink/ai-session-tidy.svg?style=flat-square)](https://www.npmjs.com/package/@sooink/ai-session-tidy)
 [![node](https://img.shields.io/badge/node-%3E%3D24-brightgreen?style=flat-square)](https://nodejs.org/)
@@ -15,7 +15,7 @@
 
 ## The Problem
 
-AI coding tools like **Claude Code** and **Cursor** store session data locally—conversation history, file snapshots, todos, and more.
+AI coding tools like **Claude Code** and **Cursor** store session data locally—conversation history, file snapshots, todos, tasks, and more.
 
 When you delete, move, or rename a project, the session data becomes orphaned:
 
@@ -26,7 +26,8 @@ When you delete, move, or rename a project, the session data becomes orphaned:
 │   ├── -Users-you-temp-worktree/    # 👈 Worktree removed
 │   └── -Users-you-renamed-project/  # 👈 Project renamed
 ├── todos/                           # Orphaned todo files
-└── file-history/                    # Orphaned rewind snapshots
+├── file-history/                    # Orphaned rewind snapshots
+└── tasks/                           # Orphaned task folders
 ```
 
 This becomes especially problematic with **git worktree workflows**, where branches are frequently created and removed—each leaving behind session data that accumulates quickly.
@@ -104,11 +105,11 @@ ai-session-tidy --json       # JSON output
 ```
 ⚠ Found 2 session folder(s) + 1 config entry(ies) + 3 session-env folder(s) (156.2 MB)
 
-┌─────────────┬──────────┬────────┬─────┬───────┬─────────┬──────────┬───────────┐
-│ Tool        │ Sessions │ Config │ Env │ Todos │ History │ Size     │ Scan Time │
-├─────────────┼──────────┼────────┼─────┼───────┼─────────┼──────────┼───────────┤
-│ claude-code │ 2        │ 1      │ 3   │ -     │ -       │ 156.2 MB │ 45ms      │
-└─────────────┴──────────┴────────┴─────┴───────┴─────────┴──────────┴───────────┘
+┌─────────────┬──────────┬────────┬─────┬───────┬─────────┬───────┬──────────┬───────────┐
+│ Tool        │ Sessions │ Config │ Env │ Todos │ History │ Tasks │ Size     │ Scan Time │
+├─────────────┼──────────┼────────┼─────┼───────┼─────────┼───────┼──────────┼───────────┤
+│ claude-code │ 2        │ 1      │ 3   │ -     │ -       │ -     │ 156.2 MB │ 45ms      │
+└─────────────┴──────────┴────────┴─────┴───────┴─────────┴───────┴──────────┴───────────┘
 
 Session Folders:
 
@@ -183,6 +184,7 @@ ai-session-tidy config reset                  # Reset to defaults
 | `~/.claude/session-env/{uuid}/` | Session environment | Empty folder |
 | `~/.claude/todos/{uuid}-*.json` | Todo files | Session gone |
 | `~/.claude/file-history/{uuid}/` | Rewind snapshots | Session gone |
+| `~/.claude/tasks/{uuid}/` | Task folders | Session gone |
 
 ### Cursor
 

package/dist/index.js

@@ -119,6 +119,9 @@ function getClaudeTodosDir() {
 function getClaudeFileHistoryDir() {
   return join2(homedir(), ".claude", "file-history");
 }
+function getClaudeTasksDir() {
+  return join2(homedir(), ".claude", "tasks");
+}
 function tildify(path) {
   const home = homedir();
   if (path.startsWith(home)) {
@@ -139,6 +142,7 @@ var ClaudeCodeScanner = class {
   sessionEnvDir;
   todosDir;
   fileHistoryDir;
+  tasksDir;
   constructor(projectsDirOrOptions) {
     if (typeof projectsDirOrOptions === "string") {
       this.projectsDir = projectsDirOrOptions;
@@ -146,18 +150,21 @@ var ClaudeCodeScanner = class {
       this.sessionEnvDir = null;
       this.todosDir = null;
       this.fileHistoryDir = null;
+      this.tasksDir = null;
     } else if (projectsDirOrOptions) {
       this.projectsDir = projectsDirOrOptions.projectsDir ?? getClaudeProjectsDir();
       this.configPath = projectsDirOrOptions.configPath === void 0 ? getClaudeConfigPath() : projectsDirOrOptions.configPath;
       this.sessionEnvDir = projectsDirOrOptions.sessionEnvDir === void 0 ? getClaudeSessionEnvDir() : projectsDirOrOptions.sessionEnvDir;
       this.todosDir = projectsDirOrOptions.todosDir === void 0 ? getClaudeTodosDir() : projectsDirOrOptions.todosDir;
       this.fileHistoryDir = projectsDirOrOptions.fileHistoryDir === void 0 ? getClaudeFileHistoryDir() : projectsDirOrOptions.fileHistoryDir;
+      this.tasksDir = projectsDirOrOptions.tasksDir === void 0 ? getClaudeTasksDir() : projectsDirOrOptions.tasksDir;
     } else {
       this.projectsDir = getClaudeProjectsDir();
       this.configPath = getClaudeConfigPath();
       this.sessionEnvDir = getClaudeSessionEnvDir();
       this.todosDir = getClaudeTodosDir();
       this.fileHistoryDir = getClaudeFileHistoryDir();
+      this.tasksDir = getClaudeTasksDir();
     }
   }
   async isAvailable() {
@@ -204,6 +211,8 @@ var ClaudeCodeScanner = class {
     sessions.push(...todosSessions);
     const fileHistorySessions = await this.scanFileHistoryDir(validSessionIds);
     sessions.push(...fileHistorySessions);
+    const tasksSessions = await this.scanTasksDir(validSessionIds);
+    sessions.push(...tasksSessions);
     const totalSize = sessions.reduce((sum, s) => sum + s.size, 0);
     return {
       toolName: this.name,
@@ -373,6 +382,40 @@ var ClaudeCodeScanner = class {
     }
     return orphanedHistories;
   }
+  /**
+   * Detect orphaned folders from ~/.claude/tasks
+   * Folder name is the session UUID, contains .lock file
+   */
+  async scanTasksDir(validSessionIds) {
+    if (!this.tasksDir) {
+      return [];
+    }
+    const orphanedTasks = [];
+    try {
+      await access(this.tasksDir);
+      const entries = await readdir2(this.tasksDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        const sessionId = entry.name;
+        if (!validSessionIds.has(sessionId)) {
+          const taskPath = join3(this.tasksDir, entry.name);
+          const size = await getDirectorySize(taskPath);
+          const taskStat = await stat2(taskPath);
+          orphanedTasks.push({
+            toolName: this.name,
+            sessionPath: taskPath,
+            projectPath: sessionId,
+            // Session UUID
+            size,
+            lastModified: taskStat.mtime,
+            type: "tasks"
+          });
+        }
+      }
+    } catch {
+    }
+    return orphanedTasks;
+  }
   /**
    * Extract project path (cwd) from JSONL file
    */
@@ -616,6 +659,7 @@ function outputTable(results, verbose) {
   const sessionEnvEntries = allSessions.filter((s) => s.type === "session-env");
   const todosEntries = allSessions.filter((s) => s.type === "todos");
   const fileHistoryEntries = allSessions.filter((s) => s.type === "file-history");
+  const tasksEntries = allSessions.filter((s) => s.type === "tasks");
   const totalSize = results.reduce((sum, r) => sum + r.totalSize, 0);
   if (allSessions.length === 0) {
     logger.success("No orphaned sessions found.");
@@ -638,6 +682,9 @@ function outputTable(results, verbose) {
   if (fileHistoryEntries.length > 0) {
     parts.push(`${fileHistoryEntries.length} file-history folder(s)`);
   }
+  if (tasksEntries.length > 0) {
+    parts.push(`${tasksEntries.length} tasks folder(s)`);
+  }
   logger.warn(`Found ${parts.join(" + ")} (${formatSize(totalSize)})`);
   console.log();
   const summaryTable = new Table({
@@ -648,6 +695,7 @@ function outputTable(results, verbose) {
       chalk2.cyan("Env"),
       chalk2.cyan("Todos"),
       chalk2.cyan("History"),
+      chalk2.cyan("Tasks"),
       chalk2.cyan("Size"),
       chalk2.cyan("Scan Time")
     ],
@@ -660,6 +708,7 @@ function outputTable(results, verbose) {
       const envs = result.sessions.filter((s) => s.type === "session-env").length;
       const todos = result.sessions.filter((s) => s.type === "todos").length;
       const histories = result.sessions.filter((s) => s.type === "file-history").length;
+      const tasks = result.sessions.filter((s) => s.type === "tasks").length;
       summaryTable.push([
         result.toolName,
         folders > 0 ? String(folders) : "-",
@@ -667,6 +716,7 @@ function outputTable(results, verbose) {
         envs > 0 ? String(envs) : "-",
         todos > 0 ? String(todos) : "-",
         histories > 0 ? String(histories) : "-",
+        tasks > 0 ? String(tasks) : "-",
         formatSize(result.totalSize),
         `${result.scanDuration.toFixed(0)}ms`
       ]);
@@ -746,6 +796,19 @@ function outputTable(results, verbose) {
         console.log();
       }
     }
+    if (tasksEntries.length > 0) {
+      console.log();
+      console.log(chalk2.bold("Orphaned Tasks:"));
+      console.log();
+      for (const entry of tasksEntries) {
+        const folderName = entry.sessionPath.split("/").pop() || entry.sessionPath;
+        console.log(
+          `  ${chalk2.cyan("[tasks]")} ${chalk2.white(folderName)} ${chalk2.dim(`(${formatSize(entry.size)})`)}`
+        );
+        console.log(`    ${chalk2.dim("\u2192")} ${tildify(entry.sessionPath)}`);
+        console.log();
+      }
+    }
   }
   console.log();
   console.log(
@@ -804,7 +867,8 @@ var Cleaner = class {
         session: 0,
         sessionEnv: 0,
         todos: 0,
-        fileHistory: 0
+        fileHistory: 0,
+        tasks: 0
       },
       skippedCount: 0,
       alreadyGoneCount: 0,
@@ -835,6 +899,9 @@ var Cleaner = class {
             case "file-history":
               result.deletedByType.fileHistory++;
               break;
+            case "tasks":
+              result.deletedByType.tasks++;
+              break;
             default:
               result.deletedByType.session++;
           }
@@ -914,12 +981,14 @@ function formatGroupChoice(group) {
   const labels = {
     "session-env": "empty session-env folder",
     "todos": "orphaned todos file",
-    "file-history": "orphaned file-history folder"
+    "file-history": "orphaned file-history folder",
+    "tasks": "orphaned tasks folder"
   };
   const colors = {
     "session-env": chalk3.green,
     "todos": chalk3.magenta,
-    "file-history": chalk3.blue
+    "file-history": chalk3.blue,
+    "tasks": chalk3.cyan
   };
   const label = labels[group.type] || group.type;
   const count = group.sessions.length;
@@ -955,8 +1024,9 @@ var cleanCommand = new Command2("clean").description("Remove orphaned session da
     const fileHistoryEntries = allSessions.filter(
       (s) => s.type === "file-history"
     );
+    const tasksEntries = allSessions.filter((s) => s.type === "tasks");
     const individualSessions = allSessions.filter(
-      (s) => s.type !== "session-env" && s.type !== "todos" && s.type !== "file-history"
+      (s) => s.type !== "session-env" && s.type !== "todos" && s.type !== "file-history" && s.type !== "tasks"
     );
     const groupChoices = [];
     if (sessionEnvEntries.length > 0) {
@@ -980,6 +1050,13 @@ var cleanCommand = new Command2("clean").description("Remove orphaned session da
         totalSize: fileHistoryEntries.reduce((sum, s) => sum + s.size, 0)
       });
     }
+    if (tasksEntries.length > 0) {
+      groupChoices.push({
+        type: "tasks",
+        sessions: tasksEntries,
+        totalSize: tasksEntries.reduce((sum, s) => sum + s.size, 0)
+      });
+    }
     console.log();
     const parts = [];
     if (folderSessions.length > 0) {
@@ -997,6 +1074,9 @@ var cleanCommand = new Command2("clean").description("Remove orphaned session da
     if (fileHistoryEntries.length > 0) {
       parts.push(`${fileHistoryEntries.length} file-history folder(s)`);
     }
+    if (tasksEntries.length > 0) {
+      parts.push(`${tasksEntries.length} tasks folder(s)`);
+    }
     logger.warn(`Found ${parts.join(" + ")} (${formatSize(totalSize)})`);
     if (options.verbose && !options.interactive) {
       console.log();
@@ -1096,6 +1176,9 @@ var cleanCommand = new Command2("clean").description("Remove orphaned session da
       const dryRunHistories = sessionsToClean.filter(
         (s) => s.type === "file-history"
       );
+      const dryRunTasks = sessionsToClean.filter(
+        (s) => s.type === "tasks"
+      );
       for (const session of dryRunFolders) {
         console.log(
           `  ${chalk3.red("Would delete:")} ${tildify(session.sessionPath)} (${formatSize(session.size)})`
@@ -1128,6 +1211,12 @@ var cleanCommand = new Command2("clean").description("Remove orphaned session da
           `  ${chalk3.blue("Would delete:")} ${dryRunHistories.length} file-history folder(s) (${formatSize(dryRunHistories.reduce((sum, s) => sum + s.size, 0))})`
         );
       }
+      if (dryRunTasks.length > 0) {
+        console.log();
+        console.log(
+          `  ${chalk3.cyan("Would delete:")} ${dryRunTasks.length} tasks folder(s) (${formatSize(dryRunTasks.reduce((sum, s) => sum + s.size, 0))})`
+        );
+      }
       return;
     }
     if (!options.force) {
@@ -1174,6 +1263,9 @@ var cleanCommand = new Command2("clean").description("Remove orphaned session da
       if (deletedByType.fileHistory > 0) {
         parts2.push(`${deletedByType.fileHistory} file-history`);
       }
+      if (deletedByType.tasks > 0) {
+        parts2.push(`${deletedByType.tasks} tasks`);
+      }
       const summary = parts2.length > 0 ? parts2.join(" + ") : `${cleanResult.deletedCount} item(s)`;
       logger.success(
         `${action}: ${summary} (${formatSize(cleanResult.totalSizeDeleted)})`
@@ -1504,9 +1596,24 @@ import { existsSync as existsSync4 } from "fs";
 import { execSync } from "child_process";
 var SERVICE_LABEL = "sooink.ai-session-tidy.watcher";
 var PLIST_FILENAME = `${SERVICE_LABEL}.plist`;
+var BIN_NAME = "ai-session-tidy";
+var BUNDLE_IDENTIFIER = "io.github.sooink.ai-session-tidy";
 function getPlistPath() {
   return join7(homedir4(), "Library", "LaunchAgents", PLIST_FILENAME);
 }
+function getBinPath() {
+  try {
+    const binPath = execSync(`which ${BIN_NAME}`, {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+    if (binPath && existsSync4(binPath)) {
+      return binPath;
+    }
+  } catch {
+  }
+  return null;
+}
 function getNodePath() {
   return process.execPath;
 }
@@ -1517,20 +1624,35 @@ function getScriptPath() {
   }
   throw new Error("Could not determine script path");
 }
+function getProgramArgs(args) {
+  const binPath = getBinPath();
+  if (binPath) {
+    return [binPath, ...args];
+  }
+  return [getNodePath(), getScriptPath(), ...args];
+}
 function generatePlist(options) {
-  const allArgs = [options.nodePath, options.scriptPath, ...options.args];
-  const argsXml = allArgs.map((arg) => `    <string>${arg}</string>`).join("\n");
+  const argsXml = options.programArgs.map((arg) => `    <string>${arg}</string>`).join("\n");
   const home = homedir4();
+  const nodeBinDir = dirname3(process.execPath);
+  const systemPath = process.env["PATH"] ?? "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin";
+  const envPath = systemPath.includes(nodeBinDir) ? systemPath : `${nodeBinDir}:${systemPath}`;
   return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
   <key>Label</key>
   <string>${options.label}</string>
+  <key>AssociatedBundleIdentifiers</key>
+  <array>
+    <string>${BUNDLE_IDENTIFIER}</string>
+  </array>
   <key>EnvironmentVariables</key>
   <dict>
     <key>HOME</key>
     <string>${home}</string>
+    <key>PATH</key>
+    <string>${envPath}</string>
   </dict>
   <key>ProgramArguments</key>
   <array>
@@ -1573,9 +1695,7 @@ var ServiceManager = class {
     await writeFile2(stderrPath, "", "utf-8");
     const plistContent = generatePlist({
       label: SERVICE_LABEL,
-      nodePath: getNodePath(),
-      scriptPath: getScriptPath(),
-      args: ["watch", "run"]
+      programArgs: getProgramArgs(["watch", "run"])
     });
     await writeFile2(this.plistPath, plistContent, "utf-8");
   }
@@ -1857,10 +1977,11 @@ async function runWatcher(options) {
     watchPaths: validPaths,
     delayMs,
     depth,
-    ignorePaths: getIgnorePaths(),
+    ignorePaths: getIgnorePaths() ?? [],
     onDelete: async (events) => {
-      if (events.length === 1) {
-        logger.info(`Detected deletion: ${tildify(events[0].path)}`);
+      const firstEvent = events[0];
+      if (events.length === 1 && firstEvent) {
+        logger.info(`Detected deletion: ${tildify(firstEvent.path)}`);
       } else {
         logger.info(`Detected ${events.length} deletions (debounced)`);
         if (options.verbose) {
@@ -1897,6 +2018,9 @@ async function runWatcher(options) {
         if (deletedByType.fileHistory > 0) {
           parts.push(`${deletedByType.fileHistory} file-history`);
         }
+        if (deletedByType.tasks > 0) {
+          parts.push(`${deletedByType.tasks} tasks`);
+        }
         const summary = parts.length > 0 ? parts.join(" + ") : `${cleanResult.deletedCount} item(s)`;
         logger.success(
           `${action}: ${summary} (${formatSize(cleanResult.totalSizeDeleted)})`