@sooink/ai-session-tidy 0.1.2 → 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,24 +26,31 @@ 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
 ```
 
-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 +91,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 +99,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 │ Tasks │ 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`
 
@@ -146,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