Skip to content

feat: background notifications for tool approval - #13

Draft
jongracecox wants to merge 3 commits into
mainfrom
worktree/20260311-notifications-on-tool-approval
Draft

feat: background notifications for tool approval#13
jongracecox wants to merge 3 commits into
mainfrom
worktree/20260311-notifications-on-tool-approval

Conversation

@jongracecox

Copy link
Copy Markdown
Owner

Summary

  • Add background session monitor that sends macOS notifications when a session transitions to WAITING_FOR_TOOL_APPROVAL while the user is attached to a different tmux session
  • Use terminal-notifier for proper notification center integration (auto-install prompt on first run, skippable)
  • Include Claude's explanation text in notifications for context (e.g., "Let me update the populate script")
  • Add FUJIMOTO_SKIP_NOTIFICATIONS=1 env var to disable notifications entirely

Note: This is a draft — may need more testing and iteration on notification UX.

Test plan

  • Run fujimoto, verify terminal-notifier install prompt appears with Install/Skip/Quit options
  • Skip install, verify app proceeds to home screen normally
  • Install terminal-notifier, verify app proceeds to home screen
  • Set FUJIMOTO_SKIP_NOTIFICATIONS=1, verify install prompt is skipped
  • Attach to one session, trigger tool approval in another, verify notification appears
  • Verify notification includes Claude's explanation text
  • Set notification style to "Alerts" in System Settings, verify notifications persist
  • Detach from tmux, verify monitor stops cleanly

Send macOS notifications when background sessions transition to
tool approval state while user is attached to a tmux session.
Monitors all project sessions via a daemon thread, skipping the
currently-attached session.
Switch from osascript to terminal-notifier for proper macOS
notification center integration. Include Claude's explanation text
in notifications so users know what tool approval is needed.

Add skip option to installer prompt and FUJIMOTO_SKIP_NOTIFICATIONS
env var to disable notifications entirely. Guard monitor startup
so it only runs when terminal-notifier is available.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant