coder-config 0.42.30 → 0.42.31

package/README.md

@@ -396,6 +396,9 @@ Context is automatically restored within 24 hours of being saved.
 
 ### Setup
 
+**From the UI:** Go to **System > Sessions** and click "Install All"
+
+**From the CLI:**
 ```bash
 coder-config session install
 ```

package/hooks/session-end.sh

@@ -1,36 +1,15 @@
 #!/bin/bash
-# Session End Hook - Save session info for potential resume
-# Install: Add to ~/.claude/settings.json hooks.SessionEnd
+# Session End Hook - Log session info
+# Context is saved by /flush to .claude/session-context.md (project-local)
 
 # Read hook input
 INPUT=$(cat)
 SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty')
-TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // empty')
-CWD=$(echo "$INPUT" | jq -r '.cwd // empty')
-REASON=$(echo "$INPUT" | jq -r '.reason // empty')
 
 # Skip if no session ID
 [ -z "$SESSION_ID" ] && exit 0
 
-# Session state directory
-STATE_DIR="$HOME/.coder-config/sessions"
-mkdir -p "$STATE_DIR"
-
-# Save session metadata
-cat > "$STATE_DIR/last-session.json" << EOF
-{
-  "session_id": "$SESSION_ID",
-  "transcript_path": "$TRANSCRIPT_PATH",
-  "cwd": "$CWD",
-  "reason": "$REASON",
-  "timestamp": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
-}
-EOF
-
-# If there's a flushed context file, preserve it
-FLUSH_FILE="$STATE_DIR/flushed-context.md"
-if [ -f "$FLUSH_FILE" ]; then
-  cp "$FLUSH_FILE" "$STATE_DIR/last-flushed-context.md"
-fi
+# Log session end (optional, for debugging)
+# echo "Session $SESSION_ID ended" >> /tmp/claude-sessions.log
 
 exit 0

package/hooks/session-start.sh

@@ -1,35 +1,13 @@
 #!/bin/bash
 # Session Start Hook - Restore context from previous session
-# Install: Add to ~/.claude/settings.json hooks.SessionStart
+# Context is stored in .claude/session-context.md (project-local)
 
-# Session state directory
-STATE_DIR="$HOME/.coder-config/sessions"
+PROJECT_CONTEXT=".claude/session-context.md"
 
-# Check for saved context to inject
-LAST_CONTEXT="$STATE_DIR/last-flushed-context.md"
-LAST_SESSION="$STATE_DIR/last-session.json"
-
-# Only inject if we have flushed context
-if [ -f "$LAST_CONTEXT" ]; then
-  # Check if context is recent (within 24 hours)
-  if [ "$(uname)" = "Darwin" ]; then
-    # macOS
-    FILE_AGE=$(( $(date +%s) - $(stat -f %m "$LAST_CONTEXT") ))
-  else
-    # Linux
-    FILE_AGE=$(( $(date +%s) - $(stat -c %Y "$LAST_CONTEXT") ))
-  fi
-
-  # 24 hours = 86400 seconds
-  if [ "$FILE_AGE" -lt 86400 ]; then
-    # Output context - Claude will see this in the session
-    echo "<session-context source=\"previous-session\">"
-    echo "The following context was saved from a previous session:"
-    echo ""
-    cat "$LAST_CONTEXT"
-    echo ""
-    echo "</session-context>"
-  fi
+if [ -f "$PROJECT_CONTEXT" ]; then
+  echo "<session-context source=\"project\">"
+  cat "$PROJECT_CONTEXT"
+  echo "</session-context>"
 fi
 
 exit 0

package/lib/constants.js

@@ -2,7 +2,7 @@
  * Constants and tool path configurations
  */
 
