@sooink/ai-session-tidy 0.1.1

package/.prettierrc

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 80
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 sooink
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -0,0 +1,171 @@
+<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 스냅샷
+```
+
+Claude Code는 30일 후 오래된 세션을 삭제하지만, **Cursor는 자동 정리 기능이 없습니다.** Claude Code도 30일간은 방치된 데이터가 남아있습니다.
+
+**이 도구는 방치된 세션을 즉시 찾아서 정리합니다.**
+
+## 빠른 시작
+
+```bash
+npm install -g @sooink/ai-session-tidy
+
+ai-session-tidy              # 방치된 세션 스캔
+ai-session-tidy clean        # 휴지통으로 이동
+ai-session-tidy watch start  # 자동 정리 데몬
+```
+
+![Demo](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` (기본)
+
+삭제 없이 방치된 세션을 찾습니다.
+
+```bash
+ai-session-tidy              # 기본 스캔
+ai-session-tidy -v           # 상세 출력
+ai-session-tidy --json       # JSON 출력
+```
+
+### `clean`
+
+방치된 세션을 삭제합니다.
+
+```bash
+ai-session-tidy clean        # 휴지통으로 이동 (확인 필요)
+ai-session-tidy clean -i     # 대화형 선택
+ai-session-tidy clean -f     # 확인 생략
+ai-session-tidy clean -n     # 드라이런 (삭제 대상만 표시)
+```
+
+![Interactive Clean](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 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                 # 기본값으로 초기화
+```
+
+## 정리 대상
+
+### 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
+```

package/README.md

@@ -0,0 +1,169 @@
+<div align="center">
+
+# AI Session Tidy
+
+**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/)
+[![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)
+
+</div>
+
+---
+
+## The Problem
+
+AI coding tools like **Claude Code** and **Cursor** store session data locally—conversation history, file snapshots, todos, and more.
+
+When you delete, move, or rename a project, the session data becomes orphaned:
+
+```
+~/.claude/
+├── projects/
+│   ├── -Users-you-deleted-project/  # 👈 Project deleted last week
+│   ├── -Users-you-temp-worktree/    # 👈 Worktree removed
+│   └── -Users-you-renamed-project/  # 👈 Project renamed
+├── todos/                           # Orphaned todo files
+└── 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 tool finds and cleans up orphaned sessions immediately.**
+
+## Quick Start
+
+```bash
+npm install -g @sooink/ai-session-tidy
+
+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)
+
+## Use Cases
+
+### Git Worktree Workflows
+
+[Git worktrees](https://git-scm.com/docs/git-worktree) let you work on multiple branches simultaneously. But when you remove a worktree, session data persists.
+
+```bash
+git worktree add ../feature-branch feature
+cd ../feature-branch && claude  # Session data created
+
+git worktree remove ../feature-branch
+# ~/.claude/projects/-...-feature-branch/ still exists
+```
+
+**With watch mode**, cleanup is automatic:
+
+```bash
+ai-session-tidy watch start     # Run once, auto-starts at login
+
+git worktree remove ../feature  # Watch detects → cleans after 5 min
+```
+
+### Multi-Agent Orchestration
+
+[Modern AI workflows](https://www.anthropic.com/engineering/multi-agent-research-system) run multiple agents in parallel, each in isolated worktrees.
+
+This multiplies session data accumulation. Watch mode keeps your system clean automatically.
+
+## Supported Tools
+
+| Tool | Status |
+|------|--------|
+| Claude Code | ✅ Supported |
+| Cursor | ✅ Supported |
+
+## Commands
+
+### `scan` (default)
+
+Find orphaned sessions without deleting.
+
+```bash
+ai-session-tidy              # Basic scan
+ai-session-tidy -v           # Verbose output
+ai-session-tidy --json       # JSON output
+```
+
+### `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 -n     # Dry-run (show what would be deleted)
+```
+
+![Interactive Clean](assets/demo-interactive.gif)
+
+### `watch`
+
+Monitor and auto-clean.
+
+```bash
+ai-session-tidy watch            # Foreground mode
+ai-session-tidy watch start      # Background daemon (auto-starts at login)
+ai-session-tidy watch stop       # Stop daemon
+ai-session-tidy watch status     # Check status
+ai-session-tidy watch status -l  # Show recent logs
+```
+
+### `config`
+
+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
+```
+
+## What Gets Cleaned
+
+### Claude Code
+
+| Location | Description | Condition |
+|----------|-------------|-----------|
+| `~/.claude/projects/{path}/` | Session folders | Project deleted |
+| `~/.claude.json` | Config entries | Project deleted |
+| `~/.claude/session-env/{uuid}/` | Session environment | Empty folder |
+| `~/.claude/todos/{uuid}-*.json` | Todo files | Session gone |
+| `~/.claude/file-history/{uuid}/` | Rewind snapshots | Session gone |
+
+### Cursor
+
+| Location | Description | Condition |
+|----------|-------------|-----------|
+| `~/Library/.../workspaceStorage/{hash}/` | Workspace data | Project deleted |
+
+## Safety
+
+> [!NOTE]
+> All operations are safe by default—nothing is permanently deleted without explicit action.
+
+- **Scan is read-only** — `scan` never deletes anything
+- **Trash first** — `clean` moves to trash (recoverable)
+- **Confirmation required** — prompts before deletion unless `-f`
+- **5-minute delay** — watch mode waits before cleanup (configurable)
+
+## Development
+
+```bash
+git clone https://github.com/sooink/ai-session-tidy.git
+cd ai-session-tidy
+pnpm install
+pnpm build
+pnpm test
+```

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node