claude-chats-sync 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 tubo70
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,307 @@
+# claude-chats-sync
+
+[![npm version](https://badge.fury.io/js/claude-chats-sync.svg)](https://www.npmjs.com/package/claude-chats-sync)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node](https://img.shields.io/node/v/claude-chats-sync.svg)](https://nodejs.org)
+
+> Cross-platform CLI tool to sync Claude Code chat sessions to your project directory
+
+[中文文档](README.zh-CN.md) | English
+
+## ✨ Features
+
+- 🔄 **Auto-sync** - Creates symlinks from Claude Code local storage to your project folder
+- 📁 **Project-local history** - Chat sessions stored in your project, not user home directory
+- 🔒 **Sensitive data protection** - Cleans API keys from session files
+- 🎯 **Simple to use** - Initialize sync with a single command
+- 📊 **Status tracking** - Check sync status and session count
+- 🌳 **Git-friendly** - Configure Git filters for safe version control
+- 🔧 **Cross-platform** - Works on Windows, macOS, and Linux
+
+## 📦 Installation
+
+### Install globally (recommended)
+
+```bash
+npm install -g claude-chats-sync
+```
+
+This allows you to use `claude-chats-sync` command from anywhere.
+
+### Install locally
+
+```bash
+npm install -D claude-chats-sync
+```
+
+Then use it via `npx`:
+```bash
+npx claude-chats-sync init
+```
+
+## 🚀 Quick Start
+
+### Initialize sync
+
+```bash
+# In your project directory
+claude-chats-sync init
+```
+
+This will:
+- Create a `.claudeCodeSessions/` folder in your project
+- Create a symlink in `~/.claude/projects/`
+- Configure Git filter for automatic sensitive data cleaning
+- Add `.claudeCodeSessions/` to `.gitignore` (commented by default)
+
+### Check status
+
+```bash
+claude-chats-sync status
+```
+
+### Open history folder
+
+```bash
+claude-chats-sync open
+```
+
+## 📖 Commands
+
+| Command | Description |
+|---------|-------------|
+| `init` | Initialize sync for current project |
+| `status` | Check sync status and session count |
+| `open` | Open history folder in file manager |
+| `clean` | Clean sensitive data from session files |
+| `setup-git-filter` | Setup Git filter for automatic cleaning |
+| `help` | Show help message |
+
+## 🔧 Usage Examples
+
+### Basic usage
+
+```bash
+# Initialize sync
+claude-chats-sync init
+
+# Check status
+claude-chats-sync status
+
+# Open sessions folder
+claude-chats-sync open
+```
+
+### Advanced options
+
+```bash
+# Custom folder name
+claude-chats-sync init --folder-name .sessions
+
+# Force migrate existing sessions
+claude-chats-sync init --force
+
+# Specify project path
+claude-chats-sync init --project-path /path/to/project
+```
+
+### Cleaning sensitive data
+
+```bash
+# Manual cleanup
+claude-chats-sync clean
+
+# Setup Git auto-filter
+claude-chats-sync setup-git-filter
+```
+
+## ⚙️ Environment Variables (Recommended)
+
+Configure API keys via environment variables to prevent them from appearing in session files:
+
+**Linux/macOS** - Add to `~/.bashrc` or `~/.zshrc`:
+```bash
+export ANTHROPIC_AUTH_TOKEN="sk-ant-..."
+export ANTHROPIC_BASE_URL="https://api.example.com"  # Optional: for third-party API
+```
+
+**Windows PowerShell**:
+```powershell
+$env:ANTHROPIC_AUTH_TOKEN="sk-ant-..."
+$env:ANTHROPIC_BASE_URL="https://api.example.com"
+```
+
+**Windows CMD (permanent)**:
+```cmd
+setx ANTHROPIC_AUTH_TOKEN "sk-ant-..."
+setx ANTHROPIC_BASE_URL "https://api.example.com"
+```
+
+## 🔒 Security & Version Control
+
+### ⚠️ Security Warning
+
+Session files may contain sensitive information:
+- API keys and authentication tokens
+- Proprietary code and business logic
+- Private conversations and internal discussions
+- System paths and environment details
+
+While this tool provides API key cleaning, **no automated cleaning is 100% complete**. Only commit these files if you fully understand and accept the security risks.
+
+### Options for securing API keys
+
+**Option 1: Use environment variables (Recommended)**
+
+Configure Claude Code to use API keys from environment variables. This prevents them from appearing in session files entirely.
+
+**Option 2: Use Git filter**
+
+If you store API keys in config files, the Git filter automatically cleans them on commit.
+
+### Git filter usage
+
+After initialization, commit normally:
+
+```bash
+git add .claudeCodeSessions/
+git commit -m "Add conversation history"
+
+# API keys are automatically replaced with [REDACTED]
+# Your local files remain unchanged
+```
+
+### Complete Git ignore (safest)
+
+**RECOMMENDED**: Ignore session files entirely. Uncomment in `.gitignore`:
+
+```gitignore
+.claudeCodeSessions/
+```
+
+This prevents accidentally committing sensitive data to your repository.
+
+## 🌐 How It Works
+
+Claude Code stores chat sessions in `~/.claude/projects/{normalized-project-path}/`.
+
+This CLI creates a symbolic link to a folder in your project (default: `.claudeCodeSessions/`), making the chat history part of your project.
+
+### Example structure
+
+```
+Your Project/
+├── src/
+├── .claudeCodeSessions/      # Chat sessions (synced with ~/.claude)
+│   ├── session-abc123.jsonl
+│   └── session-def456.jsonl
+├── .gitignore               # Auto-updated
+├── .gitattributes           # Git filter configuration
+└── package.json
+```
+
+## 🔄 Syncing Across Machines
+
+If you choose to sync session files:
+
+1. Commit the `.claudeCodeSessions/` folder
+2. Push to GitHub
+3. Pull on another machine
+4. Run `claude-chats-sync init` to create the symlink
+
+## 🔧 Platform-specific Notes
+
+### Windows
+- Uses junction points (no admin privileges required)
+- Supports PowerShell and CMD
+- Run PowerShell scripts may require: `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`
+
+### macOS
+- Requires execute permissions: `chmod +x $(which claude-chats-sync)`
+- Uses standard symbolic links
+
+### Linux
+- Requires execute permissions: `chmod +x $(which claude-chats-sync)`
+- Uses standard symbolic links
+
+## 🐛 Troubleshooting
+
+### Symlink creation fails (Windows)
+
+The tool uses junction points which work without admin privileges. If issues persist:
+- Ensure Node.js is in your PATH
+- Try running as administrator
+- Check that your project path doesn't contain special characters
+
+### History not syncing
+
+1. Check if symlink exists:
+   - Windows: `dir %USERPROFILE%\.claude\projects`
+   - macOS/Linux: `ls -la ~/.claude/projects`
+
+2. Verify symlink points to your project's `.claudeCodeSessions/` folder
+
+### Reinitialize
+
+Delete existing symlink:
+
+```bash
+# Windows
+rmdir "%USERPROFILE%\.claude\projects\{project-name}"
+
+# macOS/Linux
+rm ~/.claude/projects/{project-name}
+```
+
+Then run `claude-chats-sync init` again.
+
+## 📚 Related Projects
+
+- [VSCode Extension](https://marketplace.visualstudio.com/items?itemName=tubo.claude-code-chats-sync) - Full-featured VSCode extension with the same functionality
+
+## 💰 Token Usage & Cost Considerations
+
+> ⚠️ **IMPORTANT**: When sharing session files, each team member uses their own API key and incurs their own API costs.
+
+### Key points
+
+1. **Each member pays for their own usage**
+   - Every team member must configure their own API key
+   - When you continue a shared conversation, **you pay for all new tokens** generated
+   - The original creator's API key is **never** used
+
+2. **Context window considerations**
+   - Long shared conversations consume more tokens as context
+   - A shared conversation with 50,000 tokens will consume ~50,000 input tokens each time a new member continues it
+
+3. **Cost-saving best practices**
+   - Generate conversation summaries before sharing
+   - Start new conversations when possible
+   - Archive old sessions
+   - Monitor your API usage
+
+For detailed cost considerations, see [Token Usage Guide](TOKEN_USAGE.md).
+
+## 📝 License
+
+MIT - see [LICENSE](LICENSE) file for details
+
+## 🤝 Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## 📞 Support
+
+- 📧 [Issues](https://github.com/tubo70/claude-chats-sync/issues)
+- 📖 [Documentation](https://github.com/tubo70/claude-chats-sync/wiki)
+- 💬 [Discussions](https://github.com/tubo70/claude-chats-sync/discussions)
+
+## 🔗 Links
+
+- [npm](https://www.npmjs.com/package/claude-chats-sync)
+- [GitHub](https://github.com/tubo70/claude-chats-sync)
+- [VSCode Marketplace](https://marketplace.visualstudio.com/items?itemName=tubo.claude-code-chats-sync)
+
+---
+
+Made with ❤️ by [tubo70](https://github.com/tubo70)

package/README.zh-CN.md

@@ -0,0 +1,305 @@
+# claude-chats-sync
+
+[![npm version](https://badge.fury.io/js/claude-chats-sync.svg)](https://www.npmjs.com/package/claude-chats-sync)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node](https://img.shields.io/node/v/claude-chats-sync.svg)](https://nodejs.org)
+
+> 跨平台命令行工具，将 Claude Code 聊天会话同步到项目目录
+
+中文文档 | [English](README.md)
+
+## ✨ 功能特性
+
+- 🔄 **自动同步** - 创建符号链接将 Claude Code 会话同步到项目文件夹
+- 📁 **项目本地历史** - 聊天会话存储在项目中，而不是用户主目录
+- 🔒 **敏感数据保护** - 清理会话文件中的 API keys
+- 🎯 **简单易用** - 单个命令即可初始化同步
+- 📊 **状态跟踪** - 检查同步状态和会话数量
+- 🌳 **Git 友好** - 配置 Git 过滤器以安全地进行版本控制
+- 🔧 **跨平台** - 支持 Windows、macOS 和 Linux
+
+## 📦 安装
+
+### 全局安装（推荐）
+
+```bash
+npm install -g claude-chats-sync
+```
+
+安装后可以在任何地方使用 `claude-chats-sync` 命令。
+
+### 本地安装
+
+```bash
+npm install -D claude-chats-sync
+```
+
+然后通过 `npx` 使用：
+```bash
+npx claude-chats-sync init
+```
+
+## 🚀 快速开始
+
+### 初始化同步
+
+```bash
+# 在项目目录中
+claude-chats-sync init
+```
+
+这将：
+- 在项目中创建 `.claudeCodeSessions/` 文件夹
+- 在 `~/.claude/projects/` 中创建符号链接
+- 配置 Git 过滤器以自动清理敏感数据
+- 将 `.claudeCodeSessions/` 添加到 `.gitignore`（默认被注释）
+
+### 查看状态
+
+```bash
+claude-chats-sync status
+```
+
+### 打开历史文件夹
+
+```bash
+claude-chats-sync open
+```
+
+## 📖 命令
+
+| 命令 | 说明 |
+|------|------|
+| `init` | 初始化当前项目的同步 |
+| `status` | 检查同步状态和会话数量 |
+| `open` | 在文件管理器中打开历史文件夹 |
+| `clean` | 清理会话文件中的敏感数据 |
+| `setup-git-filter` | 设置 Git 自动清理过滤器 |
+| `help` | 显示帮助信息 |
+
+## 🔧 使用示例
+
+### 基本用法
+
+```bash
+# 初始化同步
+claude-chats-sync init
+
+# 查看状态
+claude-chats-sync status
+
+# 打开会话文件夹
+claude-chats-sync open
+```
+
+### 高级选项
+
+```bash
+# 自定义文件夹名称
+claude-chats-sync init --folder-name .sessions
+
+# 强制迁移现有会话
+claude-chats-sync init --force
+
+# 指定项目路径
+claude-chats-sync init --project-path /path/to/project
+```
+
+### 清理敏感数据
+
+```bash
+# 手动清理
+claude-chats-sync clean
+
+# 设置 Git 自动过滤器
+claude-chats-sync setup-git-filter
+```
+
+## ⚙️ 环境变量配置（推荐）
+
+通过环境变量配置 API keys，防止它们出现在会话文件中：
+
+**Linux/macOS** - 添加到 `~/.bashrc` 或 `~/.zshrc`：
+```bash
+export ANTHROPIC_AUTH_TOKEN="sk-ant-..."
+export ANTHROPIC_BASE_URL="https://api.example.com"  # 可选：第三方 API
+```
+
+**Windows PowerShell**：
+```powershell
+$env:ANTHROPIC_AUTH_TOKEN="sk-ant-..."
+$env:ANTHROPIC_BASE_URL="https://api.example.com"
+```
+
+**Windows CMD（永久设置）**：
+```cmd
+setx ANTHROPIC_AUTH_TOKEN "sk-ant-..."
+setx ANTHROPIC_BASE_URL="https://api.example.com"
+```
+
+## 🔒 安全与版本控制
+
+### ⚠️ 安全警告
+
+会话文件可能包含敏感信息：
+- API keys 和认证令牌
+- 专有代码和业务逻辑
+- 私人对话和内部讨论
+- 系统路径和环境详情
+
+虽然本工具提供了 API key 清理功能，**但没有任何自动清理是 100% 完整的**。只有在你完全理解并接受安全风险时才提交这些文件。
+
+### API Key 配置选项
+
+**选项 1：使用环境变量（推荐）**
+
+配置 Claude Code 从环境变量使用 API keys，防止它们出现在会话文件中。这是最安全的方法。
+
+**选项 2：使用 Git 过滤器**
+
+如果你在配置文件中存储 API keys，Git 过滤器会在提交时自动清理它们。
+
+### Git 过滤器使用
+
+初始化后，正常提交即可：
+
+```bash
+git add .claudeCodeSessions/
+git commit -m "添加对话历史"
+
+# API keys 自动替换为 [REDACTED]
+# 你的本地文件保持不变
+```
+
+### 完全 Git 忽略（最安全）
+
+**推荐**：完全忽略会话文件。在 `.gitignore` 中取消注释：
+
+```gitignore
+.claudeCodeSessions/
+```
+
+这可以防止意外将敏感数据提交到仓库。
+
+## 🌐 工作原理
+
+Claude Code 将聊天会话存储在 `~/.claude/projects/{normalized-project-path}/` 中。
+
+本 CLI 创建一个指向项目文件夹的符号链接（默认：`.claudeCodeSessions/`），使聊天历史成为项目的一部分。
+
+### 示例结构
+
+```
+Your Project/
+├── src/
+├── .claudeCodeSessions/      # 聊天会话（与 ~/.claude 同步）
+│   ├── session-abc123.jsonl
+│   └── session-def456.jsonl
+├── .gitignore               # 自动更新
+├── .gitattributes           # Git 过滤器配置
+└── package.json
+```
+
+## 🔄 跨机器同步
+
+如果你选择同步会话文件：
+
+1. 提交 `.claudeCodeSessions/` 文件夹
+2. 推送到 GitHub
+3. 在另一台机器上拉取
+4. 运行 `claude-chats-sync init` 创建符号链接
+
+## 🔧 平台特定说明
+
+### Windows
+- 使用 junction 点（不需要管理员权限）
+- 支持 PowerShell 和 CMD
+- 运行 PowerShell 脚本可能需要：`Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`
+
+### macOS
+- 需要执行权限：`chmod +x $(which claude-chats-sync)`
+- 使用标准符号链接
+
+### Linux
+- 需要执行权限：`chmod +x $(which claude-chats-sync)`
+- 使用标准符号链接
+
+## 🐛 故障排除
+
+### 符号链接创建失败（Windows）
+
+本工具使用 junction 点，无需管理员权限。如果仍有问题：
+- 确保 Node.js 在 PATH 中
+- 尝试以管理员身份运行
+- 检查项目路径不包含特殊字符
+
+### 历史记录未同步
+
+1. 检查符号链接是否存在：
+   - Windows: `dir %USERPROFILE%\.claude\projects`
+   - macOS/Linux: `ls -la ~/.claude/projects`
+
+2. 验证符号链接是否指向项目的 `.claudeCodeSessions/` 文件夹
+
+### 重新初始化
+
+删除现有符号链接：
+
+```bash
+# Windows
+rmdir "%USERPROFILE%\.claude\projects\{project-name}"
+
+# macOS/Linux
+rm ~/.claude/projects/{project-name}
+```
+
+然后再次运行 `claude-chats-sync init`。
+
+## 📚 相关项目
+
+- [VSCode 扩展](https://marketplace.visualstudio.com/items?itemName=tubo.claude-code-chats-sync) - 功能完整的 VSCode 扩展
+
+## 💰 Token 使用与成本考虑
+
+> ⚠️ **重要提示**：在团队成员间共享会话文件时，每个成员使用自己的 API key 并承担自己的 API 成本。
+
+### 关键要点
+
+1. **每个成员支付自己的使用费用**
+   - 每个团队成员必须配置自己的 API key
+   - 当你继续共享的对话时，**你需要为所有新生成的 tokens 付费**
+   - 原始创建者的 API key **不会被使用**
+
+2. **上下文窗口考虑**
+   - 较长的共享对话会消耗更多 tokens 作为上下文
+   - 一个包含 50,000 tokens 的共享对话，每次新成员继续时都会消耗约 50,000 个输入 tokens
+
+3. **节省成本的最佳实践**
+   - 共享前生成对话摘要
+   - 尽可能开始新对话
+   - 归档旧会话
+   - 监控 API 使用情况
+
+## 📝 许可证
+
+MIT - 详见 [LICENSE](LICENSE) 文件
+
+## 🤝 贡献
+
+欢迎贡献！请提交 issue 或拉取请求。
+
+## 📞 支持
+
+- 📧 [问题反馈](https://github.com/tubo70/claude-chats-sync/issues)
+- 📖 [文档](https://github.com/tubo70/claude-chats-sync/wiki)
+- 💬 [讨论](https://github.com/tubo70/claude-chats-sync/discussions)
+
+## 🔗 链接
+
+- [npm](https://www.npmjs.com/package/claude-chats-sync)
+- [GitHub](https://github.com/tubo70/claude-chats-sync)
+- [VSCode Marketplace](https://marketplace.visualstudio.com/items?itemName=tubo.claude-code-chats-sync)
+
+---
+
+由 [tubo70](https://github.com/tubo70) 用 ❤️ 制作

package/bin/claude-chats-sync

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+
+# Claude Code Sync CLI - Bash wrapper
+# This script allows you to run the CLI with just "claude-sync" command
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+node "$SCRIPT_DIR/claude-sync.js" "$@"

package/bin/claude-chats-sync.cmd

@@ -0,0 +1,5 @@
+@echo off
+REM Claude Code Sync CLI - Windows batch wrapper
+
+set SCRIPT_DIR=%~dp0
+node "%SCRIPT_DIR%claude-sync.js" %*

package/bin/claude-chats-sync.js

@@ -0,0 +1,620 @@
+#!/usr/bin/env node
+
+/**
+ * Claude Code Sync CLI
+ *
+ * 跨平台命令行工具，用于同步 Claude Code 聊天会话到项目目录
+ * Cross-platform CLI tool to sync Claude Code chat sessions to project directory
+ *
+ * Usage:
+ *   node claude-sync-cli.js init              # Initialize sync
+ *   node claude-sync-cli.js status            # Check sync status
+ *   node claude-sync-cli.js open              # Open history folder
+ *   node claude-sync-cli.js clean             # Clean sensitive data from session files
+ *   node claude-sync-cli.js setup-git-filter  # Setup Git filter for auto-cleaning
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+// ANSI 颜色代码 / ANSI color codes
+const colors = {
+  reset: '\x1b[0m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m'
+};
+
+// 工具函数 / Utility functions
+function log(message, color = 'reset') {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+function error(message) {
+  log(`❌ Error: ${message}`, 'red');
+}
+
+function success(message) {
+  log(`✅ ${message}`, 'green');
+}
+
+function info(message) {
+  log(`ℹ️  ${message}`, 'cyan');
+}
+
+function warn(message) {
+  log(`⚠️  ${message}`, 'yellow');
+}
+
+/**
+ * 规范化项目路径为 Claude Code 格式
+ * Normalize project path to Claude Code format
+ *
+ * Windows:   D:\Projects\MyProject -> d--Projects-MyProject
+ * Linux/Mac: /home/user/projects/my-project -> home-user-projects-my-project
+ */
+function normalizeProjectPath(projectPath) {
+  if (process.platform === 'win32') {
+    // Windows: Replace backslashes and colons with dashes, preserve case
+    return projectPath
+      .replace(/\\/g, '-')
+      .replace(/:/g, '-');
+  } else {
+    // Linux/Mac: Replace forward slashes with dashes, preserve case
+    return projectPath
+      .replace(/^\//, '')      // Remove leading slash
+      .replace(/\//g, '-');    // Replace remaining slashes with dashes
+  }
+}
+
+/**
+ * 获取 Claude Code 项目目录
+ * Get Claude Code projects directory
+ */
+function getClaudeProjectsDir() {
+  return path.join(os.homedir(), '.claude', 'projects');
+}
+
+/**
+ * 获取项目中的历史文件夹路径
+ * Get history folder path in the project
+ */
+function getHistoryFolderPath(projectPath, folderName = '.claudeCodeSessions') {
+  return path.join(projectPath, folderName);
+}
+
+/**
+ * 创建符号链接 (跨平台)
+ * Create symbolic link (cross-platform)
+ */
+function createSymlink(target, linkPath) {
+  if (process.platform === 'win32') {
+    // Windows: 使用 junction (不需要管理员权限)
+    // Windows: Use junction (no admin privileges required)
+    fs.symlinkSync(target, linkPath, 'junction');
+  } else {
+    // Unix: 使用符号链接
+    // Unix: Use symbolic link
+    fs.symlinkSync(target, linkPath);
+  }
+}
+
+/**
+ * 检查是否为符号链接
+ * Check if path is a symbolic link
+ */
+function isSymlink(symlinkPath) {
+  try {
+    const stats = fs.lstatSync(symlinkPath);
+    return stats.isSymbolicLink() || (process.platform === 'win32' && stats.isDirectory());
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 移动目录 (递归)
+ * Move directory (recursive)
+ */
+function moveDirectory(src, dest) {
+  // 创建目标目录
+  fs.mkdirSync(dest, { recursive: true });
+
+  // 递归复制所有文件和子目录
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      moveDirectory(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+
+  // 删除源目录
+  fs.rmSync(src, { recursive: true, force: true });
+}
+
+/**
+ * 清理会话文件内容中的敏感信息
+ * Clean sensitive information from session file content
+ */
+function cleanSensitiveData(content) {
+  // Pattern for Anthropic API keys (normal format)
+  const apiKeyPattern = /"primaryApiKey"\s*:\s*"sk-ant-[^"]*"/g;
+
+  // Pattern for API keys within escaped JSON strings
+  const apiKeyPatternEscaped = /\\"primaryApiKey\\":\s*\\"sk-ant-[^"]*\\"/g;
+
+  // Pattern for ANTHROPIC_AUTH_TOKEN (escaped format)
+  const authTokenPatternEscaped = /\\"ANTHROPIC_AUTH_TOKEN\\"\\s*:\\s*\\"[^"]*\\"/g;
+
+  // Pattern for other API keys
+  const genericApiKeyPattern = /"(apiKey|api_key|authorization|token|bearer)"\s*:\s*"[^"]*"/gi;
+
+  // Clean API keys
+  let cleaned = content.replace(apiKeyPattern, '"primaryApiKey": "[REDACTED]"');
+  cleaned = cleaned.replace(apiKeyPatternEscaped, '\\"primaryApiKey\\": \\"[REDACTED]\\"');
+  cleaned = cleaned.replace(authTokenPatternEscaped, '\\"ANTHROPIC_AUTH_TOKEN\\": \\"[REDACTED]\\"');
+  cleaned = cleaned.replace(genericApiKeyPattern, '"$1": "[REDACTED]"');
+
+  return cleaned;
+}
+
+/**
+ * 初始化同步
+ * Initialize sync
+ */
+function init(projectPath, options = {}) {
+  const { folderName = '.claudeCodeSessions', force = false } = options;
+
+  const historyFolder = getHistoryFolderPath(projectPath, folderName);
+  const claudeProjectsDir = getClaudeProjectsDir();
+  const normalizedPath = normalizeProjectPath(projectPath);
+  const symlinkPath = path.join(claudeProjectsDir, normalizedPath);
+
+  try {
+    // 检查符号链接是否已存在
+    // Check if symlink already exists
+    if (fs.existsSync(symlinkPath)) {
+      if (isSymlink(symlinkPath)) {
+        success('Claude Code Chats Sync already initialized');
+        info(`History folder: ${historyFolder}`);
+        info(`Linked to: ${symlinkPath}`);
+        return;
+      } else if (fs.lstatSync(symlinkPath).isDirectory()) {
+        // 现有真实目录 - 用户之前使用过 Claude Code
+        // Existing real directory - user has used Claude Code before
+        const files = fs.readdirSync(symlinkPath);
+        const sessionFiles = files.filter(f => f.endsWith('.jsonl'));
+
+        if (sessionFiles.length > 0 && !force) {
+          warn(`Found ${sessionFiles.length} existing Claude Code session(s) in Claude's storage.`);
+          info('Use --force to move them to your project folder');
+          return;
+        }
+
+        if (sessionFiles.length > 0 && force) {
+          // 移动现有目录到项目文件夹
+          // Move existing directory to project folder
+          moveDirectory(symlinkPath, historyFolder);
+          success(`Moved ${sessionFiles.length} session(s) to project folder!`);
+        } else {
+          // 空目录，直接删除
+          // Empty directory, just remove it
+          fs.rmSync(symlinkPath, { recursive: true, force: true });
+        }
+      } else {
+        error(`A file exists at Claude Code location: ${symlinkPath}`);
+        return;
+      }
+    }
+
+    // 创建历史文件夹 (如果不存在)
+    // Create history folder if it doesn't exist
+    if (!fs.existsSync(historyFolder)) {
+      fs.mkdirSync(historyFolder, { recursive: true });
+      success(`Created folder: ${historyFolder}`);
+    }
+
+    // 确保 .claude/projects 目录存在
+    // Ensure .claude/projects directory exists
+    if (!fs.existsSync(claudeProjectsDir)) {
+      fs.mkdirSync(claudeProjectsDir, { recursive: true });
+    }
+
+    // 创建符号链接
+    // Create symbolic link
+    createSymlink(historyFolder, symlinkPath);
+
+    success('Claude Code Chats Sync initialized!');
+    info(`History folder: ${historyFolder}`);
+    info(`Linked to: ${symlinkPath}`);
+
+    // 添加到 .gitignore
+    // Add to .gitignore
+    addToGitIgnore(projectPath, folderName);
+
+    // 设置 Git 过滤器
+    // Setup Git filter
+    setupGitFilter(projectPath, folderName, false);
+
+  } catch (err) {
+    error(`Failed to initialize: ${err.message}`);
+  }
+}
+
+/**
+ * 检查同步状态
+ * Check sync status
+ */
+function status(projectPath, options = {}) {
+  const { folderName = '.claudeCodeSessions' } = options;
+
+  const historyFolder = getHistoryFolderPath(projectPath, folderName);
+  const claudeProjectsDir = getClaudeProjectsDir();
+  const normalizedPath = normalizeProjectPath(projectPath);
+  const symlinkPath = path.join(claudeProjectsDir, normalizedPath);
+
+  log('\n📊 Claude Code Chats Sync Status\n', 'blue');
+
+  // 检查历史文件夹
+  // Check history folder
+  if (fs.existsSync(historyFolder)) {
+    const files = fs.readdirSync(historyFolder).filter(f => f.endsWith('.jsonl'));
+    success('History folder exists');
+    info(`   Path: ${historyFolder}`);
+    info(`   Sessions: ${files.length}`);
+  } else {
+    error('History folder not found');
+  }
+
+  // 检查符号链接
+  // Check symlink
+  if (fs.existsSync(symlinkPath)) {
+    success('Symlink created');
+    info(`   Path: ${symlinkPath}`);
+  } else {
+    error('Symlink not created');
+  }
+
+  console.log('');
+}
+
+/**
+ * 添加到 .gitignore
+ * Add to .gitignore
+ */
+function addToGitIgnore(projectPath, folderName = '.claudeCodeSessions') {
+  const gitignorePath = path.join(projectPath, '.gitignore');
+
+  try {
+    let content = '';
+    if (fs.existsSync(gitignorePath)) {
+      content = fs.readFileSync(gitignorePath, 'utf-8');
+    }
+
+    const ignoreEntry = `# Claude Code conversation history
+# Uncomment the line below to ignore session files, OR configure Git filter for safe sharing
+# ${folderName}/`;
+
+    // 仅在不存在时添加
+    // Only add if not already present
+    if (!content.includes(`# ${folderName}/`) && !content.includes(`${folderName}/`)) {
+      if (content && !content.endsWith('\n')) {
+        content += '\n';
+      }
+      content += `\n${ignoreEntry}\n`;
+      fs.writeFileSync(gitignorePath, content, 'utf-8');
+      success('Added .gitignore entry (commented by default)');
+    }
+  } catch (err) {
+    warn('Could not update .gitignore (not a Git repository?)');
+  }
+}
+
+/**
+ * 设置 Git 过滤器
+ * Setup Git filter
+ */
+function setupGitFilter(projectPath, folderName = '.claudeCodeSessions', showMessage = true) {
+  try {
+    // 检查是否为 Git 仓库
+    // Check if we're in a Git repository
+    const gitDir = path.join(projectPath, '.git');
+    if (!fs.existsSync(gitDir)) {
+      warn('Not a Git repository. Git filter will not be configured.');
+      return;
+    }
+
+    // 创建清理过滤器脚本
+    // Create clean filter script
+    const filterScriptPath = path.join(projectPath, '.gitfilters', 'clean-sessions.js');
+    const filterDir = path.dirname(filterScriptPath);
+
+    if (!fs.existsSync(filterDir)) {
+      fs.mkdirSync(filterDir, { recursive: true });
+    }
+
+    const filterScript = `#!/usr/bin/env node
+const fs = require('fs');
+
+// Pattern for Anthropic API keys (normal format)
+const apiKeyPattern = /"primaryApiKey"\\\\s*:\\\\s*"sk-ant-[^"]*"/g;
+
+// Pattern for API keys within escaped JSON strings
+const apiKeyPatternEscaped = /\\\\\\\\"primaryApiKey\\\\\\\\"\\\\s*:\\\\\\\\s*\\\\\\"sk-ant-[^"]*\\\\\\"/g;
+
+// Pattern for ANTHROPIC_AUTH_TOKEN (escaped format)
+const authTokenPatternEscaped = /\\\\"ANTHROPIC_AUTH_TOKEN\\\\"\\\\s*:\\\\\\s*\\\\"[^"]*\\\\"/g;
+
+// Pattern for other API keys
+const genericApiKeyPattern = /"(apiKey|api_key|authorization|token|bearer)"\\\\s*:\\\\s*"[^"]*"/gi;
+
+let data = '';
+process.stdin.setEncoding('utf8');
+
+process.stdin.on('data', (chunk) => {
+    data += chunk;
+});
+
+process.stdin.on('end', () => {
+    let cleaned = data.replace(apiKeyPattern, '"primaryApiKey": "[REDACTED]"');
+    cleaned = cleaned.replace(apiKeyPatternEscaped, '\\\\\\\\"primaryApiKey\\\\\\\\": \\\\"[REDACTED]\\\\"');
+    cleaned = cleaned.replace(authTokenPatternEscaped, '\\\\\\\\"ANTHROPIC_AUTH_TOKEN\\\\\\\\": \\\\"[REDACTED]\\\\"');
+    cleaned = cleaned.replace(genericApiKeyPattern, '"$1": "[REDACTED]"');
+    process.stdout.write(cleaned);
+});
+`;
+
+    fs.writeFileSync(filterScriptPath, filterScript, 'utf-8');
+
+    // 在 Unix-like 系统上设置为可执行
+    // Make it executable on Unix-like systems
+    if (process.platform !== 'win32') {
+      try {
+        fs.chmodSync(filterScriptPath, 0o755);
+      } catch (e) {
+        // Ignore permission errors
+      }
+    }
+
+    // 在 .gitconfig 中配置 Git 过滤器
+    // Configure Git filter in .gitconfig
+    const gitConfigPath = path.join(projectPath, '.gitconfig');
+
+    let gitConfig = '';
+    if (fs.existsSync(gitConfigPath)) {
+      gitConfig = fs.readFileSync(gitConfigPath, 'utf-8');
+    }
+
+    if (!gitConfig.includes('[filter "claude-clean"]')) {
+      if (gitConfig && !gitConfig.endsWith('\n')) {
+        gitConfig += '\n';
+      }
+      gitConfig += `[filter "claude-clean"]
+	clean = node .gitfilters/clean-sessions.js
+`;
+      fs.writeFileSync(gitConfigPath, gitConfig, 'utf-8');
+    }
+
+    // 在本地 Git 配置中配置过滤器
+    // Configure the filter in local Git config
+    try {
+      execSync(
+        `git config filter.claude-clean.clean "node .gitfilters/clean-sessions.js"`,
+        { cwd: projectPath, stdio: 'pipe' }
+      );
+    } catch (err) {
+      warn(`Failed to configure local Git filter: ${err.message}`);
+    }
+
+    // 在 .gitattributes 中配置过滤器
+    // Configure the filter in .gitattributes
+    const gitAttributesPath = path.join(projectPath, '.gitattributes');
+
+    let gitAttributes = '';
+    if (fs.existsSync(gitAttributesPath)) {
+      gitAttributes = fs.readFileSync(gitAttributesPath, 'utf-8');
+    }
+
+    const filterLine = `${folderName}/*.jsonl filter=claude-clean`;
+
+    if (!gitAttributes.includes(filterLine)) {
+      if (gitAttributes && !gitAttributes.endsWith('\n')) {
+        gitAttributes += '\n';
+      }
+      gitAttributes += `\n# Claude Code sessions - clean sensitive data on commit\n${filterLine}\n`;
+      fs.writeFileSync(gitAttributesPath, gitAttributes, 'utf-8');
+    }
+
+    if (showMessage) {
+      success('Git filter configured');
+      info('Session files will be automatically cleaned on commit');
+      info('Original files remain unchanged. Only committed versions are cleaned.');
+    }
+
+  } catch (err) {
+    error(`Failed to setup Git filter: ${err.message}`);
+  }
+}
+
+/**
+ * 清理会话文件中的敏感数据
+ * Clean sensitive data from session files
+ */
+function cleanSessions(projectPath, options = {}) {
+  const { folderName = '.claudeCodeSessions' } = options;
+
+  const historyFolder = getHistoryFolderPath(projectPath, folderName);
+
+  if (!fs.existsSync(historyFolder)) {
+    error('History folder does not exist');
+    return;
+  }
+
+  const files = fs.readdirSync(historyFolder).filter(f => f.endsWith('.jsonl'));
+
+  if (files.length === 0) {
+    warn('No session files to clean');
+    return;
+  }
+
+  info(`Cleaning ${files.length} session file(s)...`);
+
+  let cleanedCount = 0;
+  for (const file of files) {
+    const filePath = path.join(historyFolder, file);
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const cleaned = cleanSensitiveData(content);
+
+    // 将清理后的内容写回文件
+    // Write cleaned content back to file
+    fs.writeFileSync(filePath, cleaned, 'utf-8');
+    cleanedCount++;
+  }
+
+  success(`Cleaned ${cleanedCount} session file(s)`);
+  info('Sensitive data has been redacted');
+}
+
+/**
+ * 打开历史文件夹
+ * Open history folder
+ */
+function openFolder(projectPath, options = {}) {
+  const { folderName = '.claudeCodeSessions' } = options;
+
+  const historyFolder = getHistoryFolderPath(projectPath, folderName);
+
+  if (!fs.existsSync(historyFolder)) {
+    error('History folder does not exist. Please initialize first.');
+    return;
+  }
+
+  try {
+    const { exec } = require('child_process');
+
+    let command;
+    switch (process.platform) {
+      case 'darwin':
+        command = 'open';
+        break;
+      case 'win32':
+        command = 'explorer';
+        break;
+      default:
+        command = 'xdg-open';
+    }
+
+    exec(`${command} "${historyFolder}"`);
+    success(`Opened history folder: ${historyFolder}`);
+  } catch (err) {
+    error(`Failed to open folder: ${err.message}`);
+  }
+}
+
+/**
+ * 显示帮助信息
+ * Show help message
+ */
+function showHelp() {
+  const help = `
+Claude Code Sync CLI - 跨平台 Claude Code 会话同步工具
+Claude Code Sync CLI - Cross-platform Claude Code session sync tool
+
+Usage:  node claude-sync-cli.js <command> [options]
+
+Commands:
+  init                  Initialize sync for current project
+  status                Check sync status and session count
+  open                  Open history folder in file manager
+  clean                 Clean sensitive data from session files
+  setup-git-filter      Setup Git filter for automatic cleaning
+  help                  Show this help message
+
+Options:
+  --folder-name <name>  History folder name (default: .claudeCodeSessions)
+  --force               Force migration of existing sessions
+  --project-path <path> Project path (default: current directory)
+
+Examples:
+  node claude-sync-cli.js init
+  node claude-sync-cli.js init --folder-name .sessions
+  node claude-sync-cli.js init --force
+  node claude-sync-cli.js status
+  node claude-sync-cli.js clean
+  node claude-sync-cli.js setup-git-filter
+
+Environment Variables:
+  ANTHROPIC_AUTH_TOKEN  Recommended: Configure API key via env var
+  ANTHROPIC_BASE_URL    Optional: Third-party API endpoint
+
+For more information, visit: https://github.com/tubo70/claude-code-sync-extension
+`;
+
+  console.log(help);
+}
+
+/**
+ * 主函数
+ * Main function
+ */
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  // 解析选项
+  // Parse options
+  const options = {};
+  let projectPath = process.cwd();
+
+  for (let i = 1; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--folder-name' && args[i + 1]) {
+      options.folderName = args[++i];
+    } else if (arg === '--project-path' && args[i + 1]) {
+      projectPath = args[++i];
+    } else if (arg === '--force') {
+      options.force = true;
+    }
+  }
+
+  if (!command || command === 'help' || command === '--help' || command === '-h') {
+    showHelp();
+    return;
+  }
+
+  switch (command) {
+    case 'init':
+      init(projectPath, options);
+      break;
+    case 'status':
+      status(projectPath, options);
+      break;
+    case 'open':
+      openFolder(projectPath, options);
+      break;
+    case 'clean':
+      cleanSessions(projectPath, options);
+      break;
+    case 'setup-git-filter':
+      setupGitFilter(projectPath, options.folderName, true);
+      break;
+    default:
+      error(`Unknown command: ${command}`);
+      info('Run "node claude-sync-cli.js help" for usage information');
+      process.exit(1);
+  }
+}
+
+// 运行主函数
+// Run main function
+main();

package/bin/claude-chats-sync.ps1

@@ -0,0 +1,17 @@
+# Claude Code Sync CLI - PowerShell wrapper
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$CliScript = Join-Path $ScriptDir "claude-sync.js"
+
+# Check if Node.js is installed
+try {
+    $null = & node --version 2>&1
+} catch {
+    Write-Host "❌ Error: Node.js is not installed or not in PATH" -ForegroundColor Red
+    Write-Host "Please install Node.js from https://nodejs.org/" -ForegroundColor Yellow
+    exit 1
+}
+
+# Run the CLI script
+& node $CliScript $args
+exit $LASTEXITCODE

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "claude-chats-sync",
+  "version": "0.0.1",
+  "description": "Cross-platform CLI tool to sync Claude Code chat sessions to project directory",
+  "main": "bin/claude-chats-sync.js",
+  "bin": {
+    "claude-chats-sync": "./bin/claude-chats-sync.js"
+  },
+  "scripts": {
+    "init": "node bin/claude-chats-sync.js init",
+    "status": "node bin/claude-chats-sync.js status",
+    "open": "node bin/claude-chats-sync.js open",
+    "clean": "node bin/claude-chats-sync.js clean",
+    "setup-git-filter": "node bin/claude-chats-sync.js setup-git-filter",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "claude-ai",
+    "sync",
+    "chat",
+    "sessions",
+    "cli",
+    "vscode",
+    "git",
+    "version-control",
+    "developer-tools"
+  ],
+  "author": {
+    "name": "tubo70",
+    "email": "445527@qq.com"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tubo70/claude-chats-sync.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tubo70/claude-chats-sync/issues"
+  },
+  "homepage": "https://github.com/tubo70/claude-chats-sync#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "win32",
+    "darwin",
+    "linux"
+  ],
+  "preferGlobal": true,
+  "files": [
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ]
+}