CodeSesh

CodeSesh scans your local machine, finds every AI agent session (Claude Code, Cursor, Kimi, Codex, Pi, OpenCode), and surfaces them in a unified, beautiful Web UI.

Quick Start

npx codesesh

Your browser will open at http://localhost:4521 with all your sessions ready to browse. If that default port is busy, CodeSesh automatically tries the next available port.

Features

• Unified Timeline — Browse sessions across all your AI agents in a single, searchable interface
• Structured Global Search — Search titles, messages, tool output, and file paths with filters for agent, project, smart tag, tool, file activity, and cost
• Dashboard & Activity Trends — See totals, daily activity, agent distribution, model usage, token trends, smart tags, bookmarks, and recent sessions
• Project Browse Mode — Open a dedicated projects view with project-level metrics, sessions, and cross-agent drill-down
• Project-Aware Session Tree — Group sessions by repository or project identity across supported agents
• Smart Tags — Automatically label bugfix, refactoring, feature work, testing, docs, planning, git, build/deploy, and exploration sessions
• Bookmarks — Save important sessions and keep them visible from the dashboard
• Full Conversation Replay — Read every message, tool call, and reasoning step exactly as it happened
• File Activity Index — Jump to files that were read, edited, created, deleted, or moved, and search sessions by file activity
• Keyboard Navigation — Move through views, focus search, and open shortcuts without leaving the keyboard
• Agent Resume Commands — Copy worktree-aware resume commands from supported agent session details
• Cost & Token Visibility — See token totals, cache tokens, recorded costs, and model-based cost estimates
• SQLite Cache, Migrations & Search Index — Restore session lists quickly, upgrade local schemas safely, and reuse the same local store for search
• Zero Configuration — Just run it. CodeSesh auto-discovers everything on your filesystem
• 100% Local & Private — Your data stays on your machine. No accounts, no cloud sync, no cloud telemetry
• Live Refresh — Local session changes are picked up automatically while the server is running

Supported Agents

| Agent | Status | | ----------- | ------------ | | Claude Code | ✅ Supported | | Cursor | ✅ Supported | | Kimi | ✅ Supported | | Codex | ✅ Supported | | Pi | ✅ Supported | | OpenCode | ✅ Supported |

Usage

# Start the web UI (default port 4521)
npx codesesh

# Choose a custom starting port
npx codesesh --port 8080

# Only show sessions active in the last 3 days
npx codesesh --days 3

# Jump directly to a session
npx codesesh --session claudecode://3b0e4ead-eba9-43e7-9fac-b30647e189f8

# Filter to sessions from current project
npx codesesh --cwd .

# Only show specific agent
npx codesesh --agent claudecode

# Output JSON instead of starting server
npx codesesh --json

# Show performance trace logs
npx codesesh --trace

CLI Options

| Flag | Alias | Default | Description | | ----------- | ----- | ------- | ----------------------------------------------------------- | | --port | -p | 4521 | HTTP server starting port; falls back to the next available port if busy | | --days | -d | 7 | Only include sessions active in the last N days (0 = all time) | | --cwd | — | — | Filter to sessions from a project directory | | --agent | -a | all | Filter to specific agent(s), comma-separated | | --from | — | — | Sessions active after this date YYYY-MM-DD | | --to | — | — | Sessions active before this date YYYY-MM-DD | | --session | -s | — | Directly open a session (agent://session-id) | | --json | -j | false | Output JSON and exit (no server) | | --no-open | — | false | Don't auto-open the browser | | --trace | — | false | Print performance trace logs | | --cache | — | true | Use cached scan results when available | | --clear-cache | — | false | Clear scan cache before starting | | -v | — | — | Print version number |

Requirements

• Node.js 18+

Links

• GitHub
• Issues

License

MIT