This repository hosts Developer ID notarized .dmg releases of the
CLI Pulse Mac menubar app —
the Beta channel that runs parallel to the Mac App Store
distribution.
CLI Pulse ships through two channels:
| Channel | Vehicle | Update cadence | Audience |
|---|---|---|---|
| App Store | Mac App Store | Apple review (1–5 days) | All users |
| Beta (this repo) | Direct-download .dmg |
Same-day from commit | Power users / dev community |
The Beta channel is **signed with Developer ID Application + notarized
- stapled** so macOS Gatekeeper accepts it without warning. The app itself is the same source tree as the App Store version, but with extra capabilities the App Store can't ship:
- Phase 4D/4E Swift LaunchAgent runtime (replaces the older Python helper as the primary cloud-sync path)
- Faster fix iteration (no App Store review wait)
- All premium features unlocked by default for beta testers
- Download the latest
CLI-Pulse-<version>-arm64.dmgfrom Releases. - Open the
.dmg, drag CLI Pulse.app into/Applications. - Launch from Launchpad or Spotlight.
If you already have the App Store version installed, the Beta will replace it. To switch back to the App Store version, reinstall from the App Store.
Important — disable App Store automatic updates for CLI Pulse if you want to stay on the Beta channel. Otherwise macOS will silently re-install the App Store version on the next scheduled update. System Settings → App Store → uncheck "Automatic Updates" or set "App Updates" to manual.
Once installed, the app polls this repo's manifest at
releases/download/latest/latest.json once per 24h and on the user-
clicked "Check for Updates" button in Settings → App Updates.
When a new version is available, the app downloads the .dmg,
verifies its SHA-256 against the manifest, mounts it in Finder, and
quits itself so you can drag-replace the app in /Applications. The
new version relaunches when you next open it.
Two parallel tag conventions:
| Tag | Type | Carries | Purpose |
|---|---|---|---|
app-v1.X.Y |
Versioned | .dmg + .dmg.sha256 |
Immutable archive |
latest |
Pre-release | latest.json only |
Manifest endpoint AppUpdater fetches |
The latest tag is deleted + recreated on every release so its only
asset is always the freshest manifest.
This repo is artifact-only. The source code lives at
JasonYeYuhe/cli-pulse
(private until v2.0 — public source release is on the roadmap).
Issues + feature requests: file an issue on the source repo.
cli-pulse-helper-releases— Companion CLI Helper.pkgreleases (the unsandboxed background service that drives managed Codex / Gemini / Claude sessions).