oh-my-customcode 0.1.0

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "oh-my-customcode",
+  "version": "0.1.0",
+  "description": "Batteries-included agent harness for Claude Code",
+  "type": "module",
+  "bin": {
+    "omcc": "./dist/cli/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "dev": "bun run src/cli/index.ts",
+    "build": "bun build src/cli/index.ts --outdir dist/cli --target node && bun build src/index.ts --outdir dist --target node",
+    "test": "bun test",
+    "test:unit": "bun test tests/unit",
+    "test:integration": "bun test tests/integration",
+    "test:e2e": "bun test tests/e2e",
+    "test:coverage": "bun test --coverage",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "typecheck": "tsc --noEmit",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "prepare": "sh scripts/setup-hooks.sh || true",
+    "setup:hooks": "sh scripts/setup-hooks.sh",
+    "prepublishOnly": "bun run build && bun run test"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "i18next": "^24.2.2",
+    "yaml": "^2.8.2"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/bun": "^1.2.4",
+    "typescript": "^5.7.3",
+    "vitepress": "^1.6.3"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "agent",
+    "cli"
+  ],
+  "author": "baekenough",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/baekenough/oh-my-customcode.git"
+  },
+  "bugs": {
+    "url": "https://github.com/baekenough/oh-my-customcode/issues"
+  },
+  "homepage": "https://github.com/baekenough/oh-my-customcode#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/templates/.claude/contexts/dev.md

@@ -0,0 +1,20 @@
+# Development Context
+
+Mode: Active development
+Focus: Implementation, coding, building features
+
+## Behavior
+- Write code first, explain after
+- Prefer working solutions over perfect solutions
+- Run tests after changes
+- Keep commits atomic
+
+## Priorities
+1. Get it working
+2. Get it right
+3. Get it clean
+
+## Tools to favor
+- Edit, Write for code changes
+- Bash for running tests/builds
+- Grep, Glob for finding code

package/templates/.claude/contexts/ecomode.md

@@ -0,0 +1,63 @@
+# Ecomode Context
+
+> Activated when token efficiency is critical
+
+## When Active
+
+This context is loaded when ecomode is activated (4+ parallel tasks, batch operations, or near compaction).
+
+## Instructions for Agents
+
+### Output Rules
+
+1. **Status first**: Always start with status indicator
+2. **One-liner summary**: Compress results to 1-2 sentences
+3. **Skip verbose**: No intermediate steps, no repeated context
+4. **Use references**: File paths instead of contents
+
+### Format Template
+
+```
+[{agent-name}] {status_icon} {target}: {summary}
+```
+
+### Status Icons
+
+| Icon | Meaning |
+|------|---------|
+| ✓ | Success |
+| ✗ | Failed |
+| ⚠ | Partial/Warning |
+| ⏳ | In progress |
+
+### Examples
+
+Good (ecomode):
+```
+[golang-expert] ✓ src/main.go: 3 issues found (2 style, 1 error handling)
+```
+
+Bad (verbose):
+```
+I have completed the review of src/main.go. The file contains...
+[long explanation]
+```
+
+## Aggregation
+
+When secretary aggregates results:
+
+```
+[Batch Complete] 4/4
+├── golang-expert: ✓ 3 issues in 2 files
+├── python-expert: ✓ Clean, no issues
+├── rust-expert: ⚠ 1 warning (unsafe block)
+└── typescript-expert: ✓ 5 suggestions
+```
+
+## Exit Conditions
+
+Ecomode deactivates when:
+- User requests "verbose" or "full details"
+- Single task execution
+- Explicit "ecomode off"

package/templates/.claude/contexts/index.yaml

@@ -0,0 +1,41 @@
+# Claude Code Contexts Configuration
+# Source: https://github.com/affaan-m/everything-claude-code
+
+contexts:
+  dev:
+    file: dev.md
+    mode: Active development
+    focus: Implementation, coding, building features
+    priority: Working > Correct > Clean
+
+  review:
+    file: review.md
+    mode: PR review and code analysis
+    focus: Quality, security, maintainability
+    checklist:
+      - Logic correctness
+      - Error handling
+      - Security
+      - Performance
+      - Readability
+      - Test coverage
+
+  research:
+    file: research.md
+    mode: Exploration and investigation
+    focus: Understanding before acting
+    process:
+      - Understand question
+      - Explore code/docs
+      - Form hypotheses
+      - Validate with evidence
+      - Summarize findings
+
+usage:
+  description: |
+    Use contexts to change Claude's behavior mode.
+    Include the context file content in your prompt or
+    reference it at the start of a session.
+  example: |
+    "Using review context, analyze this PR..."
+    "In dev mode, implement this feature..."

