Skip to content

AgentPulse v0.0.5

Pre-release
Pre-release

Choose a tag to compare

@chengboonrong chengboonrong released this 13 Nov 14:11
94d23f7

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_ANIMATION and AGENTPULSE_ANIMATION_SPEED variables 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.
  • 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 the Accept-Encoding macOS 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.json now 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.json that cannot be parsed is moved aside to settings.json.bad-<time> instead of being replaced, and one bad cat entry no longer resets the others.
  • AGENTPULSE_ANIMATION now accepts on as well as off; 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.json are 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.