一个透明的 Claude Code 和 Codex 插件,通过压缩前后钩子自动保存和恢复 /compact 命令前后的工作状态。

Stars

182

7 天增长

暂无数据

Fork 数

4

开放 Issue

0

开源协议

MIT

最近更新

2026-07-27

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它解决了 AI 编程助手中压缩操作导致会话上下文丢失的常见问题,提供自动的状态备份、恢复和可配置的警告系统,无需手动干预。

适合谁使用

  • 使用 Claude Code 或 Codex 进行长时间编码会话的开发者
  • 依赖 AI 结对编程并需要在压缩后维持上下文的团队
  • 希望对压缩行为和恢复笔记进行精细控制的高级用户
  • 对基于钩子增强 AI 运行时压缩感兴趣的插件开发者

典型使用场景

  • 在 /compact 命令前自动保存完整的任务计划、决策和文件状态
  • 压缩后恰好一次恢复代理上下文,包括技能调用和编辑历史
  • 当上下文使用接近阈值时收到主动警告,同时附带简短的状态摘要
  • 通过 /compact-plus 技能手动记录更丰富的恢复笔记,为即将发生的压缩做准备

项目优势

  • 完全透明操作——基本使用无需额外命令或手动步骤
  • 使用相同的基于钩子的架构同时支持 Claude Code 和 Codex
  • 增量式转录处理和可配置的压缩减少 LLM 令牌成本
  • 处理线程派生子代理和运行时钩子顺序差异等边缘情况

使用前须知

  • 需要兼容的 LLM 后端(claude -p 或 codex exec)以及后备模型的订阅
  • 配置涉及多个可调参数的环境变量,可能令普通用户感到困惑
  • 依赖于特定运行时的钩子 API,未来 Claude Code 或 Codex 版本可能发生变化

README 快速开始

Usage

项目描述

Claude Code plugin: preserve and restore working state around /compact

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

jamesob
精选
jamesob GitHub avatar

local-llm

A comprehensive guide for building and configuring a high-end local machine to run state-of-the-art LLMs, with detailed hardware choices, BIOS tuning, and Docker-based model serving.

AI 与机器学习大语言模型
1,660
bjan
精选
bjan GitHub avatar

claudemux

Claudemux is a lightweight, dependency-minimal message bus that lets multiple Claude Code sessions communicate in real-time over tmux, enabling one session to ask another a question and receive the answer without manual intervention.

AI 与机器学习AI 智能体
9
AARomanov1985
AARomanov1985 GitHub avatar

Audio-Cassette-Simulation

A set of bash scripts using ffmpeg to simulate vintage cassette tape audio profiles with noise, wow/flutter, bandwidth limits, and EQ.

Shell
373