claude-sessions-dash 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Valerii Kovalskii
+
+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

@@ -0,0 +1,62 @@
+# claude-sessions-dash
+
+Termius-style browser dashboard for your Claude Code (and Codex) sessions.
+
+![Dashboard](https://img.shields.io/badge/UI-Dark%20Theme-1a1d23?style=flat-square) ![Node](https://img.shields.io/badge/node-%3E%3D16-green?style=flat-square) ![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)
+
+## Quick Start
+
+```bash
+npx claude-sessions-dash
+```
+
+Opens `http://localhost:3847` with your sessions dashboard.
+
+Custom port:
+
+```bash
+npx claude-sessions-dash 4000
+```
+
+## Features
+
+**Sessions**
+- View all Claude Code and Codex sessions in a card grid
+- Group by project, view as timeline, or filter by tool
+- Full-text search across session names and projects
+- Preview conversation history in a side panel
+
+**Launch**
+- Resume any session directly in your terminal (iTerm2, Terminal.app, Warp, Kitty, Alacritty)
+- One-click launch with `--dangerously-skip-permissions` option
+- Auto `cd` into the correct project directory
+- Copy resume command to clipboard
+- Terminal preference saved between sessions
+
+**Manage**
+- Delete sessions (file + history + env cleanup)
+- Confirmation dialog to prevent accidents
+- Refresh data without restarting
+
+**Keyboard Shortcuts**
+- `/` — Focus search
+- `Escape` — Close panels
+
+## How It Works
+
+Reads session data from `~/.claude/`:
+- `history.jsonl` — session index with timestamps and projects
+- `projects/*/\<session-id\>.jsonl` — full conversation data
+- `session-env/` — session environment files
+
+Zero dependencies. Single Node.js file. Everything runs on `localhost`.
+
+## Requirements
+
+- Node.js >= 16
+- Claude Code installed (`~/.claude/` directory exists)
+- macOS / Linux / Windows
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+
+const { loadSessions } = require('../src/data');
+const { startServer } = require('../src/server');
+
+const DEFAULT_PORT = 3847;
+const args = process.argv.slice(2);
+const command = args[0] || 'help';
+
+switch (command) {
+  case 'run':
+  case 'start': {
+    const portArg = args.find(a => a.startsWith('--port='));
+    const port = portArg ? parseInt(portArg.split('=')[1]) : (parseInt(args[1]) || DEFAULT_PORT);
+    const noBrowser = args.includes('--no-browser');
+    startServer(port, !noBrowser);
+    break;
+  }
+
+  case 'list':
+  case 'ls': {
+    const sessions = loadSessions();
+    const limit = parseInt(args[1]) || 20;
+    console.log(`\n  \x1b[36m\x1b[1m${sessions.length} sessions\x1b[0m across ${new Set(sessions.map(s => s.project)).size} projects\n`);
+    for (const s of sessions.slice(0, limit)) {
+      const tool = s.tool === 'codex' ? '\x1b[36mcodex\x1b[0m' : '\x1b[34mclaude\x1b[0m';
+      const msg = (s.first_message || '').slice(0, 50).padEnd(50);
+      const proj = s.project_short || '';
+      console.log(`  ${tool}  ${s.id.slice(0, 12)}  ${s.last_time}  ${msg}  \x1b[2m${proj}\x1b[0m`);
+    }
+    if (sessions.length > limit) console.log(`\n  \x1b[2m... and ${sessions.length - limit} more (codedash list ${limit + 20})\x1b[0m`);
+    console.log('');
+    break;
+  }
+
+  case 'stats': {
+    const sessions = loadSessions();
+    const projects = {};
+    for (const s of sessions) {
+      const p = s.project_short || 'unknown';
+      if (!projects[p]) projects[p] = { count: 0, messages: 0 };
+      projects[p].count++;
+      projects[p].messages += s.messages;
+    }
+    console.log(`\n  \x1b[36m\x1b[1mSession Stats\x1b[0m\n`);
+    console.log(`  Total sessions:  ${sessions.length}`);
+    console.log(`  Total projects:  ${Object.keys(projects).length}`);
+    console.log(`  Claude sessions: ${sessions.filter(s => s.tool === 'claude').length}`);
+    console.log(`  Codex sessions:  ${sessions.filter(s => s.tool === 'codex').length}`);
+    console.log(`\n  \x1b[1mTop projects:\x1b[0m`);
+    const sorted = Object.entries(projects).sort((a, b) => b[1].count - a[1].count).slice(0, 10);
+    for (const [name, info] of sorted) {
+      console.log(`    ${String(info.count).padStart(3)} sessions  ${name}`);
+    }
+    console.log('');
+    break;
+  }
+
+  case 'version':
+  case '-v':
+  case '--version': {
+    const pkg = require('../package.json');
+    console.log(pkg.version);
+    break;
+  }
+
+  case 'help':
+  case '-h':
+  case '--help':
+  default:
+    console.log(`
+  \x1b[36m\x1b[1mcodedash\x1b[0m — Claude & Codex Sessions Dashboard
+
+  \x1b[1mUsage:\x1b[0m
+    codedash run [port] [--no-browser]   Start the dashboard server
+    codedash list [limit]                List sessions in terminal
+    codedash stats                       Show session statistics
+    codedash help                        Show this help
+    codedash version                     Show version
+
+  \x1b[1mExamples:\x1b[0m
+    codedash run                         Start on port ${DEFAULT_PORT}
+    codedash run --port=4000             Start on port 4000
+    codedash run --no-browser            Start without opening browser
+    codedash list 50                     Show last 50 sessions
+    codedash ls                          Alias for list
+`);
+    if (!['help', '-h', '--help'].includes(command)) {
+      console.log(`  Unknown command: ${command}\n`);
+      process.exit(1);
+    }
+    break;
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "claude-sessions-dash",
+  "version": "1.0.0",
+  "description": "Termius-style browser dashboard for Claude Code sessions. View, search, resume, and delete sessions with a dark-themed UI.",
+  "bin": {
+    "codedash": "./bin/cli.js"
+  },
+  "files": [
+    "bin/"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "codex",
+    "sessions",
+    "dashboard",
+    "terminal",
+    "iterm2",
+    "cli",
+    "devtools"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vakovalskii/claude-sessions-dash.git"
+  },
+  "homepage": "https://github.com/vakovalskii/claude-sessions-dash#readme",
+  "bugs": {
+    "url": "https://github.com/vakovalskii/claude-sessions-dash/issues"
+  },
+  "author": "Valerii Kovalskii",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16"
+  }
+}