sessioner 0.1.5 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Weslley Araújo (@wellwelwel)
+
+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.md

@@ -2,19 +2,17 @@
 
 # Sessioner
 
-✨ An interactive CLI to navigate and manage [**Claude Code**](https://docs.anthropic.com/en/docs/claude-code) sessions from the terminal.
+✨ An interactive **CLI** to navigate and manage [**Claude Code**](https://docs.anthropic.com/en/docs/claude-code) sessions from the terminal.
 
 [![NPM Version](https://img.shields.io/npm/v/sessioner.svg?label=&color=70a1ff&logo=npm&logoColor=white)](https://www.npmjs.com/package/sessioner)
 
 </div>
 
-> 🚧 Work in Progress
-
 ---
 
 ## 💡 Why
 
-Claude Code supports native forking from specific points, but loses context like thoughts, references, choices, and subagents. It also provides no built-in way to search, browse, merge, prune, or trim the `.jsonl` session files stored in `~/.claude/projects`.
+Claude Code supports native forking from specific points, but can loses context like thoughts, references, choices, and subagents. It also provides no built-in way to search, browse, merge, prune, or trim sessions.
 
 **Sessioner** gives you a keyboard-driven interface to manage those sessions directly, including a **full fork** that preserves subagents and all session data:
 
@@ -66,29 +64,20 @@ sessioner
 
 ## 🛠️ Actions
 
-### Open
-
-- Reveals the `.jsonl` file in your native file explorer
-- macOS (Finder), Windows (Explorer), and Linux (xdg-open)
+> [!NOTE]
+>
+> Actions that modify session files (fork, merge, prune, trim, rename, delete, clean) require restarting the Claude Code extension to take effect.
+>
+> - In **VS Code**, you can use the **Reload Window** command (<kbd>Ctrl+Shift+P</kbd> / <kbd>Cmd+Shift+P</kbd> → `Developer: Reload Window`).
 
----
+### ◌ Open
 
-### Stats
-
-- **Session stats** (from the action menu): statistics for a single session
-- **Project stats** (from the main menu): aggregated statistics across all sessions
-- Both display:
-  - Duration (time between first and last message)
-  - Message counts (user vs assistant)
-  - Token usage (input, output, cache creation, cache read)
-  - Cost breakdown by model
-  - Tool usage frequency
-  - Subagent count
-- Project stats also shows the total session count
+- Reveals the `.jsonl` session file in your native file explorer
+- **macOS** (`Finder`), **Windows** (`Explorer`), and **Linux** (`xdg-open`)
 
 ---
 
-### Search (across all sessions)
+### ◌ Search _(across all sessions)_
 
 - Text input for a search query
 - Streams all sessions in parallel for case-insensitive text matching
@@ -101,7 +90,7 @@ sessioner
 
 ---
 
-### Fork
+### ◌ Fork
 
 - Creates an independent copy of the entire session
 - All UUIDs (messages and subagents) are remapped to new random values
@@ -110,7 +99,7 @@ sessioner
 
 ---
 
-### Merge
+### ◌ Merge
 
 - Combines multiple sessions into a single new one
 - Multi-select UI with checkboxes for choosing which sessions to include
@@ -121,7 +110,7 @@ sessioner
 
 ---
 
-### Prune
+### ◌ Prune
 
 - Analyzes the session and reports what can be removed:
   - **Tool blocks**: `tool_use` and `tool_result` entries
@@ -135,101 +124,61 @@ sessioner
 
 ---
 
-### Trim
+### ◌ Trim
 
 - Lists all messages in reverse order (newest first)
 - Each line shows `[ YOU ]` or `[ LLM ]` followed by the message text
 - Select the last message you want to keep
 - Everything after the selected point is removed
-- Confirmation prompt before applying
 
 ---
 
-### Rename
+### ◌ Stats
+
+> 🚧 **WIP**
+
+- **Session stats** (from the action menu): statistics for a single session
+- **Project stats** (from the main menu): aggregated statistics across all sessions
+- Both display:
+  - Duration (time between first and last message)
+  - Message counts (user vs assistant)
+  - Token usage (input, output, cache creation, cache read)
+  - Cost breakdown by model
+  - Tool usage frequency
+  - Subagent count
+- Project stats also shows the total session count
+
+---
+
+### ◌ Rename
 
 - Text input for the new title (<kbd>Esc</kbd> to cancel)
 - Writes a `custom-title` entry to the session file (same format used by the Claude Code extension)
 
 ---
 
-### Delete
+### ◌ Delete
 
 - Shows exactly what will be deleted:
   - Session `.jsonl` file
   - Subagents directory (with file count)
 - Removes the entry from the sessions index
-- Confirmation prompt before applying
 
 ---
 
-### Clean (main menu)
+### ◌ Clean _(main menu)_
 
 - Batch-deletes empty session files
 - Only appears when empty files exist
 - Shows the count of empty sessions
-- Confirmation prompt before applying
 
 ---
 
 ## ⌨️ Navigation
 
-### Main Menu
-
 - <kbd>Up</kbd> / <kbd>Down</kbd>: move cursor
 - <kbd>Enter</kbd>: confirm
-- <kbd>1</kbd>–<kbd>N</kbd>: select option by number
 - <kbd>0</kbd>: exit
-
----
-
-### Session List
-
-- <kbd>Up</kbd> / <kbd>Down</kbd>: move cursor
-- <kbd>Enter</kbd>: select session
-- `←` Previous: previous page
-- `→` Next: next page
-- `☰` Back to menu: return to main menu
-- `✕` Exit: exit
-
----
-
-### Action Menu
-
-- <kbd>Up</kbd> / <kbd>Down</kbd>: move cursor
-- <kbd>Enter</kbd>: confirm action
-- <kbd>1</kbd>–<kbd>8</kbd>: select action by number
-- <kbd>9</kbd>: back
-- <kbd>0</kbd>: exit
-
----
-
-### Multi-Select (Merge / Prune)
-
-- <kbd>Enter</kbd>: toggle item (`☑` selected, `☐` unselected)
-- `✓` Confirm: confirm selection
-- `✕` Cancel: cancel
-
----
-
-### Confirmation (Clean / Trim / Delete)
-
-- <kbd>Up</kbd> / <kbd>Down</kbd>: move cursor
-- <kbd>Enter</kbd>: confirm selection
-- <kbd>1</kbd>: yes
-- <kbd>2</kbd>: no
-
----
-
-### Text Input (Rename)
-
-- Type the new title
-- <kbd>Enter</kbd>: confirm
-- <kbd>Esc</kbd>: cancel
-
----
-
-### Global
-
 - <kbd>ESC</kbd>: go back one level at a time until exit
 - <kbd>Ctrl+C</kbd>: exit
 
@@ -240,14 +189,17 @@ sessioner
 ```bash
 git clone https://github.com/wellwelwel/sessioner
 cd sessioner
-npm install
+npm ci
 npm start
 ```
 
-- `npm start`: run the CLI
-- `npm run typecheck`: type-check without emitting
-- `npm run lint`: check formatting
-- `npm run lint:fix`: fix formatting
+### Scripts
+
+- `npm start` _(development)_
+- `npm run typecheck`
+- `npm run lint`
+- `npm run lint:fix`
+- `npm run build`
 
 ---
 

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "sessioner",
-  "version": "0.1.5",
-  "description": "✨ An interactive CLI to navigate and manage Claude Code sessions from the terminal.",
+  "version": "0.2.0",
+  "description": "✨ An interactive CLI to search, fork, merge, prune, trim, and manage Claude Code sessions from the terminal.",
   "type": "module",
   "license": "MIT",
+  "main": "lib/bin/index.js",
   "bin": {
     "sessioner": "lib/bin/index.js"
   },
@@ -23,13 +24,11 @@
     "lib"
   ],
   "scripts": {
-    "build": "rm -rf lib && tsc",
     "start": "tsx src/bin/index.ts",
+    "build": "rm -rf lib && tsc",
     "lint": "prettier --check .",
     "lint:fix": "prettier --write .",
-    "typecheck": "tsc --noEmit",
-    "patch": "npm version patch --no-git-tag-version",
-    "prepublish": "npm run build"
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@clack/core": "^1.0.1",
@@ -61,6 +60,7 @@
     "claude-session-stats",
     "claude-opus",
     "claude-sonnet",
-    "claude-haiku"
+    "claude-haiku",
+    "search"
   ]
 }