claude-context-saver 1.2.1 → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +20 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -43,6 +43,15 @@ node setup.mjs -g # global
43
43
 
44
44
  Restart Claude Code after installing.
45
45
 
46
+ ## Update
47
+
48
+ ```bash
49
+ npx claude-context-saver@latest # local
50
+ npx claude-context-saver@latest -g # global
51
+ ```
52
+
53
+ Re-running the installer overwrites hooks with the latest version.
54
+
46
55
  ## Uninstall
47
56
 
48
57
  ```bash
@@ -214,6 +223,17 @@ The installer merges these entries into your settings (all existing settings pre
214
223
  }
215
224
  ```
216
225
 
226
+ ## Context Window & Compaction
227
+
228
+ Claude Code auto-compacts at ~83.5% context usage. This is built into Claude Code and **cannot be changed**. The 33K token buffer is reserved for compaction's own summary.
229
+
230
+ On a 200K context window:
231
+ - ~167K tokens are usable before compaction fires
232
+ - The remaining 33K is untouchable buffer
233
+ - After compaction, context resets to a lossy summary + system prompt + CLAUDE.md
234
+
235
+ This tool doesn't prevent compaction — it makes sure you have detailed backups before it happens, and recovers them automatically after.
236
+
217
237
  ## Requirements
218
238
 
219
239
  - Node.js >= 18
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-context-saver",
3
- "version": "1.2.1",
3
+ "version": "1.2.2",
4
4
  "description": "Automatic context backup for Claude Code — saves conversation state before auto-compaction wipes it",
5
5
  "type": "module",
6
6
  "bin": {