Chatcrystal
Description
<div align="center"> <img src="electron/icon.png" alt="ChatCrystal" width="120" /> # ChatCrystal **Turn your AI conversations into searchable knowledge** [](https://github.com/Zeng…
About
<div align="center"> <img src="electron/icon.png" alt="ChatCrystal" width="120" /> # ChatCrystal **Turn your AI conversations into searchable knowledge** [](https://github.com/ZengLiangYi/ChatCrystal/releases)…
Details
- Author
- ZengLiangYi
- Downloads
- 477
- Categories
- Other
Jump to
- Imports AI coding conversations from local tool data directories.
- Distills conversations into structured notes with titles, summaries, and tags.
- Searches knowledge semantically with embeddings and relation-aware results.
- Builds a knowledge graph across related notes and decisions.
- Exposes both CLI and MCP tools for agent recall and write-back.
- Runs locally with configurable LLM and embedding providers.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
ChatcrystalCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the Windows desktop app from GitHub Releases, or run npm install -g chatcrystal and use crystal serve -d plus crystal import to start a CLI/Web server at http://localhost:3721. For a Docker cloud deployment, clone the repo and run docker compose up -d. Configure an LLM provider and an embedding provider in Settings, then import conversations from supported tools.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"chatcrystal": {
"chatcrystal": {
"command": "crystal",
"args": [
"mcp"
]
}
}
}
}McpServers
{
"chatcrystal": {
"command": "crystal",
"args": [
"mcp"
]
}
}ChatCrystal
Turn your AI conversations into searchable knowledge
English | 简体中文
</div>
---
<div align="center">
</div>
<br>
ChatCrystal collects conversations from AI coding tools, distills them into structured notes with LLMs, and builds a local searchable knowledge base from your real problem-solving history.
Supported sources: Claude Code, Cursor, Codex CLI, Trae, and GitHub Copilot.
Quick Start
Desktop App (Recommended)
Download the latest Windows installer from GitHub Releases. After installing, launch ChatCrystal, configure your LLM and embedding providers in Settings, then click Import.
CLI / Web
npm install -g chatcrystal
crystal serve -d
crystal import
Then open http://localhost:3721 in your browser.
Docker Cloud
The default Compose deployment runs only the ChatCrystal service. It stores data in the chatcrystal-data volume mounted at /data inside the container.
git clone https://github.com/ZengLiangYi/ChatCrystal.git
cd ChatCrystal
docker compose up -d
The default docker-compose.yml pulls ghcr.io/zengliangyi/chatcrystal:latest from GitHub Container Registry. Set CHATCRYSTAL_IMAGE_TAG to pin a published version. To build from source instead, run docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build.
To update an existing Docker deployment, run docker compose pull && docker compose up -d. Maintainers only: after the first GHCR publish, make the ghcr.io/zengliangyi/chatcrystal package public in GitHub Packages; the release workflow verifies anonymous pull access before passing.
Compose binds ChatCrystal to 127.0.0.1:3721 by default. Set CHATCRYSTAL_HOST_PORT to change the host port. For public cloud access, an HTTPS reverse proxy is recommended for safer token transport.
On first start without CHATCRYSTAL_API_TOKEN, open the Web UI and enter the setup code printed in container logs or stored at /data/setup-code, then choose one shared API token for your devices.
To rotate or reset the Docker cloud token:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
