@sooink/ai-session-tidy 0.1.3 → 0.1.4

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sooink/ai-session-tidy",
-  "version": "0.1.3",
-  "description": "CLI tool that detects and cleans orphaned session data from AI coding tools",
+  "version": "0.1.4",
+  "description": "CLI tool that automatically detects and cleans orphaned session data from AI coding tools",
   "type": "module",
   "bin": {
     "ai-session-tidy": "./dist/index.js"

package/src/commands/clean.ts

@@ -37,7 +37,7 @@ function formatSessionChoice(session: OrphanedSession): string {
 }
 
 interface GroupChoice {
-  type: 'session-env' | 'todos' | 'file-history';
+  type: 'session-env' | 'todos' | 'file-history' | 'tasks';
   sessions: OrphanedSession[];
   totalSize: number;
 }
@@ -47,11 +47,13 @@ function formatGroupChoice(group: GroupChoice): string {
     'session-env': 'empty session-env folder',
     'todos': 'orphaned todos file',
     'file-history': 'orphaned file-history folder',
+    'tasks': 'orphaned tasks folder',
   };
   const colors: Record<string, (s: string) => string> = {
     'session-env': chalk.green,
     'todos': chalk.magenta,
     'file-history': chalk.blue,
+    'tasks': chalk.cyan,
   };
   const label = labels[group.type] || group.type;
   const count = group.sessions.length;
@@ -103,16 +105,18 @@ export const cleanCommand = new Command('clean')
       const fileHistoryEntries = allSessions.filter(
         (s) => s.type === 'file-history'
       );
+      const tasksEntries = allSessions.filter((s) => s.type === 'tasks');
 
       // Individual selection targets (session folders and config entries)
       const individualSessions = allSessions.filter(
         (s) =>
           s.type !== 'session-env' &&
           s.type !== 'todos' &&
-          s.type !== 'file-history'
+          s.type !== 'file-history' &&
+          s.type !== 'tasks'
       );
 
-      // Group selection targets (session-env, todos, file-history)
+      // Group selection targets (session-env, todos, file-history, tasks)
       const groupChoices: GroupChoice[] = [];
       if (sessionEnvEntries.length > 0) {
         groupChoices.push({
@@ -135,6 +139,13 @@ export const cleanCommand = new Command('clean')
           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),
+        });
+      }
 
       // Output summary
       console.log();
