@sooink/ai-session-tidy 0.1.1 → 0.1.3

package/README.ko.md

@@ -31,21 +31,27 @@
 └── file-history/                    # 방치된 Rewind 스냅샷
 ```
 
-Claude Code는 30일 후 오래된 세션을 삭제하지만, **Cursor는 자동 정리 기능이 없습니다.** Claude Code도 30일간은 방치된 데이터가 남아있습니다.
+특히 **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        # 휴지통으로 이동
-ai-session-tidy watch start  # 자동 정리 데몬
 ```
 
-![Demo](assets/demo.gif)
+![Demo](https://raw.githubusercontent.com/sooink/ai-session-tidy/main/assets/demo.gif)
 
 ## 활용 사례
 
@@ -86,7 +92,7 @@ git worktree remove ../feature  # watch가 감지 → 5분 후 정리
 
 ### `scan` (기본)
 
-삭제 없이 방치된 세션을 찾습니다.
+삭제 없이 방치된 세션을 찾습니다. `ai-session-tidy`만 실행하면 `ai-session-tidy scan`과 동일합니다.
 
 ```bash
 ai-session-tidy              # 기본 스캔
@@ -94,18 +100,49 @@ 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     # 대화형 선택
-ai-session-tidy clean -f     # 확인 생략
+ai-session-tidy clean -i     # 대화형 선택 (TTY 필요)
+ai-session-tidy clean -f     # 확인 생략 (스크립트/CI용)
 ai-session-tidy clean -n     # 드라이런 (삭제 대상만 표시)
 ```
 
-![Interactive Clean](assets/demo-interactive.gif)
+![Interactive Clean](https://raw.githubusercontent.com/sooink/ai-session-tidy/main/assets/demo-interactive.gif)
 
 ### `watch`
 
@@ -124,14 +161,19 @@ ai-session-tidy watch status -l  # 최근 로그 표시
 설정을 관리합니다.
 
 ```bash
-ai-session-tidy config show                  # 전체 설정 보기
-ai-session-tidy config paths add ~/projects  # 감시 경로 추가
-ai-session-tidy config paths list            # 감시 경로 목록
-ai-session-tidy config delay 1               # 정리 딜레이 설정 (분)
-ai-session-tidy config depth 5               # 감시 깊이 설정
-ai-session-tidy config reset                 # 기본값으로 초기화
+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

package/README.md

@@ -29,21 +29,27 @@ When you delete, move, or rename a project, the session data becomes orphaned:
 └── file-history/                    # Orphaned rewind snapshots
 ```
 
-While Claude Code cleans up old sessions after 30 days, **Cursor has no automatic cleanup**. And even with Claude Code, you're left with orphaned data for up to a month.
+This becomes especially problematic with **git worktree workflows**, where branches are frequently created and removed—each leaving behind session data that accumulates quickly.
 
-**This tool finds and cleans up orphaned sessions immediately.**
+While Claude Code cleans up old sessions after 30 days, **Cursor has no automatic cleanup**. And even with Claude Code, you're left with orphaned data for up to a month. Manually cleaning up after each worktree removal is tedious.
+
+**This tool detects orphaned sessions automatically and cleans them up.**
+Just run `watch start` once—it monitors in the background and cleans up as projects are deleted.
 
 ## Quick Start
 
 ```bash
 npm install -g @sooink/ai-session-tidy
 
+# Automatic cleanup (recommended)
+ai-session-tidy watch start
+
+# Manual cleanup
 ai-session-tidy              # Scan for orphaned sessions
 ai-session-tidy clean        # Move to trash
-ai-session-tidy watch start  # Auto-cleanup daemon
 ```
 
-![Demo](assets/demo.gif)
+![Demo](https://raw.githubusercontent.com/sooink/ai-session-tidy/main/assets/demo.gif)
 
 ## Use Cases
 
@@ -84,7 +90,7 @@ This multiplies session data accumulation. Watch mode keeps your system clean au
 
 ### `scan` (default)
 
-Find orphaned sessions without deleting.
+Find orphaned sessions without deleting. Running `ai-session-tidy` without a command is equivalent to `ai-session-tidy scan`.
 
 ```bash
 ai-session-tidy              # Basic scan
@@ -92,18 +98,49 @@ ai-session-tidy -v           # Verbose output
 ai-session-tidy --json       # JSON output
 ```
 
+<details>
+<summary>Example output with <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`
 
 Remove orphaned sessions.
 
 ```bash
 ai-session-tidy clean        # Move to trash (with confirmation)
-ai-session-tidy clean -i     # Interactive selection
-ai-session-tidy clean -f     # Skip confirmation
+ai-session-tidy clean -i     # Interactive selection (TTY only)
+ai-session-tidy clean -f     # Skip confirmation (required for scripts/CI)
 ai-session-tidy clean -n     # Dry-run (show what would be deleted)
 ```
 
-![Interactive Clean](assets/demo-interactive.gif)
+![Interactive Clean](https://raw.githubusercontent.com/sooink/ai-session-tidy/main/assets/demo-interactive.gif)
 
 ### `watch`
 
@@ -122,14 +159,19 @@ ai-session-tidy watch status -l  # Show recent logs
 Manage settings.
 
 ```bash
-ai-session-tidy config show                  # Show all settings
-ai-session-tidy config paths add ~/projects  # Add watch path
-ai-session-tidy config paths list            # List watch paths
-ai-session-tidy config delay 1               # Set cleanup delay (minutes)
-ai-session-tidy config depth 5               # Set watch depth
-ai-session-tidy config reset                 # Reset to defaults
+ai-session-tidy config show                   # Show all settings
+ai-session-tidy config path add ~/projects    # Add watch path
+ai-session-tidy config path list              # List watch paths
+ai-session-tidy config ignore add ~/backup    # Add ignore path
+ai-session-tidy config ignore list            # List ignore paths
+ai-session-tidy config delay 1                # Set cleanup delay (minutes)
+ai-session-tidy config depth 5                # Set watch depth
+ai-session-tidy config reset                  # Reset to defaults
 ```
 
+> [!TIP]
+> Hidden folders (`.git`, `.cache`, etc.) and macOS system folders (`Library`, `Music`, etc.) are automatically excluded from watching.
+
 ## What Gets Cleaned
 
 ### Claude Code