claude-code-sessions

Browse, search, rename, split, and clean up Claude Code sessions — via MCP server, Web UI, or VSCode extension.

Note: This is a community project and is not affiliated with or endorsed by Anthropic.

Packages

Package	Version	Description
@claude-sessions/core		Core library
@claude-sessions/web		Web UI
claude-sessions-mcp		MCP server
claude-sessions		VSCode extension

Installation

Stable (@latest)

# MCP Server
claude mcp add claude-sessions -- npx claude-sessions-mcp

# Web UI
npx @claude-sessions/web

Or add MCP server directly to ~/.claude.json:

{
  "mcpServers": {
    "claude-sessions": {
      "command": "npx",
      "args": ["claude-sessions-mcp"]
    }
  }
}

Beta (@beta)

# MCP Server
claude mcp add claude-sessions -- npx claude-sessions-mcp@beta

# Web UI
npx @claude-sessions/web@beta

Or add MCP server directly to ~/.claude.json:

{
  "mcpServers": {
    "claude-sessions": {
      "command": "npx",
      "args": ["claude-sessions-mcp@beta"]
    }
  }
}

Development

# Install dependencies
corepack enable
pnpm install

# Dev server
pnpm dev           # Web UI
pnpm dev:mcp       # MCP server

# Build
pnpm build         # All packages
pnpm build:core    # core only
pnpm build:mcp     # mcp only
pnpm build:web     # web only

Features

Project Listing

Browse Claude Code project folders with expandable tree view, sorted by summary time or name.

Session Management

List, rename, delete, and split sessions. Hover to see session details with tooltip.

Message Viewer

View messages with tab interface. Inspect user/assistant turns, tool calls, and thinking blocks.

Search

Search sessions by title across all projects.

Cleanup

Remove empty sessions, orphan agents, and orphan todos with preview before execution.

VSCode Extension

Web UI

MCP Tools

Tech Stack

• Core: TypeScript + Effect-TS
• MCP Server: @modelcontextprotocol/sdk
• Web UI: SvelteKit + Svelte 5 + TailwindCSS
• Build: tsup + Vite
• Package Manager: pnpm (monorepo)

License

MIT