Which Claude Code versions are supported?

Claudex supports all versions including V1.x, V2-mixed, and V2.0+ with automatic template detection.

How does Claudex manage persistent memory?

It provides structured memory storage with priority levels, confidence scores, and TTL-based expiration.

Can I customize the UI appearance?

Yes, the web UI offers 10 professional themes, 29 font families, and granular font sizing options.

How do I set up Claudex as an MCP server?

Use the one-command setup: `claude mcp add --transport stdio claudex -- claudex-mcp`.

Claudex

claude-codememoryfull-text-searchsqliteanalytics

Persistent memory and full-text search MCP server for Claude Code conversation histories with web UI and analytics.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "kunwar-shah-claudex": {
      "command": "npx",
      "args": [
        "-y",
        "@kunwarshah/claudex"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

This MCP server indexes Claude Code conversation JSONL files from ~/.claude/projects into a SQLite database with FTS5 full-text search. It provides 10 MCP tools for memory management, session search, and retrieval, plus prompts for quick context access. The server includes a React-based web UI for browsing, searching, theming, and exporting conversations. Use it to give Claude Code persistent structured memory, analyze conversation data, and manage coding knowledge across sessions.

Use cases

Store and recall coding knowledge with priority and TTL

Search conversation histories by project, session, role, and date

Analyze session statistics and message distributions

Export conversations in JSON, HTML, or plain text formats

Browse and customize conversation views with themes and fonts

Key features

Persistent structured memory with CRUD and TTL

SQLite FTS5 full-text search with advanced filters

Universal support for all Claude Code template versions

Smart rendering of code, markdown, diffs, and JSON

Session analytics dashboard with charts and stats

Web UI with 10 themes, 29 fonts, and export options

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Claudex.

Extracted Tool Capabilities

Persistent structured memory with CRUD and TTL

SQLite FTS5 full-text search with advanced filters

Universal support for all Claude Code template versions

Smart rendering of code, markdown, diffs, and JSON

Session analytics dashboard with charts and stats

Web UI with 10 themes, 29 fonts, and export options

Documentation Overview

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 | 💬 Discussions | 🐛 Issues

Claudex — browse, search, and give Claude Code persistent memory. SQLite FTS5 full-text search across all sessions, MCP server with 10 tools, universal V1/V2/V3 template support.

🆕 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)

bash

# 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):

Terminal

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 <port>: Custom server port (default: 3400)
--project-root <path>: Custom Claude projects directory

Environment Variables:

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

Option 2: From Source

Clone the repository:

bash

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

Run system check (optional but recommended):

Terminal

npm run check

This validates your environment and catches common setup issues.

Install dependencies (or use auto-fix):

bash

# 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

Configure environment (if not using auto-fix):

bash

cd server
cp .env.example .env
# Edit .env if needed (default: PROJECT_ROOT=~/.claude/projects)
cd ..

Start the application:

bash

# Automatically runs system check, then starts servers
npm run dev

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:

bash

# 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:

bash

./install.sh

# Then run from anywhere:
claudex

🔧 Configuration

Server Configuration (`.env`)

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

384

Package downloads in the last 30 days.

Last commit

2mo ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Claudex

It indexes JSONL conversation files stored in ~/.claude/projects across multiple projects.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/kunwar-shah-claudex?style=directory)](https://allmcps.com/mcp/kunwar-shah-claudex)

HTML Embed

<a href="https://allmcps.com/mcp/kunwar-shah-claudex"><img src="https://allmcps.com/api/badge/kunwar-shah-claudex?style=directory" alt="Claudex on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

PricingFree

11/11 checks healthy over the last 33d

60Quality signal: Good · 60/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools26/30

Adoption & activity9/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 27d ago via OSV.dev · @kunwarshah/claudex (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory →Best MCP servers for Memory & Knowledge →Alternatives to Claudex →Install in Claude Desktop Install in Cursor Install in VS Code

Claudex

claude-codememoryfull-text-searchsqliteanalytics

Persistent memory and full-text search MCP server for Claude Code conversation histories with web UI and analytics.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "kunwar-shah-claudex": {
      "command": "npx",
      "args": [
        "-y",
        "@kunwarshah/claudex"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Use cases

Store and recall coding knowledge with priority and TTL

Search conversation histories by project, session, role, and date

Analyze session statistics and message distributions

Export conversations in JSON, HTML, or plain text formats

Browse and customize conversation views with themes and fonts

Key features

Persistent structured memory with CRUD and TTL

SQLite FTS5 full-text search with advanced filters

Universal support for all Claude Code template versions

Smart rendering of code, markdown, diffs, and JSON

Session analytics dashboard with charts and stats

Web UI with 10 themes, 29 fonts, and export options

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Claudex.

Extracted Tool Capabilities

Persistent structured memory with CRUD and TTL

SQLite FTS5 full-text search with advanced filters

Universal support for all Claude Code template versions

Smart rendering of code, markdown, diffs, and JSON

Session analytics dashboard with charts and stats

Web UI with 10 themes, 29 fonts, and export options

Documentation Overview

Claudex

Professional conversation viewer and analysis tool for Claude Code

Category: Development Tools · Conversation Analysis · Usage Monitoring

📚 Documentation | 💬 Discussions | 🐛 Issues

Claudex — browse, search, and give Claude Code persistent memory. SQLite FTS5 full-text search across all sessions, MCP server with 10 tools, universal V1/V2/V3 template support.

🆕 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)

bash

# 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):

Terminal

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 <port>: Custom server port (default: 3400)
--project-root <path>: Custom Claude projects directory

Environment Variables:

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

Option 2: From Source

Clone the repository:

bash

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

Run system check (optional but recommended):

Terminal

npm run check

This validates your environment and catches common setup issues.

Install dependencies (or use auto-fix):

bash

# 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

Configure environment (if not using auto-fix):

bash

cd server
cp .env.example .env
# Edit .env if needed (default: PROJECT_ROOT=~/.claude/projects)
cd ..

Start the application:

bash

# Automatically runs system check, then starts servers
npm run dev

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:

bash

# 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:

bash

./install.sh

# Then run from anywhere:
claudex

🔧 Configuration

Server Configuration (`.env`)

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

384

Package downloads in the last 30 days.

Last commit

2mo ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Claudex

It indexes JSONL conversation files stored in ~/.claude/projects across multiple projects.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/kunwar-shah-claudex?style=directory)](https://allmcps.com/mcp/kunwar-shah-claudex)

HTML Embed

<a href="https://allmcps.com/mcp/kunwar-shah-claudex"><img src="https://allmcps.com/api/badge/kunwar-shah-claudex?style=directory" alt="Claudex on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

PricingFree

11/11 checks healthy over the last 33d

60Quality signal: Good · 60/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools26/30

Adoption & activity9/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 27d ago via OSV.dev · @kunwarshah/claudex (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory →Best MCP servers for Memory & Knowledge →Alternatives to Claudex →Install in Claude Desktop Install in Cursor Install in VS Code

Claudex

Quick Install

Client Config & Setup

Overview

Use cases

Key features

Capabilities & Tool Schemas

Documentation Overview

Claudex

🆕 What's New

Version 1.3.0 (February 12, 2026) — MCP Server

Version 1.2.0 (November 11, 2025)

Version 1.1.0 (October 27, 2025)

📸 Screenshots

🎨 NEW in v1.2.0: Theming & Customization

Conversation View

Full-Text Search

✨ Features

💖 Support This Project

🚀 Quick Start

Prerequisites

Installation

Option 1: npm (Recommended)

Option 2: From Source

System Checker

Global CLI Installation (Optional)

🔧 Configuration

Server Configuration (.env)

Default Ports

Related MCP Servers

Adoption & maintenance

Reviews

Frequently Asked Questions about Claudex

AllMCPs Directory Badge

Technical Specs & Signals

Supply-chain signal

Moxie Docs MCP

Own this project?

Share & Embed

Explore more

Claudex

Quick Install

Client Config & Setup

Overview

Use cases

Key features

Capabilities & Tool Schemas

Documentation Overview

Claudex

🆕 What's New

Version 1.3.0 (February 12, 2026) — MCP Server

Version 1.2.0 (November 11, 2025)

Version 1.1.0 (October 27, 2025)

📸 Screenshots

🎨 NEW in v1.2.0: Theming & Customization

Conversation View

Full-Text Search

✨ Features

💖 Support This Project

🚀 Quick Start

Prerequisites

Installation

Option 1: npm (Recommended)

Option 2: From Source

System Checker

Global CLI Installation (Optional)

🔧 Configuration

Server Configuration (.env)

Default Ports

Related MCP Servers

Adoption & maintenance

Reviews

Frequently Asked Questions about Claudex

AllMCPs Directory Badge

Technical Specs & Signals

Supply-chain signal

Moxie Docs MCP

Own this project?

Share & Embed

Explore more

Server Configuration (`.env`)

Server Configuration (`.env`)