Code Diary Hook

A Claude Code hook that automatically logs git commits and PR operations as completed Reminders in Apple's Reminders app. Creates a searchable diary of code changes that syncs across all your devices via iCloud.

How It Works

The hook runs as a PostToolUse handler on every Bash tool call. It inspects the command for git/GitHub CLI patterns and exits immediately (~16ms) for anything else. When it detects a commit or PR operation, it creates a completed Reminder in the "Code" list with relevant details.

Claude Code runs `git commit` or `gh pr create/merge`
        ↓
PostToolUse fires → code-diary.sh receives JSON on stdin
        ↓
Parses command, extracts details (message, hash, PR URL, etc.)
        ↓
Creates a completed Reminder via reminders-cli (EventKit)
        ↓
Entry appears in Reminders → syncs to all devices via iCloud

Tracked Events

Event	Reminder Title	Notes
git commit	ProjectName - Commit	Branch, hash, commit message, file stats, repo URL, timestamp
gh pr create	ProjectName - PR Created	Branch, PR title, PR URL, timestamp
gh pr merge	ProjectName - PR Merged	Branch, PR number, merge message, repo URL, timestamp

Project name is derived from the git remote URL, falling back to the directory name.

Prerequisites

• macOS
• reminders-cli — native EventKit CLI, no AppleScript
• jq — JSON parsing
• Claude Code

Install

git clone git@github.com:welshofer/code-diary-hook.git
cd code-diary-hook
./install.sh

The install script will:

1. Check for dependencies (offers to install via Homebrew if missing)
2. Copy code-diary.sh to ~/.claude/hooks/
3. Create the "Code" list in Reminders if it doesn't exist
4. Register the hook in ~/.claude/settings.json

Uninstall

cd code-diary-hook
./uninstall.sh

Removes the hook script and its entry from settings.json. The "Code" Reminders list is preserved.

Manual Install

If you prefer to set it up by hand:

1. Copy the hook:

   mkdir -p ~/.claude/hooks
   cp code-diary.sh ~/.claude/hooks/code-diary.sh
   chmod +x ~/.claude/hooks/code-diary.sh

2. Add to ~/.claude/settings.json under hooks.PostToolUse:

   {
     "matcher": "Bash",
     "hooks": [
       {
         "type": "command",
         "command": "/Users/YOUR_USERNAME/.claude/hooks/code-diary.sh",
         "timeout": 5
       }
     ]
   }

3. Create the Reminders list:

   reminders new-list "Code"

Browsing Your Diary

• All entries: Open Reminders app → "Code" list → Show Completed
• Filter by project: Search for the project name (e.g. "myapp")
• Filter by action: Search for "Commit", "PR Created", or "PR Merged"

Testing

Simulate a commit payload to verify the hook works:

echo '{"tool_name":"Bash","tool_input":{"command":"git commit -m \"test\""},"tool_response":"[main abc1234] test\n 1 file changed","cwd":"/tmp/test"}' | ~/.claude/hooks/code-diary.sh

Check the "Code" list in Reminders — a completed entry should appear.

Design Notes

• No AppleScript — uses reminders-cli which calls EventKit directly. Works headless, no GUI required.
• Non-blocking — trap 'exit 0' ERR ensures the hook never interferes with Claude Code, even if something fails.
• Fast bail — non-git commands exit in ~16ms (jq parse + grep, no Reminders interaction).
• 5-second timeout — if the hook hangs for any reason, Claude Code kills it and continues.