README_zh.md

WayLog CLI

无缝同步、保留并本地化版本控制你的 AI 编程对话历史。

WayLog CLI 是一个轻量级的工具，自动捕捉并存档你的 AI 编程会话（Claude Code, Gemini CLI, OpenAI Codex CLI），将其导出为整洁、可搜索的本地 Markdown 文件。不要再因为会话过期而丢失上下文——WayLog CLI 帮你实现 AI 历史的本地所有权。

English | 中文文档

---

✨ 特性

• 🔄 自动同步：实时同步聊天历史至 .waylog/history/，边聊边记。
• 📦 全量历史恢复：使用 pull 命令扫描全机，将过去或丢失的会话恢复到当前项目中。
• 📝 Markdown 原生：所有历史记录均保存为带 Frontmatter 元数据的高质量 Markdown 文件。

🚀 安装

使用 Homebrew (推荐)

brew install shayne-snap/tap/waylog

使用 Cargo

cargo install waylog

💡 使用方法

1. 实时记录 (run)

使用 waylog run 代替直接调用 AI 工具。WayLog 将启动代理并实时记录对话。

# 启动 Claude Code 并同步
waylog run claude

# 启动 Gemini CLI
waylog run gemini

2. 全量同步 / 恢复历史 (pull)

扫描本地 AI 供应商的存储，并将所有相关的会话“拉取”到项目的 .waylog 文件夹中。

# 拉取当前项目的所有历史记录
waylog pull

📂 支持的供应商

供应商	状态	描述
Claude Code	🚧 Beta	支持 Anthropic 的 claude 命令行工具。
Gemini CLI	🚧 Beta	支持 Google 的 Gemini 命令行工具。
Codex	🚧 Beta	支持 OpenAI Codex CLI。

源码安装

git clone https://github.com/shayne-snap/waylog-cli.git
cd waylog-cli
./scripts/install.sh

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

📄 许可证

基于 Apache License 2.0 许可证分发。详见 LICENSE 文件。