notes-watcher

I write a note on my iPhone, and the AI codes the feature and merges it automatically.

The idea here is that the quality of what you build is no longer limited by the time spent coding, but by the quality of the ideas you have. A thought on the subway, an idea in the shower, a question at 11pm: instead of vanishing, they become commits. You no longer need to have your head in the code for every impulse. The idea becomes the project.

It's not always perfect. Claude Code makes a first pass, sometimes you need to iterate. But the threshold has been crossed: intent is enough to trigger the work.

iPhone (Apple Notes)
    |
    v
iCloud sync
    |
    v
Mac mini (python -m watcher, every 60s)
    |
    |-- task       -> Claude Code opens a Terminal, codes and merges
    |
    +-- reflection -> response written directly in the note

The watcher queries Apple Notes via AppleScript, sends each unprocessed note to Claude Code for analysis (claude -p), then acts on the result. A note can contain multiple independent items, each processed separately.

• Automatic monitoring of an Apple Notes folder via launchd
• Intelligent analysis via Claude Code CLI (task or reflection)
• Multi-item support per note
• Claude Code launched in a dedicated Terminal per task
• Git operations hardcoded in the shell script (checkout, branch, commit, merge)
• Structured response written directly in the note for reflections
• Existing code detection (#claude-exists)
• Push notifications via Pushover

• macOS (Mac mini recommended, always on)
• Python 3
• Claude Code CLI installed and authenticated
• Pushover account

1. Clone the repo:

   git clone <repo-url>
   cd notes-watcher

2. Copy and fill in the configuration:

   cp config.example.json config.json

3. Install the launchd agent:

   chmod +x install.sh
   ./install.sh

The watcher runs in the background, every 60 seconds.

Do not install the project under ~/Documents/. macOS TCC denies file access in ~/Documents/ to processes spawned by launchd, which makes the watcher fail silently with exit 78 (PermissionError: [Errno 1] Operation not permitted). Use a path outside ~/Documents/ (e.g. ~/code/notes-agent/).

Important: Claude Code runs with --dangerously-skip-permissions for unattended operation. Each target repo must have a well-configured .claude/CLAUDE.md before being used with the watcher. This file acts as the primary guardrail for autonomous code generation.

Python · AppleScript · launchd · Claude Code CLI · Pushover · Git