From 068ea2fb06f1f987366ea128f06939b666d95abe Mon Sep 17 00:00:00 2001
From: Colin L <colin@colins-mbp-2.lan>
Date: Wed, 29 Apr 2026 19:33:13 -0700
Subject: [PATCH] feat: add macOS launchd agent sample for autostart

Off-by-default sample launchd plist for users who want the proxy to
start at login and stay up automatically. Placeholder REPO_ROOT must
be substituted with the user's clone path before loading. Install
instructions are in the plist's leading XML comment.

User-level LaunchAgent (~/Library/LaunchAgents) rather than a
LaunchDaemon, so it doesn't require sudo and dies cleanly at logout.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 contrib/claude-code-proxy.plist.example | 49 +++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 contrib/claude-code-proxy.plist.example

diff --git a/contrib/claude-code-proxy.plist.example b/contrib/claude-code-proxy.plist.example
new file mode 100644
index 00000000..908309ae
--- /dev/null
+++ b/contrib/claude-code-proxy.plist.example
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  launchd agent that keeps claude-code-proxy running on macOS.
+
+  Install:
+    1. Replace REPO_ROOT below with the absolute path to your clone, e.g.
+       /Users/you/src/claude-code-proxy
+    2. cp contrib/claude-code-proxy.plist.example \
+         ~/Library/LaunchAgents/com.user.claude-code-proxy.plist
+    3. launchctl load ~/Library/LaunchAgents/com.user.claude-code-proxy.plist
+
+  Stop / unload:
+    launchctl unload ~/Library/LaunchAgents/com.user.claude-code-proxy.plist
+
+  Logs:
+    tail -f /tmp/claude-code-proxy.log
+
+  This is a user-level LaunchAgent (runs at login, dies at logout). Use
+  /Library/LaunchDaemons + sudo if you need a system-wide variant.
+-->
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
+  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.user.claude-code-proxy</string>
+
+  <key>ProgramArguments</key>
+  <array>
+    <string>REPO_ROOT/.venv/bin/python</string>
+    <string>REPO_ROOT/start_proxy.py</string>
+  </array>
+
+  <key>WorkingDirectory</key>
+  <string>REPO_ROOT</string>
+
+  <key>RunAtLoad</key>
+  <true/>
+
+  <key>KeepAlive</key>
+  <true/>
+
+  <key>StandardOutPath</key>
+  <string>/tmp/claude-code-proxy.log</string>
+
+  <key>StandardErrorPath</key>
+  <string>/tmp/claude-code-proxy.log</string>
+</dict>
+</plist>