package/templates/.claude/contexts/research.md

@@ -0,0 +1,28 @@
+# Research Context
+
+Mode: Exploration and investigation
+Focus: Understanding before acting
+
+## Behavior
+- Read widely before concluding
+- Ask clarifying questions
+- Document findings as you go
+- Understand before writing code
+
+## Research Process
+1. Understand the question
+2. Explore relevant code/docs
+3. Form hypotheses
+4. Validate with evidence
+5. Summarize findings
+
+## Tools to favor
+- Read for understanding code
+- Grep, Glob for pattern discovery
+- WebFetch for external docs
+- Task (Explore) for codebase queries
+
+## Output Format
+- Findings first
+- Recommendations second
+- Uncertainties noted

package/templates/.claude/contexts/review.md

@@ -0,0 +1,23 @@
+# Code Review Context
+
+Mode: PR review and code analysis
+Focus: Quality, security, maintainability
+
+## Behavior
+- Read thoroughly before commenting
+- Organize findings by severity
+- Suggest fixes, not just problems
+- Check for security vulnerabilities
+
+## Review Checklist
+1. Logic correctness and edge cases
+2. Error handling and exceptions
+3. Security concerns (injection, credentials)
+4. Performance implications
+5. Code readability
+6. Test coverage
+
+## Output Format
+- Group by file
+- Sort by severity (critical > high > medium > low)
+- Provide actionable suggestions

package/templates/.claude/hooks/hooks.json

