bobuk.io
← All apps

Splash Finish / Help

Let’s work it out.

Installation, integrations, and a direct line to the project. No form that disappears into nowhere.

Splash Finish 0.3.17: color themes and inbox settings gear

Open Settings… (⌘,) or click the gear button in the bottom-right corner of the inbox footer to choose System, Light, or Dark mode and any of 18 built-in color themes with palette swatches and a live preview.

Adjust Panel, Accent, and Text directly, or expand More colors to customize Surface, Muted text, Border, Selection, Link, Success, and Danger with per-token Auto contrast reset. Themes apply across the inbox, Settings, and Integrations windows.

Splash Finish 0.3.16: Antigravity (agy), Copilot CLI, Codex async questions and Snooze

Run splash-finish install-skills (or open Integrations…) to connect Antigravity (agy) and GitHub Copilot CLI. Antigravity installs a native plugin in ~/.gemini/config/plugins/splash-finish (honoring ANTIGRAVITY_CONFIG_DIR) without editing your global hooks.json; Copilot CLI installs ~/.copilot/hooks/splash-finish.json (honoring COPILOT_HOME).

Menu bar timed snooze (15 Minutes, 1 Hour, Until Tomorrow Morning) now holds until its deadline even across an empty inbox or restart, dims the menu bar icon while keeping the count bright, and offers Unsnooze to end the pause without opening the inbox.

Homebrew installation and updates

Use Update Splash Finish via Homebrew… or quit the app and run brew upgrade --cask --greedy bobuk-io/tap/splash-finish. The window shows output, errors and cancellation. Only Splash Finish is upgraded; the inbox and integrations are kept.

Keep one installation method. To switch from the standalone installer, quit the app, remove its old /Applications/Splash Finish.app (or ~/Applications/Splash Finish.app from older installers) and old CLI symlink, then install with Homebrew. Keep the Application Support folder and run splash-finish install-skills afterward to refresh integration paths. Do not use --force.

For Homebrew removal, disable Start at Login, run splash-finish uninstall-skills, quit the app, then run brew uninstall --cask bobuk-io/tap/splash-finish. Add --zap only to erase the inbox and app preferences. Agent configuration backups are retained.

Something isn’t working?

  1. Update through the app menu: Homebrew for a Homebrew copy, Check for Updates for a standalone copy.
  2. Run splash-finish doctor to inspect integrations and repair hints.
  3. In Codex, check hook trust via /hooks. In pi, run /reload. In Claude Code, Copilot CLI, or Antigravity (agy), start a new session.

Too many pi notifications?

Update to 0.3.8 or later, run splash-finish install-skills, and run /reload in existing pi sessions. Menus opened while pi is idle no longer trigger attention notifications.

For managed workers, set SPLASH_FINISH_DISABLED=1 in the worker process environment. Leave it unset in the coordinator. This suppresses worker hooks, rich questions, and explicit notify calls; unmarked helper sessions can still notify.

Rex support

New notifications from local Rex sessions retain their original session and pane. Exact return requires the Rex CLI, one connected local Mac app client, and Remote Control enabled by you in Rex. Splash Finish does not enable it. If navigation fails, the notification stays. Remote hosts and old notifications without Rex coordinates are not supported.

Report a problem

Include your macOS, app, and agent versions, steps to reproduce, and the expected result. Do not post full status --raw output: it can contain private task excerpts.

Uninstall and remove data

  1. Run splash-finish uninstall-skills.
  2. Quit Splash Finish and remove /Applications/Splash Finish.app (or ~/Applications/Splash Finish.app from older installers) and the splash-finish symlink from your local bin directory.
  3. To erase the inbox, remove ~/Library/Application Support/Splash Finish. Agent configuration backups remain next to their configuration files; remove those separately if no longer needed.

GitHub Issues are public and require a GitHub account to submit. Never include tokens, personal data, or private session contents.

Contact support ↗