dizz

dizz 是一款为 AI 编码代理提供项目记忆的开源命令行工具。它解决了 AI 代理在每次会话中因缺乏上下文而导致的低效问题，通过深入分析代码库和 Git 历史，将庞大的项目状态浓缩为一份约 450 token 的精简摘要，让代理在每次运行时都能快速掌握项目全貌。

核心功能

dizz 的核心在于其独特的上下文提取机制。它能够自动扫描代码库中的关键信息，包括分支状态、TODO 注释、配置文件和 Git 提交记录，并生成一份结构化的“项目记忆”文件。该文件体积极小（约 1.8KB），却包含了代理所需的全部关键上下文，从而显著提升其决策准确性。

主要特性

• 零配置：无需任何配置文件，一条命令即可运行，开箱即用。
• 离线运行：所有分析均在本地完成，不依赖网络，保障代码安全。
• 非侵入式：只读取代码和 Git 历史，绝不修改你的代码或项目结构。
• 高效精简：将 141KB 的原始状态压缩至 1.8KB，大幅降低 token 消耗。
• 持续更新：每次运行都会重新提取，确保记忆始终与最新代码同步。

适用场景

dizz 特别适合使用 AI 编程助手（如 GitHub Copilot、Cursor 等）的开发者，尤其是在大型项目、多分支开发或频繁切换任务时。它能让代理快速理解项目背景，减少错误操作，提升开发效率。无论是个人开发者还是团队协作，dizz 都能成为 AI 编码流程中的得力助手。