claude-context-saver 1.2.0 → 1.2.2

package/README.md

@@ -43,6 +43,15 @@ node setup.mjs -g               # global
 
 Restart Claude Code after installing.
 
+## Update
+
+```bash
+npx claude-context-saver@latest        # local
+npx claude-context-saver@latest -g     # global
+```
+
+Re-running the installer overwrites hooks with the latest version.
+
 ## Uninstall
 
 ```bash
@@ -149,7 +158,7 @@ Read .claude/backups/LATEST.md to recover context.
 ```
 your-project/
 └── .claude/
-    ├── hooks/ContextRecoveryHook/
+    ├── hooks/context-saver/
     │   ├── backup-core.mjs
     │   ├── statusline-monitor.mjs
     │   └── conv-backup.mjs
@@ -164,7 +173,7 @@ your-project/
 
 ```
 ~/.claude/
-├── hooks/ContextRecoveryHook/
+├── hooks/context-saver/
 │   ├── backup-core.mjs
 │   ├── statusline-monitor.mjs
 │   └── conv-backup.mjs
@@ -181,13 +190,13 @@ The installer merges these entries into your settings (all existing settings pre
 {
   "statusLine": {
     "type": "command",
-    "command": "node \".claude/hooks/ContextRecoveryHook/statusline-monitor.mjs\""
+    "command": "node \".claude/hooks/context-saver/statusline-monitor.mjs\""
   },
   "hooks": {
     "PreCompact": [{
       "hooks": [{
         "type": "command",
-        "command": "node \".claude/hooks/ContextRecoveryHook/conv-backup.mjs\"",
+        "command": "node \".claude/hooks/context-saver/conv-backup.mjs\"",
         "async": true
       }]
     }]
@@ -200,13 +209,13 @@ The installer merges these entries into your settings (all existing settings pre
 {
   "statusLine": {
     "type": "command",
-    "command": "node \"$HOME/.claude/hooks/ContextRecoveryHook/statusline-monitor.mjs\""
+    "command": "node \"$HOME/.claude/hooks/context-saver/statusline-monitor.mjs\""
   },
   "hooks": {
     "PreCompact": [{
       "hooks": [{
         "type": "command",
-        "command": "node \"$HOME/.claude/hooks/ContextRecoveryHook/conv-backup.mjs\"",
+        "command": "node \"$HOME/.claude/hooks/context-saver/conv-backup.mjs\"",
         "async": true
       }]
     }]
@@ -214,6 +223,17 @@ The installer merges these entries into your settings (all existing settings pre
 }
 ```
 
+## Context Window & Compaction
+
+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.
+
+On a 200K context window:
+- ~167K tokens are usable before compaction fires
+- The remaining 33K is untouchable buffer
+- After compaction, context resets to a lossy summary + system prompt + CLAUDE.md
+
+This tool doesn't prevent compaction — it makes sure you have detailed backups before it happens, and recovers them automatically after.
+
 ## Requirements
 
 - Node.js >= 18

package/backup-core.mjs

@@ -304,7 +304,7 @@ export async function createBackup({ transcriptPath, sessionId, projectDir, trig
     return { path: backupPath, num };
   } catch (err) {
     // Backup should never crash the host process
-    process.stderr.write(`[context-recovery] Backup failed: ${err.message}\n`);
+    process.stderr.write(`[context-saver] Backup failed: ${err.message}\n`);
     return null;
   }
 }

package/conv-backup.mjs

