Repository navigation
v1.48.1 - Linux and Windows
Linux/Windows release
Agent Notifications 1.48.1 ships for Linux amd64/arm64 and Windows amd64. macOS stays on 1.46.1; there are no Darwin binaries or ClaudeNotifier.app in this release. GitHub Latest also stays 1.46.1 for legacy installers. The public installer selects the qualified platform channel.
| Platform | Qualified version |
|---|---|
| Linux amd64 / arm64 | 1.48.1 |
| Windows amd64 | 1.48.1 |
| macOS amd64 / arm64 | 1.46.1 |
Changes since 1.47.1
-
Fix repeated Windows clock ticks incorrectly expiring a valid fresh notification budget because of floating-point rounding. The four-second limit remains unchanged.
-
One self-contained OpenCode plugin supports V1 and V2. V2 verifies native ownership and settled execution, suppresses child sessions, and recovers after temporary ownership failures. V1 consumes the reviewed SDK 0.3.0 observer while retaining its entry point. The SDK is vendored in this consumer; this release does not publish a separate npm SDK. #294
-
Cursor setup can compose explicit selected bindings with separate notification-channel consent. Managed Stop-event delivery, repeated setup, policy checks, revocation and recovery contracts are included. Selected-client desktop/focus qualification remains separate and incomplete. #342, #344, #356, #364
-
Notification callback lifetime, resource ownership, Linux portal restart and Wayland token forwarding have additional source-bound checks. These do not establish visible banners or selected chat focus on every desktop. #345, #349, #354, #355, #357
This includes the existing Linux/Windows installer, Gemini, native-title/question, bounded retry and configuration-preservation improvements from 1.47.0 and 1.47.1.
Compatibility and limits
- OpenCode native release qualification targets V1 1.18.33 and V2 2.0.21 on all three shipped targets, plus V1 1.18.34 on Linux amd64. Persistent TUI/serve hosts are supported; one-shot shutdown delivery remains best effort.
- Stock Windows OpenCode V1 can deliver a delayed completion once and again after its 24-hour deduplication claim expires when original event age cannot be independently verified.
- Gemini CLI is qualified with 0.62.0. A completed turn does not guarantee task success or a final answer.
- macOS retains its earlier release and does not receive this dual-API or Cursor update. New macOS source changes are not delivered in these packages.
- Claude and Codex share a configuration file. A shared enabled webhook also receives Codex notifications; product-specific settings can override it.
- Package/webhook/protocol checks do not prove desktop banners, sound, selected-client focus, interactive Windows toast or plugin-manager activation.
Qualification
Exact native release source: e86149a724f9b96cb5ee193d63dbc5a533c61e7e.
Exact-source native CI and all three same-run artifact canaries passed. All seven fresh OpenCode installed-business cells passed independent raw-evidence review. Native artifacts, installed-business observations, three downloaded draft package checks, three public package checks.
A disposable native Codex 0.159.2 observation passed independent raw review: five hooks trusted through the native TUI, one completed turn, one correlated Stop, one webhook and zero tool calls. Its tested same-run Linux binary was verified byte-identical to the separately downloaded draft asset, SHA256 6347b475acbc716a8e63d713ee73a995ed7d4190ed86069d68d9e5569e5e2f20.
The first Windows V1 permission observation failed closed during clock calibration. One rerun of only that failed job passed with unchanged source and budgets. The original failure remains preserved; the successful retry does not establish its precise cause or a fix. Earlier unpublished v1.48.0 observations do not qualify these binaries.
The frozen draft manifest covers 18 asset IDs and byte hashes (SHA256 1d01377581ac61e18f50e8c37559d94339cc33d210b6c159374a742c23a6e70f).
These checks do not grant full native clock, source epoch, final-settlement, time-policy or platform-lifetime qualification. Windows Date samples included observations outside the precise native clock interval; source-wall bounds remain unqualified. Desktop visual outcomes remain unobserved. All such flags remain false; the original full/smoke denial gate is retained. All 18 downloaded public assets match the qualified draft asset IDs and byte hashes; the public package reports received independent review.
Installation and update
Use Bash, or Git Bash on Windows:
curl -fsSL https://777genius.github.io/agent-notifications/install.sh | bash -s -- --product claudeUse --product codex or --products claude,codex for those selections. Linux/Windows Gemini uses --product gemini --desktop, --webhook, or both. Restart your agent after setup. Rerun the public installer once to adopt your platform channel; Claude plugin updates then follow that channel. Standalone Codex bundles update by rerunning setup.
Legacy main marketplace installations retain version 1.46.1 until adopting the platform channel, so macOS never requests missing 1.48.1 assets. Platform channels and update behavior.
Portable ZIPs are provided for integrations. Verify them against checksums.txt; package identity and native runtime bytes are separate from plugin-manager activation.