@@ -0,0 +1,185 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "tool == \"Bash\" && tool_input.command matches \"(npm run dev|pnpm( run)? dev|yarn dev|bun run dev)\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\ncmd=$(echo \"$input\" | jq -r '.tool_input.command // \"\"')\n\n# Block dev servers that aren't run in tmux\necho '[Hook] BLOCKED: Dev server must run in tmux for log access' >&2\necho '[Hook] Use this command instead:' >&2\necho \"[Hook] tmux new-session -d -s dev 'npm run dev'\" >&2\necho '[Hook] Then: tmux attach -t dev' >&2\nexit 1"
+          }
+        ],
+        "description": "Block dev servers outside tmux - ensures you can access logs"
+      },
+      {
+        "matcher": "tool == \"Bash\" && tool_input.command matches \"(npm (install|test)|pnpm (install|test)|yarn (install|test)|bun (install|test)|cargo build|make|docker|pytest|vitest|playwright)\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nif [ -z \"$TMUX\" ]; then\n  echo '[Hook] Consider running in tmux for session persistence' >&2\n  echo '[Hook] tmux new -s dev  |  tmux attach -t dev' >&2\nfi\necho \"$input\""
+          }
+        ],
+        "description": "Reminder to use tmux for long-running commands"
+      },
+      {
+        "matcher": "tool == \"Bash\" && tool_input.command matches \"git push\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\necho '[Hook] Review changes before push...' >&2\necho '[Hook] Press Enter to continue with push or Ctrl+C to abort...' >&2\nread -r"
+          }
+        ],
+        "description": "Pause before git push to review changes"
+      },
+      {
+        "matcher": "tool == \"Write\" && tool_input.file_path matches \"\\\\.(md|txt)$\" && !(tool_input.file_path matches \"README\\\\.md|CLAUDE\\\\.md|AGENT\\\\.md|SKILL\\\\.md\")",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nfile_path=$(echo \"$input\" | jq -r '.tool_input.file_path // \"\"')\n\nif [[ \"$file_path\" =~ \\.(md|txt)$ ]] && [[ ! \"$file_path\" =~ (README|CLAUDE|AGENT|SKILL)\\.md$ ]]; then\n  echo \"[Hook] BLOCKED: Unnecessary documentation file creation\" >&2\n  echo \"[Hook] File: $file_path\" >&2\n  echo \"[Hook] Use README.md or AGENT.md for documentation instead\" >&2\n  exit 1\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Block creation of random .md files - keeps docs consolidated"
+      },
+      {
+        "matcher": "tool == \"Edit\" || tool == \"Write\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/strategic-compact/suggest-compact.sh"
+          }
+        ],
+        "description": "Suggest manual compaction at logical intervals"
+      },
+      {
+        "matcher": "tool == \"Task\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nagent=$(echo \"$input\" | jq -r '.tool_input.description // \"agent\"' | head -c 30)\n~/.claude/hooks/hud/update-status.sh \"$agent\" \"\" \"1\"\necho \"$input\""
+          }
+        ],
+        "description": "HUD statusline - show agent spawn via Task tool"
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/memory-persistence/pre-compact.sh"
+          }
+        ],
+        "description": "Save state before context compaction"
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/memory-persistence/session-start.sh"
+          }
+        ],
+        "description": "Load previous context on new session"
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "tool == \"Bash\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\ncmd=$(echo \"$input\" | jq -r '.tool_input.command')\n\nif echo \"$cmd\" | grep -qE 'gh pr create'; then\n  output=$(echo \"$input\" | jq -r '.tool_output.output // \"\"')\n  pr_url=$(echo \"$output\" | grep -oE 'https://github.com/[^/]+/[^/]+/pull/[0-9]+')\n  \n  if [ -n \"$pr_url\" ]; then\n    echo \"[Hook] PR created: $pr_url\" >&2\n    echo \"[Hook] Checking GitHub Actions status...\" >&2\n    repo=$(echo \"$pr_url\" | sed -E 's|https://github.com/([^/]+/[^/]+)/pull/[0-9]+|\\1|')\n    pr_num=$(echo \"$pr_url\" | sed -E 's|.*/pull/([0-9]+)|\\1|')\n    echo \"[Hook] To review PR: gh pr review $pr_num --repo $repo\" >&2\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Log PR URL and provide review command after PR creation"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nfile_path=$(echo \"$input\" | jq -r '.tool_input.file_path // \"\"')\n\nif [ -n \"$file_path\" ] && [ -f \"$file_path\" ]; then\n  if command -v prettier >/dev/null 2>&1; then\n    prettier --write \"$file_path\" 2>&1 | head -5 >&2\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Auto-format JS/TS files with Prettier after edits"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nfile_path=$(echo \"$input\" | jq -r '.tool_input.file_path // \"\"')\n\nif [ -n \"$file_path\" ] && [ -f \"$file_path\" ]; then\n  dir=$(dirname \"$file_path\")\n  project_root=\"$dir\"\n  while [ \"$project_root\" != \"/\" ] && [ ! -f \"$project_root/package.json\" ]; do\n    project_root=$(dirname \"$project_root\")\n  done\n  \n  if [ -f \"$project_root/tsconfig.json\" ]; then\n    cd \"$project_root\" && npx tsc --noEmit --pretty false 2>&1 | grep \"$file_path\" | head -10 >&2 || true\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "TypeScript check after editing .ts/.tsx files"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nfile_path=$(echo \"$input\" | jq -r '.tool_input.file_path // \"\"')\n\nif [ -n \"$file_path\" ] && [ -f \"$file_path\" ]; then\n  console_logs=$(grep -n \"console\\\\.log\" \"$file_path\" 2>/dev/null || true)\n  \n  if [ -n \"$console_logs\" ]; then\n    echo \"[Hook] WARNING: console.log found in $file_path\" >&2\n    echo \"$console_logs\" | head -5 >&2\n    echo \"[Hook] Remove console.log before committing\" >&2\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Warn about console.log statements after edits"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(go)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nfile_path=$(echo \"$input\" | jq -r '.tool_input.file_path // \"\"')\n\nif [ -n \"$file_path\" ] && [ -f \"$file_path\" ]; then\n  if command -v gofmt >/dev/null 2>&1; then\n    gofmt -w \"$file_path\" 2>&1 >&2\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Auto-format Go files with gofmt after edits"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(py)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nfile_path=$(echo \"$input\" | jq -r '.tool_input.file_path // \"\"')\n\nif [ -n \"$file_path\" ] && [ -f \"$file_path\" ]; then\n  # Format with ruff\n  if command -v ruff >/dev/null 2>&1; then\n    ruff format --quiet \"$file_path\" 2>&1 >&2\n    ruff check --fix --quiet \"$file_path\" 2>&1 >&2 || true\n    echo \"[Hook] Python formatted with ruff\" >&2\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Auto-format and lint Python files with ruff after edits"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(py)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nfile_path=$(echo \"$input\" | jq -r '.tool_input.file_path // \"\"')\n\nif [ -n \"$file_path\" ] && [ -f \"$file_path\" ]; then\n  # Type check with ty\n  if command -v ty >/dev/null 2>&1; then\n    dir=$(dirname \"$file_path\")\n    project_root=\"$dir\"\n    while [ \"$project_root\" != \"/\" ] && [ ! -f \"$project_root/pyproject.toml\" ]; do\n      project_root=$(dirname \"$project_root\")\n    done\n    \n    if [ -f \"$project_root/pyproject.toml\" ]; then\n      cd \"$project_root\" && ty check \"$file_path\" 2>&1 | head -10 >&2 || true\n    else\n      ty check \"$file_path\" 2>&1 | head -10 >&2 || true\n    fi\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Type check Python files with ty after edits"
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\n\nif git rev-parse --git-dir > /dev/null 2>&1; then\n  modified_files=$(git diff --name-only HEAD 2>/dev/null | grep -E '\\.(ts|tsx|js|jsx)$' || true)\n  \n  if [ -n \"$modified_files\" ]; then\n    has_console=false\n    while IFS= read -r file; do\n      if [ -f \"$file\" ]; then\n        if grep -q \"console\\.log\" \"$file\" 2>/dev/null; then\n          echo \"[Hook] WARNING: console.log found in $file\" >&2\n          has_console=true\n        fi\n      fi\n    done <<< \"$modified_files\"\n    \n    if [ \"$has_console\" = true ]; then\n      echo \"[Hook] Remove console.log statements before committing\" >&2\n    fi\n  fi\nfi\n\necho \"$input\""
+          }
+        ],
+        "description": "Final audit for console.log in modified files before session ends"
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/memory-persistence/session-end.sh"
+          }
+        ],
+        "description": "Persist session state on end"
+      }
+    ]
+  }
+}

