ChatLab

Name: ChatLab
Author: ChatLab

by ChatLab

Verified

Local-first chat history analyzer with AI. | 本地优先的 AI 聊天记录分析工具

7,425stars

1,520forks

TypeScript

Added 5/12/2026

Installation

# Add to your Claude Code skills
git clone https://github.com/ChatLab/ChatLab

Getting Started

Guides for using ai agents skills like ChatLab.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/12/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-12T06:37:04.841Z",
  "semgrepRan": false,
  "npmAuditRan": false,
  "pipAuditRan": true
}

Compare with similar skills

See how ChatLab compares with popular alternatives.

ChatLab vs hermes agent

See comparison

README.md

Frequently Asked Questions

What is ChatLab?

ChatLab is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by ChatLab. Local-first chat history analyzer with AI. | 本地优先的 AI 聊天记录分析工具. It has 7,425 GitHub stars.

Is ChatLab safe to use?

Yes. ChatLab passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install ChatLab?

Clone the repository with "git clone https://github.com/ChatLab/ChatLab" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is ChatLab written in?

ChatLab is primarily written in TypeScript. It is open-source under ChatLab on GitHub, so you can review or fork the full source.

Are there alternatives to ChatLab?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh ChatLab against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

266,366

Developers Also Liked

Based on votes and bookmarks from developers who liked this skill

agent-orchestrator

by AgentWrapper

Agent IDE that enables you to manage fleets of coding agents. It comes with an agentic orchestrator that plans tasks, spawns agents, and autonomously handles CI fixes, merge conflicts, and code reviews.

Star-Office-UI agent-orchestrator

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

Your chat history, finally yours.

English | 简体中文

Official Website · Docs · Quick Start · Roadmap · Releases

ChatLab is an open-source desktop app for understanding your social conversations. It combines a flexible SQL engine with AI agents so you can explore patterns, ask better questions, and extract insights from chat data, all on your own machine.

Currently supported: WhatsApp, LINE, QQ, Discord, Instagram, Telegram, iMessage, and Google Chat. Coming next: Messenger and KakaoTalk.

New install? Start here: Getting started

Core Features

🚀 Built for large histories: Stream parsing and multi-worker processing keep imports and analysis responsive, even at million-message scale.
🔒 Private by default: Your chat data and settings stay local. No mandatory cloud upload of raw conversations.
🤖 AI that can actually operate on data: Agent + Function Calling workflows (24+ tools) can search, summarize, and analyze chat records with context.
📊 Insight-rich visual views: See trends, time patterns, interaction frequency, rankings, and more in one place.
🧩 Cross-platform normalization: Different export formats are mapped into a unified model so you can analyze them consistently.

Installation

Desktop App

Download the installer for your OS from the official website or GitHub Releases, then double-click to install.

CLI

Requires Node.js ≥ 20.

npm i chatlab-cli -g

Start ChatLab:

clb web            # Start API + Web UI, auto-open in browser
clb web --no-open  # Start API + Web UI, skip auto-open
clb web --headless # API only, no Web UI (for scripts / AI Agents)

Common options: --port <port> (default 3110), --host <address>, --token <token>.

To run as a persistent background service (auto-start on login + auto-restart on crash):

clb web --daemon   # Install as system service (macOS / Linux)
clb status           # Check service status
clb stop             # Stop and uninstall service

For a full walkthrough, see the Quick Start guide.

Usage Guides

Preview

For more previews, please visit the official website: chatlab.fun

Preview Interface

Architecture Overview

ChatLab is a pnpm monorepo built on Electron + Vue 3 + Nuxt UI + Tailwind CSS. Core business logic lives in shared packages (@openchatlab/core, @openchatlab/node-runtime, @openchatlab/tools), consumed by both the desktop app and the CLI service — so they stay in sync.

Data flows in five stages: format detection → stream parsing → local persistence → SQL + AI query → visualization.

For a deep dive, see the architecture documentation.

Architecture Principles

Local-first by default: Raw chat data, indexes, and settings remain on-device unless you explicitly choose otherwise.
Streaming over buffering: Stream-first parsing and incremental processing keep large imports stable and memory-efficient.
Composable intelligence: AI features are assembled through Agent + Tool Calling, not hard-coded into one model path.
Schema-first evolution: Import, query, analysis, and visualization share a consistent data model that scales with new features.

Local Development

For complete contributor instructions, see the Development Guide.

Requirements

Node.js >= 24 < 25
pnpm >= 11 < 12

Setup

# Install dependencies
pnpm install

# Start dev mode — prompts you to choose which app to launch
pnpm dev

Or launch a specific target directly:

pnpm dev:desktop   # Electron desktop app
pnpm dev:cli-web   # CLI Web frontend + local server
pnpm dev:web-wasm  # Browser-only Web WASM
pnpm dev:serve     # CLI server only
pnpm docs:dev      # Docs site

If Electron encounters exceptions during startup, you can try using electron-fix:

npm install electron-fix -g
electron-fix start

Privacy Policy & User Agreement

Before using this software, please read the Privacy Policy & User Agreement.

Community

Please follow these principles before submitting a Pull Request:

Obvious bug fixes can be submitted directly.
For new features, please submit an Issue for discussion first; PRs submitted without prior discussion will be closed.
Keep one PR focused on one task; if changes are extensive, consider splitting them into multiple independent PRs.
For local setup, repository structure, checks, and AI collaboration notes, see the Development Guide.

Thanks to all contributors:

License

AGPL-3.0 License