Claudex

Claudex

Professional conversation viewer and analysis tool for Claude Code

Category: Development Tools · Conversation Analysis · Usage Monitoring

Claudex is a full-stack web application designed for developers, QA engineers, and researchers who need to inspect, search, and analyze Claude Code conversation histories. Built with React and Fastify, it provides enterprise-grade full-text search using SQLite FTS5, universal template support for all Claude Code versions, and comprehensive analytics dashboards.

📚 [Documentation](https://kunwar-shah.github.io/claudex/) | 💬 [Discussions](https://github.com/kunwar-shah/claudex/discussions) | 🐛 [Issues](https://github.com/kunwar-shah/claudex/issues)

---

🆕 What's New

Version 1.3.0 (February 12, 2026) — MCP Server

• 🧠 MCP Server: Model Context Protocol server gives Claude Code persistent memory across sessions
• 🔧 10 MCP Tools: Project context, session search, conversation retrieval, structured memory CRUD
• 💾 Structured Memory System: Store coding knowledge (conventions, architecture, decisions, error patterns) with priority, confidence, and TTL
• 📋 3 MCP Prompts: /recall, /catchup, /history for quick access to past sessions
• 🎯 Token Budgeting: Three detail levels (minimal/standard/full) for context management
• 📖 One-Command Setup: claude mcp add --transport stdio claudex -- claudex-mcp

Previous releases

Version 1.2.0 (November 11, 2025)

• 🎨 Comprehensive Theming System: 10 professional themes (default, emerald, green, blue, purple, orange, red, rose, yellow, classic)
• 🔤 Advanced Typography: 29 font families with visual preview
• 📏 Granular Font Sizing: 5 precise font size options (14px-18px)
• 💾 Settings Persistence: All customizations saved to localStorage

Version 1.1.0 (October 27, 2025)

• 🎯 Smart Title Extraction: Meaningful session titles from conversation content
• 📊 Tremor Analytics Dashboard: Tailwind-based charts and multi-scale visualizations
• 🐳 Docker Multi-Platform: amd64 and arm64 with optimized ~200MB images
• ⚡ Performance: 121x faster async search index rebuild

View full changelog | Troubleshooting guide

---

📸 Screenshots

🎨 NEW in v1.2.0: Theming & Customization

10 Professional Themes Classic, Emerald, Blue, Purple, Orange, Red, Rose, Yellow, Green, Default

29 Font Families Visual preview showing actual typefaces

Granular Font Sizing 5 precise options (14px-18px) + border radius control

Settings Modal Appearance functional, more settings coming soon

Conversation View

Full-Text Search

✨ Features

• MCP Server: Give Claude Code persistent memory — conventions, architecture, decisions, and error patterns survive across sessions
• Structured Memory: Store and recall coding knowledge with priority (1-10), confidence, and TTL-based expiration
• Auto Project Discovery: Automatically scans ~/.claude/projects directory to discover all conversations across multiple projects
• Full-Text Search: Enterprise-grade SQLite FTS5 search engine with advanced filtering by project, session, role, date range, and content highlighting
• Universal Template Support: Intelligent template detection and parsing for all Claude Code versions (V1.x, V2-mixed, V2.0+) with automatic format detection
• Smart Content Rendering: Syntax-highlighted code blocks, markdown rendering, diff visualization, JSON formatting, and tool usage tracking
• Session Analytics: Comprehensive analytics dashboard with message distribution charts, file operation tracking, and conversation statistics using Tremor React
• Export Options: Export conversations to JSON (structured data), HTML (readable format), or plain TXT for archival and sharing
• Modern UI: Responsive React interface with 10 themes, 29 fonts, session favorites, and optimized for developer workflows

---

💖 Support This Project

Claudex is free and open source. If it saves you time and improves your workflow, please consider:

• ⭐ Star the repo - Help others discover Claudex
• 🐛 Report bugs - Your feedback makes us better
• 💡 Share ideas - Request features in Discussions
• ☕ Buy me a coffee - Support continued development

Every contribution helps keep this project alive and growing! 🚀

---

🚀 Quick Start

Prerequisites

• Node.js 18+ and npm
• Claude Code installed with conversation history in ~/.claude/projects

Installation

Option 1: npm (Recommended)

# Global installation

npm install -g @kunwarshah/claudex [https://www.npmjs.com/package/@kunwarshah/claudex]

Then run anywhere:

claudex

Custom port (if 3400 is in use):

claudex --port 3500

Custom project directory:

claudex --project-root ~/my-claude-projects

Or use without installing (npx):

npx @kunwarshah/claudex

Add MCP Server (gives Claude Code persistent memory):

claude mcp add --transport stdio claudex -- claudex-mcp

See the MCP Server Guide for details.

CLI Options:

• --help, -h: Show help message
• --version, -v: Show version
• --port, -p : Custom server port (default: 3400)
• --project-root : Custom Claude projects directory

Environment Variables:

• PORT: Server port (default: 3400)
• PROJECT_ROOT: Claude projects directory (default: ~/.claude/projects)

Option 2: From Source

1. Clone the repository:

git clone https://github.com/kunwar-shah/claudex.git

cd claudex

1. Run system check (optional but recommended):

npm run check

This validates your environment and catches common setup issues.

1. Install dependencies (or use auto-fix):

# Option 1: Manual installation

npm install cd server && npm install && cd .. cd client && npm install && cd ..

Option 2: Auto-fix (installs deps + creates .env)

npm run check:fix

1. Configure environment (if not using auto-fix):

cd server

cp .env.example .env

Edit .env if needed (default: PROJECT_ROOT=~/.claude/projects)

cd ..

1. Start the application:

# Automatically runs system check, then starts servers

npm run dev

1. Open your browser: http://localhost:3000

The backend API runs on http://localhost:3400

System Checker

Claudex includes a comprehensive system checker that validates your environment:

# Quick check

npm run check

Detailed output

npm run check:verbose

Auto-fix common issues

npm run check:fix

JSON output (for CI/CD)

npm run check:json

What it checks:

• ✅ Node.js & npm versions
• ✅ PROJECT_ROOT path & permissions
• ✅ Port availability (3000, 3400)
• ✅ Dependencies installation
• ✅ Claude Code data (projects, sessions)
• ✅ JSONL file validity
• ✅ Database permissions
• ✅ Search index status

Global CLI Installation (Optional)

Install globally to use claudex command anywhere:

./install.sh

Then run from anywhere:

claudex

🔧 Configuration

Server Configuration (.env)

# Path to Claude Code projects directory

Supports ~ expansion (e.g., ~/.claude/projects)

PROJECT_ROOT=~/.claude/projects

Server port

PORT=3400

Environment

NODE_ENV=development

Default Ports

• Frontend: http://localhost:3000 (Vite dev server)
• Backend: http://localhost:3400 (Fastify API)
• Frontend build: Uses port 3400 (served by backend in production)

📂 Project Structure

claudex/

├── server/ # Backend (Node.js + Fastify) │ ├── src/ │ │ ├── parsers/ # Template detection & message parsing │ │ │ ├── templateDetector.js # V1/V2/V3 template detection │ │ │ └── messageParser.js # Universal message parser │ │ ├── services/ # Core business logic │ │ │ ├── fileScanner.js # Project/session discovery │ │ │ ├── sessionParser.js # Full session parsing │ │ │ ├── searchDatabase.js # SQLite FTS5 search │ │ │ ├── searchIndexer.js # Search index builder │ │ │ └── memoryService.js # Structured memory CRUD │ │ ├── mcp/ # MCP server (Claude Code integration) │ │ │ ├── index.js # MCP entry point + stdio transport │ │ │ ├── tools.js # 10 MCP tool handlers │ │ │ ├── resources.js # MCP resources │ │ │ └── prompts.js # 3 MCP prompts │ │ ├── routes/ # API endpoints │ │ │ ├── projects.js # Project/session routes │ │ │ ├── search.js # Search routes │ │ │ └── export.js # Export routes │ │ ├── utils/ # Helper utilities │ │ │ └── pathHelper.js # Path expansion (~/ support) │ │ └── server.js # Main server │ ├── data/ # SQLite database (auto-created) │ ├── .env.example # Environment template │ └── package.json ├── client/ # Frontend (React + Vite) │ ├── src/ │ │ ├── components/ # React components │ │ │ ├── ProjectSelector.jsx │ │ │ ├── SessionList.jsx │ │ │ ├── ConversationThread.jsx │ │ │ ├── MessageBubble.jsx │ │ │ ├── ClaudeMessageRenderer.jsx │ │ │ └── SearchPage.jsx │ │ ├── services/ # API client │ │ │ └── api.js │ │ └── App.jsx # Main app │ └── package.j