English | 简体中文

Claude Session Manager

A local web app that helps you browse, archive and manage your Claude Code conversation sessions.

If you use Claude Code regularly, your conversations are scattered across projects, keep piling up, and there is no single place to organize them — this tool is for you.

What it does

• Browse everything in one place: View all Claude Code sessions grouped by project, without digging through ~/.claude/projects manually.
• Archive projects: Archive an entire project (moves the session files out of the way) to keep your list clean, and restore it anytime with one click.
• Resume sessions: Resume a session (claude --resume) in a new terminal directly from the UI, or start a new conversation.
• Delete to trash: Deleted sessions go to a trash directory and can be recovered — never permanently destroyed.
• Active-session warnings: When you delete or archive a session that is still running, the UI warns you that the record may reappear.
• Bilingual UI: Chinese / English, dark / light theme.

Who it's for

People who use Claude Code heavily and have too many conversation records to keep organized. The tool only manages records — actual chat still happens in your Claude Code terminal.

How it works

Each Claude Code session is a JSONL file stored under ~/.claude/projects/<project>/. This app scans those files at startup, builds an index, and lets you manage the records through a local web UI.

• Index, trash and archive data live under ~/.agent-chat-hub/
• It only reads and moves Claude's session files; it never modifies Claude itself and does not affect running conversations.

Requirements

• Windows
• Node.js 22.5 or higher
• Claude Code (needed for resume / new session features)

Quick Start

Option 1: Double-click to start

Double-click start.bat. The service starts in the background and opens http://localhost:7860 in your browser automatically.

Option 2: Command line

node server.js

Then open http://localhost:7860 in your browser.

If port 7860 is taken, set a different one via environment variable: set PORT=xxxx && node server.js

Features

• Left sidebar: All Projects / Recent / Archived Projects
• Filter sessions by project, sort by recent activity, created time, or message count
• Archive any project; archived projects can be restored or deleted (to trash)
• Resume or delete any session (to trash)
• Dark / light theme, Chinese / English language

Project Structure

├── server.js           # Backend: HTTP server + API routes + static files
├── start.bat           # Windows launcher (double-click to start)
├── launch.ps1          # Silent background launcher (called by start.bat)
├── package.json        # Project metadata (zero dependencies)
├── API.md              # Backend API contract
├── public/             # Frontend
│   ├── index.html
│   ├── style.css
│   └── app.js
└── lib/                # Backend modules
    ├── config.js       # Path discovery
    ├── claude-parser.js# Parse Claude session JSONL
    ├── db.js           # SQLite storage
    ├── indexer.js      # Scan & index sessions
    ├── actions.js      # New / resume / delete actions
    └── archive.js      # Project archive / restore

License

MIT