Use this file to discover all available pages before exploring further.
Chronicle is a Universal binary that runs natively on both Apple Silicon and Intel Macs. It requires macOS 15 or newer. Pick the installation method that fits your workflow — Homebrew is the lowest-friction option if you already use it, while the .pkg installer works well if you prefer not to use a package manager.
Chronicle is ad-hoc signed, not notarized. Apple notarization requires a paid Developer ID ($99/year) that this project doesn’t carry yet. Every release lists SHA256 checksums on the release page so you can verify the download. See First launch for the exact Gatekeeper prompts each install method produces.
The .pkg installer is the lowest-friction option without Homebrew. Its postinstall script strips the Gatekeeper quarantine attribute automatically, so no xattr command is needed after installation.
1
Download the package
Go to the GitHub Releases page and download Chronicle-<version>.pkg from the latest release.
2
Open the installer
Because Chronicle is not signed with a paid Developer ID, macOS will block a double-click. Instead, right-click the .pkg file and choose Open, then click Open again in the confirmation dialog.
This one-time prompt will not appear again for future updates installed via the .pkg.
3
Follow the installer prompts
The installer places Chronicle.app in /Applications/ and removes the quarantine attribute via a postinstall script.
4
Launch Chronicle
Open Chronicle from /Applications/ or Spotlight. No xattr command is needed.
Open the .dmg file, then drag Chronicle.app onto the Applications shortcut inside the disk image window.
3
Strip the quarantine attribute
Open Terminal and run:
xattr -cr /Applications/Chronicle.app
This removes the Gatekeeper quarantine flag that macOS attaches to files downloaded from the internet. Without this step, macOS will block the app from launching with an “Apple could not verify” message. You can also right-click Chronicle.app → Open → Open as an alternative.
Unzip the archive, then drag Chronicle.app into /Applications/.
3
Strip the quarantine attribute
Open Terminal and run:
xattr -cr /Applications/Chronicle.app
If you skip this step, Chronicle still opens — but it will show an in-app card with this same command and a copy-to-clipboard button, so you can run it without switching to Terminal manually.
4
Launch Chronicle
Open Chronicle from /Applications/ or Spotlight.
Chronicle is a pure Swift Package with no Xcode project or signing configuration required. A recent Xcode toolchain is the only dependency.
Running the raw binary works for development. For a proper .app bundle with a Dock icon and Info.plist, use the GitHub Actions workflow at .github/workflows/release.yml as a template, or copy the binary into a hand-rolled bundle alongside Resources/Info.plist.in.
Chronicle includes built-in update support via Sparkle. Go to Chronicle menu → Check for updates… to fetch the latest release. If a newer version is available, Chronicle downloads, verifies, and swaps the running bundle in place. Each release is signed with an EdDSA key embedded in the app, so a tampered download is rejected before it touches /Applications/.
No background polling occurs. The only outbound network call Chronicle makes is the one you trigger by clicking Check for updates…