@@ -15,7 +15,7 @@ async function main() {
   try {
     data = JSON.parse(input);
   } catch {
-    process.stderr.write('[context-recovery] PreCompact: invalid stdin\n');
+    process.stderr.write('[context-saver] PreCompact: invalid stdin\n');
     process.exit(0);
   }
 
@@ -38,10 +38,10 @@ async function main() {
   });
 
   if (result) {
-    process.stderr.write(`[context-recovery] PreCompact backup saved: ${result.path}\n`);
+    process.stderr.write(`[context-saver] PreCompact backup saved: ${result.path}\n`);
   }
 }
 
 main().catch(err => {
-  process.stderr.write(`[context-recovery] PreCompact error: ${err.message}\n`);
+  process.stderr.write(`[context-saver] PreCompact error: ${err.message}\n`);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-context-saver",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Automatic context backup for Claude Code — saves conversation state before auto-compaction wipes it",
   "type": "module",
   "bin": {

package/setup.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// setup.mjs — One-command installer for Context Recovery Hook
+// setup.mjs — One-command installer for claude-context-saver
 // Usage: node setup.mjs [-g] [--uninstall]
 // Default: local install to project .claude/
 // -g: install globally to ~/.claude/ (all projects)
@@ -22,15 +22,15 @@ const isHelp = args.includes('--help') || args.includes('-h');
 const CLAUDE_DIR = isLocal
   ? join(process.cwd(), '.claude')
   : join(homedir(), '.claude');
-const HOOKS_DIR = join(CLAUDE_DIR, 'hooks', 'ContextRecoveryHook');
+const HOOKS_DIR = join(CLAUDE_DIR, 'hooks', 'context-saver');
 const SETTINGS_PATH = join(CLAUDE_DIR, 'settings.json');
 
 // Command paths used inside settings.json
 // Global: use $HOME so it works across shells (Git Bash, etc.)
 // Local: use .claude/ relative path (Claude Code runs from project root)
 const HOOK_CMD_PREFIX = isLocal
-  ? '.claude/hooks/ContextRecoveryHook'
-  : '$HOME/.claude/hooks/ContextRecoveryHook';
+  ? '.claude/hooks/context-saver'
+  : '$HOME/.claude/hooks/context-saver';
 
 const SCRIPTS = ['backup-core.mjs', 'statusline-monitor.mjs', 'conv-backup.mjs'];
 
@@ -116,7 +116,7 @@ function removeClaudeMdRecovery(projectDir) {
 
 function install() {
   const mode = isLocal ? 'local (this project only)' : 'global (all projects)';
-  console.log(`Context Recovery Hook — Installing ${mode}...\n`);
+  console.log(`claude-context-saver — Installing ${mode}...\n`);
 
   // 1. Copy scripts to hooks dir
   mkdirSync(HOOKS_DIR, { recursive: true });
@@ -133,7 +133,7 @@ function install() {
   const configs = makeConfigs();
 
   // Check for existing statusLine
-  if (settings.statusLine && settings.statusLine.command && !settings.statusLine.command.includes('ContextRecoveryHook')) {
+  if (settings.statusLine && settings.statusLine.command && !settings.statusLine.command.includes('context-saver')) {
     console.log(`  WARNING: Existing statusLine config will be overwritten:`);
     console.log(`    Old: ${JSON.stringify(settings.statusLine)}`);
     console.log(`    New: ${JSON.stringify(configs.statusLine)}`);
@@ -147,7 +147,7 @@ function install() {
 
   const existingPreCompact = settings.hooks.PreCompact || [];
   const alreadyInstalled = existingPreCompact.some(entry =>
-    entry.hooks?.some(h => h.command?.includes('ContextRecoveryHook'))
+    entry.hooks?.some(h => h.command?.includes('context-saver'))
   );
 
   if (alreadyInstalled) {
@@ -163,11 +163,11 @@ function install() {
   console.log('Installation complete!\n');
   if (isLocal) {
     console.log('Mode:                  local (this project only)');
-    console.log(`Hooks installed to:    .claude/hooks/ContextRecoveryHook/`);
+    console.log(`Hooks installed to:    .claude/hooks/context-saver/`);
     console.log(`Settings updated:      .claude/settings.json`);
   } else {
     console.log('Mode:                  global (all projects)');
-    console.log('Hooks installed to:    ~/.claude/hooks/ContextRecoveryHook/');
+    console.log('Hooks installed to:    ~/.claude/hooks/context-saver/');
     console.log('Settings updated:      ~/.claude/settings.json');
   }
   console.log('Backups will appear:   {project}/.claude/backups/');
@@ -182,7 +182,7 @@ function install() {
 
 function uninstall() {
   const mode = isLocal ? 'local' : 'global';
-  console.log(`Context Recovery Hook — Uninstalling ${mode}...\n`);
+  console.log(`claude-context-saver — Uninstalling ${mode}...\n`);
 
   // 1. Remove hooks directory
   if (existsSync(HOOKS_DIR)) {
@@ -198,7 +198,7 @@ function uninstall() {
     let changed = false;
 
     // Remove statusLine if it's ours
-    if (settings.statusLine?.command?.includes('ContextRecoveryHook')) {
+    if (settings.statusLine?.command?.includes('context-saver')) {
       delete settings.statusLine;
       console.log('  Removed statusLine config.');
       changed = true;
@@ -207,7 +207,7 @@ function uninstall() {
     // Remove our PreCompact hook entry
     if (settings.hooks?.PreCompact) {
       const filtered = settings.hooks.PreCompact.filter(entry =>
-        !entry.hooks?.some(h => h.command?.includes('ContextRecoveryHook'))
+        !entry.hooks?.some(h => h.command?.includes('context-saver'))
       );
       if (filtered.length !== settings.hooks.PreCompact.length) {
         settings.hooks.PreCompact = filtered.length > 0 ? filtered : undefined;