Repository navigation
AgentPulse v0.0.5
Pre-release
Pre-release
AgentPulse gets a Settings screen and tells you when a new release is out.
New
- Settings screen. A new sidebar item after Cats.
- Animation: turn the cats' animation on or off and pick its speed (0.5×, 1×, 1.5× or 2×). Saved with your coats; the
AGENTPULSE_ANIMATIONandAGENTPULSE_ANIMATION_SPEEDvariables still win, and Reduce Motion still keeps the cats still. - Updates: turn automatic checks on or off, check now, and see when the last check ran. When a newer release exists, Settings shows its version, date and release notes, with a button to download it from GitHub.
- Animation: turn the cats' animation on or off and pick its speed (0.5×, 1×, 1.5× or 2×). Saved with your coats; the
- New-updates notice. When a newer release is out, a banner at the top of the window offers What's New, Download and Dismiss, and the menu-bar menu gets an "Update Available" item that opens the release page. It is a notice only: nothing is downloaded or installed for you.
Network
This is AgentPulse's first and only network request. Every 2 hours (on by default; you can turn it off in Settings) it asks GitHub for this project's list of releases:
GET https://api.github.com/repos/chengboonrong/agentpulse/releases?per_page=10- headers:
User-Agent: AgentPulse/<version>,Accept: application/vnd.github+json,Accept-Language: en, plus theAccept-EncodingmacOS adds; - no cookies, no cache, nothing about you, your agents or your usage. GitHub sees your IP address, as with any connection.
The README and docs/telemetry-spec.md describe it in full.
Changed
settings.jsonnow also holds the animation and update settings. Each change saves only its own part on top of what is on disk, so two copies of AgentPulse sharing a data folder no longer undo each other's coats.- A
settings.jsonthat cannot be parsed is moved aside tosettings.json.bad-<time>instead of being replaced, and one bad cat entry no longer resets the others. AGENTPULSE_ANIMATIONnow acceptsonas well asoff; other values are ignored with a warning.
Verified on the development machine (macOS 27, Apple Silicon)
- 222 automated tests pass; formatting and lints are clean.
- The bundle builds, signs and verifies as 0.0.5, including the widget extension.
- One real update check against GitHub succeeded and correctly found 0.0.4 up to date.
- The "update available" banner and Settings were rendered through the app's screenshot mode from a local file.
- Two rounds of independent code review; the data-loss cases it found in
settings.jsonare fixed and tested.
Known limits
- Not yet checked by a person: clicking or keyboard use of the new Settings controls, the menu-bar update item, and VoiceOver on the new screen.
- The update check can only see releases from now on, so this is the first version that will tell you about the next one.
- Source only: no packaged download. The bundle is development-signed for the machine that builds it. A notarized DMG needs a Developer ID certificate.
- Widgets are still snapshots that macOS refreshes on its own budget, so a widget can be about 15 minutes behind.