Community编程与开发github.com

jsahani/already-told-you

阻止 Claude Code 在 30 天后删除会话历史,通过将 ~/.claude/settings.json 中的 cleanupPeriodDays 设置为 365 来实现。操作前会备份文件,保留其他所有设置,并显示结果。

already-told-you 是什么?

这个技能(/already-told-you)专门解决 Claude Code 默认仅保留 30 天会话历史的问题,将清理周期扩展至一整年(365 天)。它通过修改 ~/.claude/settings.json(或 $CLAUDE_CONFIG_DIR 下的对应文件)中的 cleanupPeriodDays 字段来实现。操作流程包括:首先执行检查脚本验证当前配置状态,然后向用户解释即将进行的操作(包括备份、设置更改及磁盘空间影响),在获得用户确认后应用更改,最后显示备份路径和新的配置值。该技能适用于 Claude Code 平台,特别适合需要长期保留工作记录进行回顾或审计的开发者和 AI 代理用户。它采用保守方式,仅修改目标字段,不触碰其他配置,并提供撤销方案。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jsahani/already-told-you/tree/HEAD/skills/keep-history

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Already Told You:保留一年的历史记录

Claude Code 将会话记录存储在 ~/.claude/projects/ 中,并在 cleanupPeriodDays 天后删除它们, 默认是 30 天。/already-told-you:run 只能从仍然存在的内容中学习。(如果用户设置了 CLAUDE_CONFIG_DIR, 脚本会使用该文件夹而不是 ~/.claude。)

  1. 运行 python3 ${CLAUDE_PLUGIN_ROOT}/scripts/keep_history.py --check 并显示输出。
    • “Nothing to do” → 告知用户已经配置完成并停止。
    • “STOP: ... not valid JSON” → 解释设置文件存在拼写错误,未做任何更改,并停止。
  2. 用两行解释:它将备份 ~/.claude/settings.json,将 cleanupPeriodDays 设置为 365,并保持其他所有 设置原封不动。记录会占用磁盘空间(繁忙的一个月可能达到几 GB);365 天即一整年。已删除的记录无法恢复。请求用户确认。
  3. 确认后,运行 python3 ${CLAUDE_PLUGIN_ROOT}/scripts/keep_history.py --apply。它会请求权限——让用户 回答该提示。显示输出:备份路径以及从文件中读取到的值。
  4. 要撤销:将备份文件复制回 ~/.claude/settings.json,或删除 cleanupPeriodDays 这一行。

请勿以其他方式编辑 settings.json。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能