package/templates/.claude/hooks/hud/index.yaml

@@ -0,0 +1,27 @@
+# HUD Statusline Hooks
+# Provides real-time status display during agent operations
+
+name: hud-statusline
+description: Real-time status display during operations
+rule: R012 (SHOULD-hud-statusline)
+
+scripts:
+  - name: update-status
+    path: ./update-status.sh
+    description: Update HUD statusline with agent/progress/parallel info
+    usage: update-status.sh <agent> [progress] [parallel_count]
+
+triggers:
+  - PreToolUse (Task)
+  - PostToolUse (Task)
+  - Agent activation
+  - Parallel spawn/complete
+
+components:
+  agent: Current agent name
+  progress: Task progress (n/total)
+  parallel: Parallel instance count
+
+installation:
+  step1: "chmod +x ~/.claude/hooks/hud/update-status.sh"
+  step2: "Hook is called automatically or manually via script"

package/templates/.claude/hooks/hud/update-status.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+# HUD Statusline Hook - Update status display
+#
+# Displays real-time status information during agent operations.
+# Output via stderr to avoid polluting tool output.
+#
+# Usage: update-status.sh <agent> [progress] [parallel_count]
+#
+# Examples:
+#   update-status.sh "creator" "1/3"
+#   update-status.sh "secretary" "0/4" "4"
+#   update-status.sh "golang-expert"
+
+AGENT="${1:-claude}"
+PROGRESS="${2:-}"
+PARALLEL="${3:-0}"
+
+# Build status line
+STATUS="[Agent] $AGENT"
+
+# Add progress if provided
+if [ -n "$PROGRESS" ]; then
+  STATUS="$STATUS | [Progress] $PROGRESS"
+fi
+
+# Add parallel count if > 0
+if [ "$PARALLEL" -gt 0 ] 2>/dev/null; then
+  STATUS="$STATUS | [Parallel] $PARALLEL"
+fi
+
+# Output to stderr to avoid polluting tool output
+echo "─── $STATUS ───" >&2

package/templates/.claude/hooks/index.yaml

@@ -0,0 +1,46 @@
+# Claude Code Hooks Configuration
+# Source: https://github.com/affaan-m/everything-claude-code
+
+hooks:
+  PreToolUse:
+    - dev-server-tmux-guard
+    - long-running-tmux-reminder
+    - git-push-review-pause
+    - md-file-creation-block
+    - strategic-compact-suggester
+    - hud-statusline (Task)
+
+  PreCompact:
+    - memory-persistence/pre-compact
+
+  SessionStart:
+    - memory-persistence/session-start
+
+  PostToolUse:
+    - pr-creation-logger
+    - prettier-auto-format (js/ts)
+    - typescript-checker
+    - console-log-warner
+    - gofmt-auto-format (go)
+    - ruff-format-and-lint (python)
+    - ty-type-check (python)
+
+  Stop:
+    - console-log-final-audit
+    - memory-persistence/session-end
+
+scripts:
+  memory-persistence:
+    - pre-compact.sh
+    - session-start.sh
+    - session-end.sh
+  strategic-compact:
+    - suggest-compact.sh
+  hud:
+    - update-status.sh
+
+installation:
+  step1: "Copy hooks.json content to ~/.claude/settings.json"
+  step2: "Copy scripts to ~/.claude/hooks/"
+  step3: "chmod +x ~/.claude/hooks/**/*.sh"
+  step4: "Create ~/.claude/sessions/ and ~/.claude/skills/learned/"

