Install

macOS 13 (Ventura) or later required

The Stint.app GUI requires macOS 13. The CLI may run on macOS 12 in practice but only macOS 13+ is officially supported. All channels are signed and notarized — no Gatekeeper warnings on a fresh install.

stint ships through four channels. Pick whichever fits your workflow.

Homebrew (recommended)

brew tap reyemtech/tap
brew install --cask stint

Installs Stint.app to /Applications and symlinks the CLI at /opt/homebrew/bin/stint (Apple Silicon) or /usr/local/bin/stint (Intel). Auto-updates happen via Homebrew (brew upgrade --cask stint) and via the in-app updater — both keep you current; whichever runs first wins.

The cask bundles the stint(1) man page inside the .app and exposes it to man(1), so man stint works straight after install.

Direct DMG download

Grab the latest .dmg from the GitHub releases page and drag Stint.app into /Applications.

The DMG includes only the GUI; for the CLI use the Homebrew cask or the curl | sh installer below.

curl | sh — CLI only

curl -fsSL https://stint.reyem.tech/install.sh | sh

Installs the standalone stint binary to /usr/local/bin/stint (if writable) or ~/.local/bin/stint. The standalone CLI self-updates via stint update.

To install the man page for this path, run scripts/install-man.sh from a checkout of the repo — it calls stint generate-man and drops stint.1 into /usr/local/share/man/man1/.

curl | sh — CLI + GUI

curl -fsSL https://stint.reyem.tech/install.sh | sh -s -- --gui

Installs the CLI plus copies Stint.app to /Applications. The script verifies macOS 13+ before downloading the DMG so older systems fail fast with a clear message.

Pinning to a specific version

curl -fsSL https://stint.reyem.tech/install.sh | sh -s -- --version v0.1.5

Useful for reproducing an issue against a known release.

Uninstall

# CLI (any install method):
curl -fsSL https://stint.reyem.tech/install.sh | sh -s -- --uninstall

# GUI:
rm -rf /Applications/Stint.app

User data (timer database, Solidtime credentials, calendar OAuth tokens) is preserved on uninstall. To wipe it:

rm -rf ~/Library/Application\ Support/stint
security delete-generic-password -s tech.reyem.stint.solidtime.token
security delete-generic-password -s tech.reyem.stint.solidtime.oauth
# Each calendar account has its own Keychain entry:
security find-generic-password -s tech.reyem.stint.calendar

Next steps

• Quickstart — start your first timer
• Solidtime setup — connect to your Solidtime instance
• Calendar setup — surface meetings as one-click entries