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:
- An unsandboxed LaunchAgent helper, so machine health, process control and shell integration work without the App Store sandbox
- Faster fix iteration (no App Store review wait)
- Premium unlocked for beta testers — this build resolves to the Pro tier without a purchase. Cloud-dependent premium features can still degrade, because the backend validates Mac App Store receipts and does not yet allow-list the beta channel.
- 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 lives at
cli-pulse/cli-pulse-private
— which, despite its name, is public. It is closed-source by licence, not
by visibility: you can read it, you may not redistribute it. See
LICENSE.md.
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).