AI CLI Cleaner
审查和删除本地AI代理对话在macOS上。选择单独的会话或清除座席的本地历史记录，包括支持的索引和相关数据。内存是默认保存的。保留已知的登录、设置、MCP、技能和插件路径；进程、打开文件、路径、所有权和格式检查可以拒绝操作。
这是测试版软件。保持一个独立的备份，回顾预览和 格式的限制，并在删除前关闭所选代理。文件移动到macOS垃圾桶；支持的索引更改具有备份和操作日志。恢复是手动的，垃圾不是安全擦除。
安装
要求macOS 26或更高版本，Node.js ^22.22.2， ^24.15.0，或者 ^26.0.0， NPM为10、11或12；与这些Node.js版本绑定的npm可以正常工作。Node.js和npm必须已经安装。
npm install --global ai-cli-cleaner@latest
ai-cleaner --version
ai-cleaner doctor --all
该包包括编译后的CLI、本机帮助程序和绑定的运行时依赖项；不需要源代码构建。每个版本，包括测试版，都是使用npm发布的 latest 标记，因此重新运行相同的命令将安装最新版本。内置的更新程序使用单独发布的GitHub版本，所以它不遵循npm的dist-tags。看到 安装和更新 用于运行时设置、源代码/存档的安装和删除。
快速启动
检查您的环境，预览整个范围，并在交互式终端中查看单个对话：
ai-cleaner doctor --target codex
ai-cleaner clean --target codex --dry-run
ai-cleaner clean --all --dry-run --verbose
ai-cleaner conversations --target codex --dry-run
关闭选定的代理，然后再次运行选择器并确认要删除的对话：
ai-cleaner conversations --target codex
对于代理人 本地会话历史和相关数据，查看预览，保持代理关闭，并运行：
ai-cleaner clean --target codex
记忆默认是完整的，包括和 --all， --yes，或者 --force-stop. 添加 --include-memories 仅当您还希望删除受支持的内存存储时。在运行之前预览更大的作用域：
ai-cleaner clean --all --include-memories --dry-run --verbose
ai-cleaner clean --all --include-memories --force-stop
默认保留Codex的内存数据库和 memories/心意相通的 memory/，以及克劳德的项目和子代理的内存目录。保留的记忆仍然可以包含删除的对话的信息。 conversations 也默认保留记忆；它的 --include-memories 选项仅删除可归因于所选对话的支持记录，即当前法典数据库记录。在选择删除期间，共享内存文件和其他代理的内存存储保持不变。看到 内存范围 对于精确路径。
法典完全清除也移除有效 YYYY-MM-DD 目录直接在里面 ~/Documents/Codex，其中包含所有内容—包括项目源文件。 它也去掉了那个根 .DS_Store 仪元数据。它保存了 Codex 根目录、普通命名项目目录、无效日期和以日期命名的文件。删除选定对话不会删除这些工作区。完全清理还可以包括附件、语音记录、目标、队列、生成的图像、可视化、日志和缓存。确认前请查看实际路径。
支持代理
| 代理 | --target | 选择对话 | 全面清理 |
|---|---|---|---|
| Codex CLI / App | codex | 支持本地记录和索引 | 包括上面描述的过时的工作区 |
| GitHub Copilot CLI | copilot | 支持的会话记录和索引 | 支持的本地历史和相关数据 |
| 谷歌反重力CLI / IDE | antigravity | 当任一共享protobuf摘要非空时阻塞 | 包括已知的CLI和IDE根 |
| OpenCode | opencode | 支持的SQLite格式 | 在混合数据库中保留受支持的帐户/配置数据 |
| Grok Build命令行 | grok | 支持的会话和索引 | 当地的历史;回忆只与 --include-memories |
| 克劳德代码 | claude | 预览;使用完全清理来删除 | 本地历史、工件和支持的Desktop Code边栏记录；回忆只与 --include-memories |
支持取决于存储格式和所有权检查。 兼容性 定义验证用例、根、遗留存储和拒绝；桌面GUI行为和云模型不在这些CLI案例中。当Antigravity的共享摘要阻止个人删除时，使用其内置的 /resume 接口。OpenCode遗留JSON支持对已知会话子目录的完全清除，但不支持选择性删除。
命令
| 命令 | 目的 |
|---|---|
ai-cleaner conversations | 选择一个代理，然后交互式地选择对话； --target 直接选择一个代理。 |
ai-cleaner clean --target codex,copilot | 清除所选代理的完整本地历史记录。 |
ai-cleaner clean --all --dry-run | 预览所有六个代理的清理摘要。 |
ai-cleaner clean --all --include-memories --dry-run | 预览包含支持内存存储的所有代理。 |
ai-cleaner clean --target claude | Clean Claude Code支持本地历史和相关数据。 |
ai-cleaner doctor --all | 检查平台、工具、数据根和正在运行的代理。 |
ai-cleaner recovery list | 列出本地操作记录。 |
ai-cleaner recovery inspect <id> | 检查备份、完整性和手动恢复指导。 |
ai-cleaner update | 查看GitHub公共版本以获得更新的稳定版本。 |
ai-cleaner update --install | 在受支持的全局安装中验证并安装已发布的更新。 |
运行 ai-cleaner <command> --help 为选项。对话和恢复列表使用系统时区； --timezone Asia/Taipei 或者另一个IANA区域覆盖它。 doctor， recovery list, recovery inspect <id> 支持 --json;看到 复苏 用于操作状态、保留副本和手动恢复。
clean 默认情况下显示简短的摘要，包括是否保留或包含内存。添加 --verbose (或 -v)获取完整的范围、路径和索引更新； clean --all --dry-run --verbose 在不停止代理或删除原件的情况下预览这些详细信息。关机影响、过时的Codex工作空间内容、错误和恢复路径仍然可见，没有详细的输出。
数据处理和限制
清理作用于已知的本地路径。它不调用提供商云历史api，不发现任意工作区，也不搜索磁盘。同步受影响文件的外部服务可能会传播其本地删除。自定义根如不同 CODEX_HOME 拒绝;符号链接或重新定位的文档根不支持Codex完全清除。
--force-stop 请求关闭，并可能关闭ChatGPT/Codex或克劳德桌面应用程序时选择。 --yes 跳过完全清理确认，但保留过程和数据检查。开放的SQLite数据库或sidecars，未知的格式，模糊的所有权，以及发现后的更改可能会阻止删除；保存数据并调查拒绝。
演练不会删除原始数据或停止代理。SQLite检查使用私有临时副本，其中可能包含敏感数据和旁注；这些副本随后会被移到垃圾桶。垃圾、备份和日志会保留数据，直到你处理它们；该工具从不清空废纸篓或擦除备份。选择的删除遵循受支持的id、拥有的路径和数据库关系，而不从文本提及推断所有权。
终端和脚本
对话选择和确认需要一个标准输入和标准错误的交互式终端。提示和错误归为标准错误；结果将输出到标准输出。对于脚本，使用 clean --dry-run，然后使用 clean --yes 只有当跳过确认是故意的。管道 y 在发现或变异之前，交互式命令被拒绝。
退出密码是 0 成功或故意取消No/Escape， 1 对于错误或不完整的操作，和 130 用于在交互式提示期间按Ctrl-C。
文档和社区
报告可重现的bug和特性请求 GitHub的问题，使用合成示例和编辑输出。保留会话、原始数据库、帐户标识符、完整的个人路径、秘密和完整的报告日志。遵循 安全策略 用于漏洞披露。
下许可 麻省理工学院． 捆绑的本机Trash helper包含自己的helper 麻省理工学院的许可 和 出处． 项目拥有的索赔帮助器具有独立的 源和二元来源.