cw-hans/hans-tools
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(gh-monitor): replace OpenClaw cron with launchd — zero polling token cost

Browse Source
This commit is contained in:
Hans Heinemann
2026-03-15 17:30:10 -04:00
parent 9f23deb309
commit 82f0cdb413
2 changed files with 47 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

55
gh-monitor/buildspec.md
View File

@@ -140,24 +140,49 @@ Function:
Entry point: `if __name__ == "__main__": main()` Entry point: `if __name__ == "__main__": main()`
### STEP 10 — OpenClaw cron job ### STEP 10 — macOS LaunchAgent
Register via OpenClaw cron API: Create `~/Library/LaunchAgents/com.hans.gh-monitor.plist`:
```json
{ ```xml
"name": "gh-monitor", <?xml version="1.0" encoding="UTF-8"?>
"schedule": { "kind": "every", "everyMs": 300000 }, <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
"payload": { "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
"kind": "systemEvent", <plist version="1.0">
"text": "Run GitHub PR monitor: cd ~/Projects/hans-tools/gh-monitor && python3 poll.py" <dict>
}, <key>Label</key>
"sessionTarget": "main" <string>com.hans.gh-monitor</string>
} <key>ProgramArguments</key>
<array>
<string>/usr/bin/python3</string>
<string>/Users/hansheinemann/Projects/hans-tools/gh-monitor/poll.py</string>
</array>
<key>StartInterval</key>
<integer>300</integer>
<key>StandardOutPath</key>
<string>/Users/hansheinemann/Projects/hans-tools/gh-monitor/state/stdout.log</string>
<key>StandardErrorPath</key>
<string>/Users/hansheinemann/Projects/hans-tools/gh-monitor/state/stderr.log</string>
<key>RunAtLoad</key>
<false/>
</dict>
</plist>
``` ```
Note: this is a systemEvent (not agentTurn) so it injects into the main session Load with:
and Hans handles it inline. If this proves noisy, switch to agentTurn in isolated ```bash
session. launchctl load ~/Library/LaunchAgents/com.hans.gh-monitor.plist
```
Pause/resume:
```bash
launchctl unload ~/Library/LaunchAgents/com.hans.gh-monitor.plist
launchctl load ~/Library/LaunchAgents/com.hans.gh-monitor.plist
```
**Token cost:** Zero during polling. The main session is only woken when
`poll.py` calls `openclaw system event` — i.e. only when real PR activity
is detected.
--- ---

14
gh-monitor/design.md
View File

@@ -115,16 +115,16 @@ intervals across a handful of repos, this is nowhere near the limit.
--- ---
## Cron Schedule ## Schedule
Every 5 minutes via OpenClaw cron: Every 5 minutes via macOS `launchd` (LaunchAgent plist). `poll.py` runs as a
``` plain shell process — no agent session, no tokens consumed during polling.
{ "kind": "every", "everyMs": 300000 }
```
Payload: systemEvent → injects wake text into main session. The main session is only woken when `poll.py` finds new activity and calls
`openclaw system event`. On a quiet repo this costs zero tokens most of the day.
Can be paused/resumed via OpenClaw cron management without touching the code. The LaunchAgent can be unloaded/loaded via `launchctl` to pause/resume polling
without touching the code.
--- ---