# đ Chat Vault
**One tool to save ALL your AI chat history**
[](https://python.org)
[](LICENSE)
[]()
[]()
[English](README.md) | [ä¸æ](README_CN.md)
[⨠Features](#-features) âĸ
[đ Quick Start](#-quick-start) âĸ
[đ Commands](#-commands) âĸ
[đ Project Structure](#-project-structure) âĸ
[â FAQ](#-faq)
[đ Contact](#-contact) âĸ
[⨠Support](#-support) âĸ
[đ¤ Contributing](#-contributing)
AI-powered docs: [zread.ai/tukuaiai/chat-vault](https://zread.ai/tukuaiai/chat-vault)
> đĻ This tool is part of [vibe-coding-cn](https://github.com/tukuaiai/vibe-coding-cn) - A comprehensive Vibe Coding guide
---
## ⨠Features
đ Multi-CLI
Codex, Kiro, Gemini, Claude - all supported
⥠Real-time
Watch mode with system-level file monitoring
đĸ Token Stats
Accurate counting using tiktoken (cl100k_base)
đ Search
Find any conversation instantly
đ¤ Export
JSON or CSV, your choice
đ Zero Config
Auto-detects paths, just run it
---
## đī¸ Architecture
```mermaid
graph LR
subgraph Sources
A[~/.codex]
B[~/.kiro]
C[~/.gemini]
D[~/.claude]
end
subgraph Chat Vault
E[Watcher]
F[Parsers]
G[Storage]
end
subgraph Output
H[(SQLite DB)]
end
A --> E
B --> E
C --> E
D --> E
E --> F
F --> G
G --> H
```
---
## đ How It Works
```mermaid
sequenceDiagram
participant User
participant CLI as AI CLI (Codex/Kiro/...)
participant Watcher
participant Parser
participant DB as SQLite
User->>CLI: Chat with AI
CLI->>CLI: Save to local file
Watcher->>Watcher: Detect file change
Watcher->>Parser: Parse new content
Parser->>DB: Upsert session
DB-->>User: Query anytime
```
---
## đ Quick Start
### 30 Seconds Setup
```bash
# Clone
git clone https://github.com/tukuaiai/vibe-coding-cn.git
cd vibe-coding-cn/libs/external/chat-vault
# Run (auto-installs dependencies)
./start.sh # Linux/macOS
start.bat # Windows
```
**That's it!** đ
---
## đ Example Output
```
==================================================
AI čå¤ŠčŽ°åŊ â éä¸åå¨
==================================================
æ°æŽåē: ./output/chat_history.db
[Codex] æ°åĸ:1241 æ´æ°:0 čˇŗčŋ:0 éč¯¯:0
[Kiro] æ°åĸ:21 æ´æ°:0 čˇŗčŋ:0 éč¯¯:0
[Gemini] æ°åĸ:332 æ´æ°:0 čˇŗčŋ:0 éč¯¯:0
[Claude] æ°åĸ:168 æ´æ°:0 čˇŗčŋ:0 éč¯¯:0
==================================================
æģ莥: 1762 äŧč¯, 40000+ æļæ¯
â åæĨåŽæ!
=== Token įģ莥 (tiktoken) ===
codex: 11,659,952 tokens
kiro: 26,337 tokens
gemini: 3,195,821 tokens
claude: 29,725 tokens
æģ莥: 14,911,835 tokens
```
---
## đ Commands
| Command | Description |
|---------|-------------|
| `python src/main.py` | Sync once |
| `python src/main.py -w` | Watch mode (real-time) |
| `python src/main.py --stats` | Show statistics |
| `python src/main.py --search "keyword"` | Search messages |
| `python src/main.py --export json` | Export to JSON |
| `python src/main.py --export csv --source codex` | Export specific source |
| `python src/main.py --prune` | Clean orphaned records |
---
## đ Project Structure
```
chat-vault/
âââ đ start.sh / start.bat # One-click start
âââ đĻ build.py # Build standalone exe
âââ đ src/
â âââ main.py # CLI entry
â âââ config.py # Auto-detection
â âââ storage.py # SQLite + tiktoken
â âââ watcher.py # File monitoring
â âââ parsers/ # CLI parsers
âââ đ docs/
â âââ AI_PROMPT.md # AI assistant guide
â âââ schema.md # Database schema
âââ đ output/
âââ chat_history.db # Your database
âââ logs/ # Sync logs
```
---
## đī¸ Database Schema
```mermaid
erDiagram
sessions {
TEXT file_path PK
TEXT session_id
TEXT source
TEXT cwd
TEXT messages
INTEGER file_mtime
TEXT start_time
INTEGER token_count
}
meta {
TEXT key PK
TEXT value
}
meta_codex {
TEXT key PK
TEXT value
}
```
---
## đ¤ For AI Assistants
Send [docs/AI_PROMPT.md](docs/AI_PROMPT.md) to your AI assistant for:
- SQL query examples
- Python code snippets
- Task guidance
---
## â FAQ
Do I need to configure anything?
No. Auto-detects `~/.codex`, `~/.kiro`, `~/.gemini`, `~/.claude`
Does it work with WSL?
Yes! Paths like `\\wsl.localhost\Ubuntu\...` are supported
How do I view the database?
Use [DB Browser for SQLite](https://sqlitebrowser.org/) or any SQLite tool
Is my data safe?
Yes. We only READ from AI tools, never modify original files
---
## đ Contact
- **GitHub**: [tukuaiai](https://github.com/tukuaiai)
- **Twitter / X**: [123olp](https://x.com/123olp)
- **Telegram**: [@desci0](https://t.me/desci0)
- **Telegram Group**: [glue_coding](https://t.me/glue_coding)
- **Telegram Channel**: [tradecat_ai_channel](https://t.me/tradecat_ai_channel)
- **Email**: tukuai.ai@gmail.com
---
## ⨠Support
If this project helped you, consider supporting:
- **Binance UID**: `572155580`
- **Tron (TRC20)**: `TQtBXCSTwLFHjBqTS4rNUp7ufiGx51BRey`
- **Solana**: `HjYhozVf9AQmfv7yv79xSNs6uaEU5oUk2USasYQfUYau`
- **Ethereum (ERC20)**: `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC`
- **BNB Smart Chain (BEP20)**: `0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC`
- **Bitcoin**: `bc1plslluj3zq3snpnnczplu7ywf37h89dyudqua04pz4txwh8z5z5vsre7nlm`
- **Sui**: `0xb720c98a48c77f2d49d375932b2867e793029e6337f1562522640e4f84203d2e`
---
## đ¤ Contributing
We welcome all contributions! Feel free to open an [Issue](https://github.com/tukuaiai/vibe-coding-cn/issues) or submit a [Pull Request](https://github.com/tukuaiai/vibe-coding-cn/pulls).
---
## đ License
[MIT](LICENSE) - Do whatever you want with it.
---
**If this helped you, give it a â!**
## Star History
---
**Made with â¤ī¸ by [tukuaiai](https://github.com/tukuaiai)**
[âŦ Back to Top](#-chat-vault)