@@ -154,6 +165,9 @@ export const cleanCommand = new Command('clean')
       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) {
@@ -283,6 +297,9 @@ export const cleanCommand = new Command('clean')
         const dryRunHistories = sessionsToClean.filter(
           (s) => s.type === 'file-history'
         );
+        const dryRunTasks = sessionsToClean.filter(
+          (s) => s.type === 'tasks'
+        );
 
         for (const session of dryRunFolders) {
           console.log(
@@ -319,6 +336,12 @@ export const cleanCommand = new Command('clean')
             `  ${chalk.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(
+            `  ${chalk.cyan('Would delete:')} ${dryRunTasks.length} tasks folder(s) (${formatSize(dryRunTasks.reduce((sum, s) => sum + s.size, 0))})`
+          );
+        }
         return;
       }
 
@@ -375,6 +398,9 @@ export const cleanCommand = new Command('clean')
         if (deletedByType.fileHistory > 0) {
           parts.push(`${deletedByType.fileHistory} file-history`);
         }
+        if (deletedByType.tasks > 0) {
+          parts.push(`${deletedByType.tasks} tasks`);
+        }
 
         const summary =
           parts.length > 0

package/src/commands/scan.ts

@@ -85,6 +85,7 @@ function outputTable(results: ScanResult[], verbose?: boolean): void {
   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) {
@@ -111,6 +112,9 @@ function outputTable(results: ScanResult[], verbose?: boolean): void {
   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();
 
@@ -123,6 +127,7 @@ function outputTable(results: ScanResult[], verbose?: boolean): void {
       chalk.cyan('Env'),
       chalk.cyan('Todos'),
       chalk.cyan('History'),
+      chalk.cyan('Tasks'),
       chalk.cyan('Size'),
       chalk.cyan('Scan Time'),
     ],
@@ -136,6 +141,7 @@ function outputTable(results: ScanResult[], verbose?: boolean): void {
       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) : '-',
@@ -143,6 +149,7 @@ function outputTable(results: ScanResult[], verbose?: boolean): void {
         envs > 0 ? String(envs) : '-',
         todos > 0 ? String(todos) : '-',
         histories > 0 ? String(histories) : '-',
+        tasks > 0 ? String(tasks) : '-',
         formatSize(result.totalSize),
         `${result.scanDuration.toFixed(0)}ms`,
       ]);
@@ -240,6 +247,22 @@ function outputTable(results: ScanResult[], verbose?: boolean): void {
       }
     }
 
+    // Tasks
+    if (tasksEntries.length > 0) {
+      console.log();
+      console.log(chalk.bold('Orphaned Tasks:'));
+      console.log();
+
+      for (const entry of tasksEntries) {
+        const folderName = entry.sessionPath.split('/').pop() || entry.sessionPath;
+        console.log(
+          `  ${chalk.cyan('[tasks]')} ${chalk.white(folderName)} ${chalk.dim(`(${formatSize(entry.size)})`)}`
+        );
+        console.log(`    ${chalk.dim('→')} ${tildify(entry.sessionPath)}`);
+        console.log();
+      }
+    }
+
   }
 
   console.log();

package/src/commands/watch.ts

@@ -265,11 +265,12 @@ async function runWatcher(options: RunOptions): Promise<void> {
     watchPaths: validPaths,
     delayMs,
     depth,
-    ignorePaths: getIgnorePaths(),
+    ignorePaths: getIgnorePaths() ?? [],
     onDelete: async (events) => {
       // Log batch 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) {
@@ -313,6 +314,9 @@ async function runWatcher(options: RunOptions): Promise<void> {
         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(

package/src/core/cleaner.ts

@@ -21,6 +21,7 @@ export interface CleanCountByType {
   sessionEnv: number;
   todos: number;
   fileHistory: number;
+  tasks: number;
 }
 
 export interface CleanResult {
@@ -55,6 +56,7 @@ export class Cleaner {
         sessionEnv: 0,
         todos: 0,
         fileHistory: 0,
+        tasks: 0,
       },
       skippedCount: 0,
       alreadyGoneCount: 0,
@@ -96,6 +98,9 @@ export class Cleaner {
             case 'file-history':
               result.deletedByType.fileHistory++;
               break;
+            case 'tasks':
+              result.deletedByType.tasks++;
+              break;
             default:
               result.deletedByType.session++;
           }

package/src/core/service.ts

@@ -6,6 +6,8 @@ import { execSync } from 'child_process';
 
 const SERVICE_LABEL = 'sooink.ai-session-tidy.watcher';
 const PLIST_FILENAME = `${SERVICE_LABEL}.plist`;
+const BIN_NAME = 'ai-session-tidy';
+const BUNDLE_IDENTIFIER = 'io.github.sooink.ai-session-tidy';
 
 export type ServiceStatus = 'running' | 'stopped' | 'not_installed';
 
@@ -20,13 +22,26 @@ function getPlistPath(): string {
   return join(homedir(), 'Library', 'LaunchAgents', PLIST_FILENAME);
 }
 
+function getBinPath(): string | null {
+  try {
+    const binPath = execSync(`which ${BIN_NAME}`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+    }).trim();
+    if (binPath && existsSync(binPath)) {
+      return binPath;
+    }
+  } catch {
+    // not found in PATH
+  }
+  return null;
+}
+
 function getNodePath(): string {
-  // Get absolute path to node executable
   return process.execPath;
 }
 
 function getScriptPath(): string {
-  // Get absolute path to the CLI script
   const scriptPath = process.argv[1];
   if (scriptPath && existsSync(scriptPath)) {
     return scriptPath;
@@ -34,27 +49,57 @@ function getScriptPath(): string {
   throw new Error('Could not determine script path');
 }
 
+/**
+ * Build ProgramArguments for the LaunchAgent plist.
+ *
+ * Prefers the bin command path (e.g. /usr/local/bin/ai-session-tidy) so that
+ * macOS attributes the background activity to "ai-session-tidy" instead of
+ * "Node.js Foundation". Falls back to [node, script] if the bin is not found.
+ *
+ * @see https://developer.apple.com/forums/thread/735065
+ */
+function getProgramArgs(args: string[]): string[] {
+  const binPath = getBinPath();
+  if (binPath) {
+    return [binPath, ...args];
+  }
+  return [getNodePath(), getScriptPath(), ...args];
+}
+
 function generatePlist(options: {
   label: string;
-  nodePath: string;
-  scriptPath: string;
-  args: string[];
+  programArgs: string[];
 }): string {
-  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 = homedir();
 
+  // Include PATH so that shebang (#!/usr/bin/env node) can locate the node binary.
+  // This is necessary for nvm/fnm users where node is not in the default system PATH.
+  const nodeBinDir = dirname(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>
@@ -108,9 +153,7 @@ export class ServiceManager {
 
     const plistContent = generatePlist({
       label: SERVICE_LABEL,
-      nodePath: getNodePath(),
-      scriptPath: getScriptPath(),
-      args: ['watch', 'run'],
+      programArgs: getProgramArgs(['watch', 'run']),
     });
 
     await writeFile(this.plistPath, plistContent, 'utf-8');

package/src/scanners/claude-code.ts

@@ -11,6 +11,7 @@ import {
   getClaudeSessionEnvDir,
   getClaudeTodosDir,
   getClaudeFileHistoryDir,
+  getClaudeTasksDir,
 } from '../utils/paths.js';
 import { getDirectorySize } from '../utils/size.js';
 
@@ -36,6 +37,7 @@ export interface ClaudeCodeScannerOptions {
   sessionEnvDir?: string | null; // null to disable session-env scanning
   todosDir?: string | null; // null to disable todos scanning
   fileHistoryDir?: string | null; // null to disable file-history scanning
+  tasksDir?: string | null; // null to disable tasks scanning
 }
 
 export class ClaudeCodeScanner implements Scanner {
@@ -45,6 +47,7 @@ export class ClaudeCodeScanner implements Scanner {
   private readonly sessionEnvDir: string | null;
   private readonly todosDir: string | null;
   private readonly fileHistoryDir: string | null;
+  private readonly tasksDir: string | null;
 
   constructor(projectsDirOrOptions?: string | ClaudeCodeScannerOptions) {
     if (typeof projectsDirOrOptions === 'string') {
@@ -54,6 +57,7 @@ export class ClaudeCodeScanner implements Scanner {
       this.sessionEnvDir = null;
       this.todosDir = null;
       this.fileHistoryDir = null;
+      this.tasksDir = null;
     } else if (projectsDirOrOptions) {
       this.projectsDir = projectsDirOrOptions.projectsDir ?? getClaudeProjectsDir();
       this.configPath = projectsDirOrOptions.configPath === undefined
@@ -68,12 +72,16 @@ export class ClaudeCodeScanner implements Scanner {
       this.fileHistoryDir = projectsDirOrOptions.fileHistoryDir === undefined
         ? getClaudeFileHistoryDir()
         : projectsDirOrOptions.fileHistoryDir;
+      this.tasksDir = projectsDirOrOptions.tasksDir === undefined
+        ? getClaudeTasksDir()
+        : projectsDirOrOptions.tasksDir;
     } else {
       this.projectsDir = getClaudeProjectsDir();
       this.configPath = getClaudeConfigPath();
       this.sessionEnvDir = getClaudeSessionEnvDir();
       this.todosDir = getClaudeTodosDir();
       this.fileHistoryDir = getClaudeFileHistoryDir();
+      this.tasksDir = getClaudeTasksDir();
     }
   }
 
@@ -148,6 +156,10 @@ export class ClaudeCodeScanner implements Scanner {
     const fileHistorySessions = await this.scanFileHistoryDir(validSessionIds);
     sessions.push(...fileHistorySessions);
 
+    // 7. Scan ~/.claude/tasks for orphaned folders
+    const tasksSessions = await this.scanTasksDir(validSessionIds);
+    sessions.push(...tasksSessions);
+
     const totalSize = sessions.reduce((sum, s) => sum + s.size, 0);
 
     return {
@@ -360,6 +372,49 @@ export class ClaudeCodeScanner implements Scanner {
     return orphanedHistories;
   }
 
+  /**
+   * Detect orphaned folders from ~/.claude/tasks
+   * Folder name is the session UUID, contains .lock file
+   */
+  private async scanTasksDir(validSessionIds: Set<string>): Promise<OrphanedSession[]> {
+    if (!this.tasksDir) {
+      return [];
+    }
+
+    const orphanedTasks: OrphanedSession[] = [];
+
+    try {
+      await access(this.tasksDir);
+      const entries = await readdir(this.tasksDir, { withFileTypes: true });
+
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+
+        const sessionId = entry.name;
+
+        // Orphan if not in valid session IDs
+        if (!validSessionIds.has(sessionId)) {
+          const taskPath = join(this.tasksDir, entry.name);
+          const size = await getDirectorySize(taskPath);
+          const taskStat = await stat(taskPath);
+
+          orphanedTasks.push({
+            toolName: this.name,
+            sessionPath: taskPath,
+            projectPath: sessionId, // Session UUID
+            size,
+            lastModified: taskStat.mtime,
+            type: 'tasks',
+          });
+        }
+      }
+    } catch {
+      // Ignore if directory doesn't exist or access fails
+    }
+
+    return orphanedTasks;
+  }
+
   /**
    * Extract project path (cwd) from JSONL file
    */

package/src/scanners/types.ts

@@ -1,6 +1,6 @@
 export type ToolName = 'claude-code' | 'cursor';
 
-export type SessionType = 'session' | 'config' | 'session-env' | 'todos' | 'file-history';
+export type SessionType = 'session' | 'config' | 'session-env' | 'todos' | 'file-history' | 'tasks';
 
 export interface ConfigStats {
   lastCost?: number;

package/src/utils/paths.ts

@@ -112,6 +112,13 @@ export function getClaudeFileHistoryDir(): string {
   return join(homedir(), '.claude', 'file-history');
 }
 
+/**
+ * Claude Code tasks directory path (~/.claude/tasks)
+ */
+export function getClaudeTasksDir(): string {
+  return join(homedir(), '.claude', 'tasks');
+}
+
 /**
  * Replace home directory with ~ for display
  * /Users/user/.ai-session-tidy → ~/.ai-session-tidy

package/README.ko.md

@@ -1,213 +0,0 @@
-<div align="center">
-
-# AI Session Tidy
-
-**AI 코딩 도구의 방치된 세션을 정리합니다**
-
-[![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/)
-[![platform](https://img.shields.io/badge/platform-macOS-blue?style=flat-square)](https://github.com/sooink/ai-session-tidy)
-[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
-
-[English](README.md) · [한국어](README.ko.md)
-
-</div>
-
----
-
-## 문제점
-
-**Claude Code**나 **Cursor** 같은 AI 코딩 도구는 세션 데이터를 로컬에 저장합니다—대화 기록, 파일 스냅샷, Todo 등.
-
-프로젝트를 삭제, 이동, 이름 변경하면 세션 데이터가 방치됩니다:
-
-```
-~/.claude/
-├── projects/
-│   ├── -Users-you-deleted-project/  # 👈 지난주 삭제한 프로젝트
-│   ├── -Users-you-temp-worktree/    # 👈 제거한 worktree
-│   └── -Users-you-renamed-project/  # 👈 이름 바꾼 프로젝트
-├── todos/                           # 방치된 Todo 파일
-└── file-history/                    # 방치된 Rewind 스냅샷
-```
-
-특히 **git worktree 워크플로우**에서 이 문제가 심각해집니다. 브랜치가 자주 생성되고 삭제되면서 세션 데이터가 빠르게 쌓이기 때문입니다.
-
-Claude Code는 30일 후 오래된 세션을 삭제하지만, **Cursor는 자동 정리 기능이 없습니다.** Claude Code도 30일간은 방치된 데이터가 남아있습니다. worktree를 삭제할 때마다 수동으로 정리하는 건 번거롭습니다.
-
-**이 도구는 방치된 세션을 자동으로 감지하고 정리합니다.**
-`watch start`를 한 번만 실행하면 백그라운드에서 프로젝트 삭제를 감시하고 자동으로 정리합니다.
-
-## 빠른 시작
-
-```bash
-npm install -g @sooink/ai-session-tidy
-
-# 자동 정리 (권장)
-ai-session-tidy watch start
-
-# 수동 정리
-ai-session-tidy              # 방치된 세션 스캔
-ai-session-tidy clean        # 휴지통으로 이동
-```
-
-![Demo](https://raw.githubusercontent.com/sooink/ai-session-tidy/main/assets/demo.gif)
-
-## 활용 사례
-
-### Git Worktree 워크플로우
-
-[Git worktree](https://git-scm.com/docs/git-worktree)로 여러 브랜치에서 동시에 작업할 수 있습니다. 하지만 worktree를 제거해도 세션 데이터는 남습니다.
-
-```bash
-git worktree add ../feature-branch feature
-cd ../feature-branch && claude  # 세션 데이터 생성
-
-git worktree remove ../feature-branch
-# ~/.claude/projects/-...-feature-branch/ 가 그대로 남음
-```
-
-**watch 모드를 사용하면** 자동으로 정리됩니다:
-
-```bash
-ai-session-tidy watch start     # 한 번 실행, 로그인 시 자동 시작
-
-git worktree remove ../feature  # watch가 감지 → 5분 후 정리
-```
-
-### 멀티 에이전트 오케스트레이션
-
-[최신 AI 워크플로우](https://www.anthropic.com/engineering/multi-agent-research-system)는 여러 에이전트를 병렬로 실행하며, 각각 격리된 worktree에서 작업합니다.
-
-이로 인해 세션 데이터 축적이 배가됩니다. watch 모드가 시스템을 자동으로 깔끔하게 유지합니다.
-
-## 지원 도구
-
-| 도구 | 상태 |
-|-----|------|
-| Claude Code | ✅ 지원 |
-| Cursor | ✅ 지원 |
-
-## 명령어
-
-### `scan` (기본)
-
-삭제 없이 방치된 세션을 찾습니다. `ai-session-tidy`만 실행하면 `ai-session-tidy scan`과 동일합니다.
-
-```bash
-ai-session-tidy              # 기본 스캔
-ai-session-tidy -v           # 상세 출력
-ai-session-tidy --json       # JSON 출력
-```
-
-<details>
-<summary><code>-v</code> 출력 예시</summary>
-
-```
-⚠ 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      │
-└─────────────┴──────────┴────────┴─────┴───────┴─────────┴──────────┴───────────┘
-
-Session Folders:
-
-  [claude-code] deleted-project (128.5 MB)
-    → /Users/you/deleted-project
-    Modified: 1/15/2025
-
-  [claude-code] old-worktree (27.7 MB)
-    → /Users/you/old-worktree
-    Modified: 1/10/2025
-
-Config Entries (~/.claude.json):
-
-  [config] deleted-project
-    → /Users/you/deleted-project
-    Cost: $1.25 | Tokens: 150K in / 12K out
-```
-
-</details>
-
-### `clean`
-
-방치된 세션을 삭제합니다.
-
-```bash
-ai-session-tidy clean        # 휴지통으로 이동 (확인 필요)
-ai-session-tidy clean -i     # 대화형 선택 (TTY 필요)
-ai-session-tidy clean -f     # 확인 생략 (스크립트/CI용)
-ai-session-tidy clean -n     # 드라이런 (삭제 대상만 표시)
-```
-
-![Interactive Clean](https://raw.githubusercontent.com/sooink/ai-session-tidy/main/assets/demo-interactive.gif)
-
-### `watch`
-
-감시하고 자동으로 정리합니다.
-
-```bash
-ai-session-tidy watch            # 포그라운드 모드
-ai-session-tidy watch start      # 백그라운드 데몬 (로그인 시 자동 시작)
-ai-session-tidy watch stop       # 데몬 중지
-ai-session-tidy watch status     # 상태 확인
-ai-session-tidy watch status -l  # 최근 로그 표시
-```
-
-### `config`
-
-설정을 관리합니다.
-
-```bash
-ai-session-tidy config show                   # 전체 설정 보기
-ai-session-tidy config path add ~/projects    # 감시 경로 추가
-ai-session-tidy config path list              # 감시 경로 목록
-ai-session-tidy config ignore add ~/backup    # 제외 경로 추가
-ai-session-tidy config ignore list            # 제외 경로 목록
-ai-session-tidy config delay 1                # 정리 딜레이 설정 (분)
-ai-session-tidy config depth 5                # 감시 깊이 설정
-ai-session-tidy config reset                  # 기본값으로 초기화
-```
-
-> [!TIP]
-> 숨김 폴더 (`.git`, `.cache` 등)와 macOS 시스템 폴더 (`Library`, `Music` 등)는 자동으로 제외됩니다.
-
-## 정리 대상
-
-### Claude Code
-
-| 위치 | 설명 | 조건 |
-|-----|------|-----|
-| `~/.claude/projects/{path}/` | 세션 폴더 | 프로젝트 삭제됨 |
-| `~/.claude.json` | Config 항목 | 프로젝트 삭제됨 |
-| `~/.claude/session-env/{uuid}/` | 세션 환경 | 빈 폴더 |
-| `~/.claude/todos/{uuid}-*.json` | Todo 파일 | 세션 없음 |
-| `~/.claude/file-history/{uuid}/` | Rewind 스냅샷 | 세션 없음 |
-
-### Cursor
-
-| 위치 | 설명 | 조건 |
-|-----|------|-----|
-| `~/Library/.../workspaceStorage/{hash}/` | 워크스페이스 데이터 | 프로젝트 삭제됨 |
-
-## 안전장치
-
-> [!NOTE]
-> 모든 작업은 기본적으로 안전합니다—명시적 조치 없이는 영구 삭제되지 않습니다.
-
-- **스캔은 읽기 전용** — `scan`은 아무것도 삭제하지 않음
-- **휴지통 우선** — `clean`은 휴지통으로 이동 (복구 가능)
-- **확인 필요** — `-f` 없이는 삭제 전 확인
-- **5분 딜레이** — watch 모드는 정리 전 대기 (설정 가능)
-
-## 개발
-
-```bash
-git clone https://github.com/sooink/ai-session-tidy.git
-cd ai-session-tidy
-pnpm install
-pnpm build
-pnpm test
-```