ChatLab

Name: ChatLab
Author: ChatLab

by ChatLab

Verified

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

7,135stars

1,486forks

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
}

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,135 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.

239,056

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.

drawio-skill unstract

AI Agentsai-agentai-agentschat-analyzerchat-historydata-analysisdata-visualization

First-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.

AI Agentsai-agentsanthropic

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

20,863

Shell

AI Agentsaibrainstorming

The agent that grows with you

228,016

44,786

Python

AI Agentsaiai-agent

View details

Compare

everything-claude-code

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.

185,940

28,768

JavaScript

AI Agentsai-agentsanthropic

View details

Compare

cc-switch

by farion1231

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

126,001

8,575

Rust

AI Agentsai-toolsclaude-code

View details

Compare

claude-code

by anthropics

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.

120,031

19,897

Shell

AI Agents

View details

Compare

AI Agentsagent-fleetagent-swarm

awesome-nsfw-ai

by ristponex

🔞 Curated list of uncensored AI models for NSFW content generation — video, image, and text models with API access.

API Integrationadult-aiadult-content

View details

cc-gateway

by motiful

AI API identity gateway — reverse proxy that normalizes device fingerprints and telemetry for privacy-preserving API proxying

2,996

504

TypeScript

API Integrationanthropicapi-gateway

View details

UI-TARS-desktop

by bytedance

The Open-Source Multimodal AI Agent Stack: Connecting Cutting-Edge AI Models and Agent Infra

38,533

3,885

TypeScript

AI Agentsagentagent-tars

View details

autoresearch

by uditgoenka

Claude Autoresearch Skill — Autonomous goal-directed iteration for Claude Code. Inspired by Karpathy's autoresearch. Modify → Verify → Keep/Discard → Repeat forever.

5,807

441

Shell

AI Agentsaiautonomous-agent

View details

ouroboros

by Q00

Agent OS: Stop prompting. Start specifying. A Socratic interview gates the spec on an ambiguity score, then one command drives execution, a 3-stage evaluation gate, and a budgeted evolution loop. MCP server, 13 runtimes: Claude Code, Codex CLI, Gemini CLI, OpenCode, Copilot, Kiro and more.

5,363

538

Python

AI Agentsagent-osagentic-ai

View details

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:

chatlab start            # Start API + Web UI, auto-open in browser
chatlab start --no-open  # Start API + Web UI, skip auto-open
chatlab start --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):

chatlab start --daemon   # Install as system service (macOS / Linux)
chatlab status           # Check service status
chatlab 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 >= 9 < 10

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