Created
January 14, 2026 21:13
-
-
Save pythoninthegrass/fb2e436e2bbf09386d9e6ab27d2a9696 to your computer and use it in GitHub Desktop.
Headroom proxy server launchagent to reduce LLM context size
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| <?xml version="1.0" encoding="UTF-8"?> | |
| <!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.headroom.proxy</string> | |
| <key>ProgramArguments</key> | |
| <array> | |
| <string>/Users/lance/.local/bin/headroom</string> | |
| <string>proxy</string> | |
| <string>--port</string> | |
| <string>8787</string> | |
| </array> | |
| <key>KeepAlive</key> | |
| <true/> | |
| <key>RunAtLoad</key> | |
| <true/> | |
| <key>StandardOutPath</key> | |
| <string>/tmp/headroom-proxy.log</string> | |
| <key>StandardErrorPath</key> | |
| <string>/tmp/headroom-proxy.err</string> | |
| <key>EnvironmentVariables</key> | |
| <dict> | |
| <key>PATH</key> | |
| <string>/Users/lance/.local/bin:/usr/local/bin:/usr/bin:/bin</string> | |
| </dict> | |
| </dict> | |
| </plist> |
Author
Author
# install via uv w/valid httpx
uv tool install 'headroom-ai[proxy]' --force --with 'httpx<1.0' --with 'httpx[http2]<1.0'
# copy launchagent to ~/Library/LaunchAgents
# load launchagent
launchctl load ~/Library/LaunchAgents/com.user.headroom.proxy.plist
# smoke test
curl http://localhost:8787/health
# watch logs
tail -f /tmp/headroom-proxy.log
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
https://github.com/chopratejas/headroom