-const VERSION = '0.42.30';
+const VERSION = '0.42.31';
 
 // Tool-specific path configurations
 const TOOL_PATHS = {

package/lib/sessions.js

@@ -1,56 +1,28 @@
 /**
  * Session persistence management
- * Saves and restores Claude Code session context
+ * Context is stored in project-local .claude/session-context.md
  */
 
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
-const SESSION_DIR = path.join(os.homedir(), '.coder-config', 'sessions');
-const LAST_SESSION_FILE = path.join(SESSION_DIR, 'last-session.json');
-const FLUSHED_CONTEXT_FILE = path.join(SESSION_DIR, 'flushed-context.md');
-const LAST_FLUSHED_FILE = path.join(SESSION_DIR, 'last-flushed-context.md');
-
 /**
- * Ensure session directory exists
+ * Get session status for a project
  */
-function ensureSessionDir() {
-  if (!fs.existsSync(SESSION_DIR)) {
-    fs.mkdirSync(SESSION_DIR, { recursive: true });
-  }
-}
-
-/**
- * Get session status
- */
-function getSessionStatus() {
-  ensureSessionDir();
+function getSessionStatus(projectDir = process.cwd()) {
+  const contextFile = path.join(projectDir, '.claude', 'session-context.md');
 
   const status = {
     hasSavedContext: false,
-    lastSession: null,
+    contextPath: contextFile,
     contextAge: null,
   };
 
-  // Check for flushed context
-  if (fs.existsSync(LAST_FLUSHED_FILE)) {
+  if (fs.existsSync(contextFile)) {
     status.hasSavedContext = true;
-    const stat = fs.statSync(LAST_FLUSHED_FILE);
+    const stat = fs.statSync(contextFile);
     status.contextAge = Math.floor((Date.now() - stat.mtimeMs) / 1000 / 60); // minutes
-  } else if (fs.existsSync(FLUSHED_CONTEXT_FILE)) {
-    status.hasSavedContext = true;
-    const stat = fs.statSync(FLUSHED_CONTEXT_FILE);
-    status.contextAge = Math.floor((Date.now() - stat.mtimeMs) / 1000 / 60);
-  }
-
-  // Check for last session metadata
-  if (fs.existsSync(LAST_SESSION_FILE)) {
-    try {
-      status.lastSession = JSON.parse(fs.readFileSync(LAST_SESSION_FILE, 'utf8'));
-    } catch (e) {
-      // Ignore parse errors
-    }
   }
 
   return status;
@@ -66,74 +38,41 @@ function showSessionStatus() {
 
   if (status.hasSavedContext) {
     console.log(`  Saved context: Yes`);
+    console.log(`  Location: ${status.contextPath}`);
     if (status.contextAge !== null) {
       if (status.contextAge < 60) {
-        console.log(`  Context age: ${status.contextAge} minutes`);
+        console.log(`  Age: ${status.contextAge} minutes`);
       } else if (status.contextAge < 1440) {
-        console.log(`  Context age: ${Math.floor(status.contextAge / 60)} hours`);
+        console.log(`  Age: ${Math.floor(status.contextAge / 60)} hours`);
       } else {
-        console.log(`  Context age: ${Math.floor(status.contextAge / 1440)} days`);
+        console.log(`  Age: ${Math.floor(status.contextAge / 1440)} days`);
       }
     }
   } else {
     console.log('  Saved context: None');
+    console.log(`  Expected at: ${status.contextPath}`);
   }
 
-  if (status.lastSession) {
-    console.log(`\n  Last session:`);
-    console.log(`    ID: ${status.lastSession.session_id || 'unknown'}`);
-    console.log(`    CWD: ${status.lastSession.cwd || 'unknown'}`);
-    console.log(`    Ended: ${status.lastSession.timestamp || 'unknown'}`);
-    console.log(`    Reason: ${status.lastSession.reason || 'unknown'}`);
-  }
-
-  console.log(`\n  Storage: ${SESSION_DIR}`);
-
-  if (!status.hasSavedContext) {
-    console.log('\nTo save context, use /flush in Claude Code or:');
-    console.log('  coder-config session flush');
-  }
+  console.log('\nTo save context, use /flush in Claude Code.');
 }
 
 /**
- * Print instructions for manual flush
- * (Actual flush happens in Claude Code via /flush command)
+ * Print instructions for flush
  */
 function flushContext() {
   console.log('Session context flush\n');
-  console.log('To save session context, use the /flush command in Claude Code.');
-  console.log('This tells Claude to write a summary to:');
-  console.log(`  ${FLUSHED_CONTEXT_FILE}\n`);
-  console.log('The context will be automatically restored on the next session start');
-  console.log('(if session hooks are installed).\n');
-  console.log('Install hooks with:');
-  console.log('  coder-config session install-hooks');
+  console.log('Use /flush in Claude Code to save session context.');
+  console.log('Context is saved to: .claude/session-context.md');
 }
 
 /**
  * Clear saved session context
  */
-function clearContext() {
-  ensureSessionDir();
-
-  let cleared = false;
+function clearContext(projectDir = process.cwd()) {
+  const contextFile = path.join(projectDir, '.claude', 'session-context.md');
 
-  if (fs.existsSync(FLUSHED_CONTEXT_FILE)) {
-    fs.unlinkSync(FLUSHED_CONTEXT_FILE);
-    cleared = true;
-  }
-
-  if (fs.existsSync(LAST_FLUSHED_FILE)) {
-    fs.unlinkSync(LAST_FLUSHED_FILE);
-    cleared = true;
-  }
-
-  if (fs.existsSync(LAST_SESSION_FILE)) {
-    fs.unlinkSync(LAST_SESSION_FILE);
-    cleared = true;
-  }
-
-  if (cleared) {
+  if (fs.existsSync(contextFile)) {
+    fs.unlinkSync(contextFile);
     console.log('Session context cleared.');
   } else {
     console.log('No session context to clear.');
@@ -147,12 +86,10 @@ function installHooks() {
   const claudeDir = path.join(os.homedir(), '.claude');
   const settingsFile = path.join(claudeDir, 'settings.json');
 
-  // Ensure .claude directory exists
   if (!fs.existsSync(claudeDir)) {
     fs.mkdirSync(claudeDir, { recursive: true });
   }
 
-  // Load existing settings
   let settings = {};
   if (fs.existsSync(settingsFile)) {
     try {
@@ -163,31 +100,22 @@ function installHooks() {
     }
   }
 
-  // Initialize hooks if needed
   if (!settings.hooks) {
     settings.hooks = {};
   }
 
-  // Find coder-config hooks directory
   const hooksSrcDir = path.join(__dirname, '..', 'hooks');
   const sessionStartHook = path.join(hooksSrcDir, 'session-start.sh');
-  const sessionEndHook = path.join(hooksSrcDir, 'session-end.sh');
 
-  // Verify hooks exist
-  if (!fs.existsSync(sessionStartHook) || !fs.existsSync(sessionEndHook)) {
-    console.error('Session hooks not found in coder-config package.');
-    console.log('Expected locations:');
-    console.log(`  ${sessionStartHook}`);
-    console.log(`  ${sessionEndHook}`);
+  if (!fs.existsSync(sessionStartHook)) {
+    console.error('Session hook not found:', sessionStartHook);
     return;
   }
 
-  // Make hooks executable
   try {
     fs.chmodSync(sessionStartHook, '755');
-    fs.chmodSync(sessionEndHook, '755');
   } catch (e) {
-    console.warn('Could not set executable permission on hooks:', e.message);
+    // Continue even if chmod fails
   }
 
   // Add SessionStart hook
@@ -198,54 +126,30 @@ function installHooks() {
     settings.hooks.SessionStart = [settings.hooks.SessionStart];
   }
 
-  // Check if our hook is already installed
-  const startHookEntry = { type: 'command', command: sessionStartHook };
   const hasStartHook = settings.hooks.SessionStart.some(h =>
     typeof h === 'object' && h.command === sessionStartHook
   );
   if (!hasStartHook) {
-    settings.hooks.SessionStart.push(startHookEntry);
-  }
-
-  // Add SessionEnd hook
-  if (!settings.hooks.SessionEnd) {
-    settings.hooks.SessionEnd = [];
-  }
-  if (!Array.isArray(settings.hooks.SessionEnd)) {
-    settings.hooks.SessionEnd = [settings.hooks.SessionEnd];
+    settings.hooks.SessionStart.push({ type: 'command', command: sessionStartHook });
   }
 
-  const endHookEntry = { type: 'command', command: sessionEndHook };
-  const hasEndHook = settings.hooks.SessionEnd.some(h =>
-    typeof h === 'object' && h.command === sessionEndHook
-  );
-  if (!hasEndHook) {
-    settings.hooks.SessionEnd.push(endHookEntry);
-  }
-
-  // Save settings
   try {
     fs.writeFileSync(settingsFile, JSON.stringify(settings, null, 2));
-    console.log('Session hooks installed.\n');
-    console.log('Hooks added:');
-    console.log('  - SessionStart: Restores saved context');
-    console.log('  - SessionEnd: Preserves flushed context\n');
-    console.log('To save context before exiting, use /flush in Claude Code.');
-    console.log('The saved context will be restored on the next session start.');
+    console.log('Session hook installed.\n');
+    console.log('SessionStart hook restores context from .claude/session-context.md');
+    console.log('Use /flush in Claude Code to save context.');
   } catch (e) {
     console.error('Error writing settings.json:', e.message);
   }
 }
 
 /**
- * Get flushed context content (for hooks)
+ * Get flushed context content
  */
-function getFlushedContext() {
-  if (fs.existsSync(LAST_FLUSHED_FILE)) {
-    return fs.readFileSync(LAST_FLUSHED_FILE, 'utf8');
-  }
-  if (fs.existsSync(FLUSHED_CONTEXT_FILE)) {
-    return fs.readFileSync(FLUSHED_CONTEXT_FILE, 'utf8');
+function getFlushedContext(projectDir = process.cwd()) {
+  const contextFile = path.join(projectDir, '.claude', 'session-context.md');
+  if (fs.existsSync(contextFile)) {
+    return fs.readFileSync(contextFile, 'utf8');
   }
   return null;
 }
@@ -258,21 +162,17 @@ function installFlushCommand() {
   const commandsDir = path.join(claudeDir, 'commands');
   const destFile = path.join(commandsDir, 'flush.md');
 
-  // Find the template
   const templateFile = path.join(__dirname, '..', 'templates', 'commands', 'flush.md');
 
   if (!fs.existsSync(templateFile)) {
     console.error('Flush command template not found.');
-    console.log(`Expected: ${templateFile}`);
     return false;
   }
 
-  // Ensure commands directory exists
   if (!fs.existsSync(commandsDir)) {
     fs.mkdirSync(commandsDir, { recursive: true });
   }
 
-  // Check if command already exists
   if (fs.existsSync(destFile)) {
     const existing = fs.readFileSync(destFile, 'utf8');
     const template = fs.readFileSync(templateFile, 'utf8');
@@ -280,15 +180,10 @@ function installFlushCommand() {
       console.log('/flush command already installed.');
       return true;
     }
-    // Backup existing
-    const backupFile = path.join(commandsDir, 'flush.md.bak');
-    fs.copyFileSync(destFile, backupFile);
-    console.log(`Backed up existing /flush to ${backupFile}`);
   }
 
-  // Copy template
   fs.copyFileSync(templateFile, destFile);
-  console.log('/flush command installed to ~/.claude/commands/flush.md');
+  console.log('/flush command installed.');
   return true;
 }
 
@@ -297,17 +192,10 @@ function installFlushCommand() {
  */
 function installAll() {
   console.log('Installing session persistence...\n');
-
-  // Install hooks
   installHooks();
-
   console.log('');
-
-  // Install command
   installFlushCommand();
-
-  console.log('\nSession persistence setup complete!');
-  console.log('Use /flush in Claude Code to save context before exiting.');
+  console.log('\nUse /flush in Claude Code to save context before exiting.');
 }
 
 module.exports = {
@@ -319,6 +207,4 @@ module.exports = {
   getFlushedContext,
   installFlushCommand,
   installAll,
-  SESSION_DIR,
-  FLUSHED_CONTEXT_FILE,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coder-config",
-  "version": "0.42.30",
+  "version": "0.42.31",
   "description": "Configuration manager for AI coding tools - Claude Code, Gemini CLI, Codex CLI, Antigravity. Manage MCPs, rules, permissions, memory, and workstreams.",
   "author": "regression.io",
   "main": "config-loader.js",

package/templates/commands/flush.md

@@ -1,6 +1,6 @@
 # Flush Context to Resumable Doc
 
-Save all current session context to a resumable document that will be automatically restored on the next session start.
+Save all current session context to a resumable document in the current project's `.claude/` directory.
 
 ## Instructions
 
@@ -12,9 +12,11 @@ Save all current session context to a resumable document that will be automatica
    - **Pending Work**: What still needs to be done
    - **Important Context**: Any critical information needed to continue
 
-2. Write this summary to: `~/.coder-config/sessions/flushed-context.md`
+2. Determine the project root (where `.git/` or `.claude/` exists) and write this summary to: `<project-root>/.claude/session-context.md`
+   - If `.claude/` directory doesn't exist, create it
+   - This keeps the context local to this specific project
 
-3. Confirm to the user that context has been saved and will be restored on next session.
+3. Confirm to the user that context has been saved to the project directory and will be available on the next session in this project.
 
 ## Output Format