package/templates/.claude/hooks/memory-persistence/pre-compact.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+# PreCompact Hook - Save state before context compaction
+#
+# Runs before Claude compacts context. Logs the event and marks
+# active session files so you know when compaction occurred.
+#
+# Hook config (in ~/.claude/settings.json):
+# {
+#   "hooks": {
+#     "PreCompact": [{
+#       "matcher": "*",
+#       "hooks": [{
+#         "type": "command",
+#         "command": "~/.claude/hooks/memory-persistence/pre-compact.sh"
+#       }]
+#     }]
+#   }
+# }
+
+SESSIONS_DIR="${HOME}/.claude/sessions"
+LOG_FILE="${SESSIONS_DIR}/compaction-log.txt"
+
+mkdir -p "$SESSIONS_DIR"
+
+# Log the compaction event
+echo "[$(date '+%Y-%m-%d %H:%M:%S')] Context compaction triggered" >> "$LOG_FILE"
+
+# Find and mark active session file
+ACTIVE_SESSION=$(find "$SESSIONS_DIR" -name "*.tmp" -mmin -60 2>/dev/null | head -1)
+if [ -n "$ACTIVE_SESSION" ] && [ -f "$ACTIVE_SESSION" ]; then
+  echo "" >> "$ACTIVE_SESSION"
+  echo "---" >> "$ACTIVE_SESSION"
+  echo "**[COMPACTION]** Context compacted at $(date '+%H:%M')" >> "$ACTIVE_SESSION"
+  echo "---" >> "$ACTIVE_SESSION"
+fi
+
+echo "[PreCompact] State preserved before compaction" >&2

package/templates/.claude/hooks/memory-persistence/session-end.sh

@@ -0,0 +1,64 @@
+#!/bin/bash
+# Stop Hook (Session End) - Persist learnings when session ends
+#
+# Runs when Claude session ends. Creates/updates session log file
+# with timestamp for continuity tracking.
+#
+# Hook config (in ~/.claude/settings.json):
+# {
+#   "hooks": {
+#     "Stop": [{
+#       "matcher": "*",
+#       "hooks": [{
+#         "type": "command",
+#         "command": "~/.claude/hooks/memory-persistence/session-end.sh"
+#       }]
+#     }]
+#   }
+# }
+
+SESSIONS_DIR="${HOME}/.claude/sessions"
+TODAY=$(date '+%Y-%m-%d')
+SESSION_FILE="${SESSIONS_DIR}/${TODAY}-session.tmp"
+
+mkdir -p "$SESSIONS_DIR"
+
+# If session file exists for today, update the end time
+if [ -f "$SESSION_FILE" ]; then
+  # Update Last Updated timestamp (macOS and Linux compatible)
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    sed -i '' "s/\*\*Last Updated:\*\*.*/\*\*Last Updated:\*\* $(date '+%H:%M')/" "$SESSION_FILE" 2>/dev/null
+  else
+    sed -i "s/\*\*Last Updated:\*\*.*/\*\*Last Updated:\*\* $(date '+%H:%M')/" "$SESSION_FILE" 2>/dev/null
+  fi
+  echo "[SessionEnd] Updated session file: $SESSION_FILE" >&2
+else
+  # Create new session file with template
+  cat > "$SESSION_FILE" << EOF
+# Session: $(date '+%Y-%m-%d')
+**Date:** $TODAY
+**Started:** $(date '+%H:%M')
+**Last Updated:** $(date '+%H:%M')
+
+---
+
+## Current State
+
+[Session context goes here]
+
+### Completed
+- [ ]
+
+### In Progress
+- [ ]
+
+### Notes for Next Session
+-
+
+### Context to Load
+\`\`\`
+[relevant files]
+\`\`\`
+EOF
+  echo "[SessionEnd] Created session file: $SESSION_FILE" >&2
+fi