Skip to content

Instantly share code, notes, and snippets.

@pythoninthegrass
Created January 14, 2026 21:13
Show Gist options
  • Select an option

  • Save pythoninthegrass/fb2e436e2bbf09386d9e6ab27d2a9696 to your computer and use it in GitHub Desktop.

Select an option

Save pythoninthegrass/fb2e436e2bbf09386d9e6ab27d2a9696 to your computer and use it in GitHub Desktop.
Headroom proxy server launchagent to reduce LLM context size
<?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>
@pythoninthegrass
Copy link
Author

@pythoninthegrass
Copy link
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