Agentoast

agentoast

A macOS menu bar app for tmux users. Get a toast notification whenever an AI coding agent (Claude Code, Codex, Copilot CLI, opencode) finishes or needs your input — click it to jump right back to the tmux pane it came from.

You kick off a long-running agent task, switch over to a browser or another window, and completely miss the moment it wraps up or asks for permission. agentoast makes sure you never miss it.

Add a hook to your agent's config. All notifications are grouped by repository in the menu bar — clicking one takes you straight to its tmux pane.

A toast pops up whenever an agent completes or needs attention — click it to jump right back to the tmux pane.

Requirements

Repository and branch info is read directly from .git metadata, and the process tree is read via native macOS APIs — neither the git binary nor ps is required.

agentoast auto-detects the tmux binary path by searching well-known locations (Homebrew, system, Nix). If the Sessions panel is empty, see the [[system] config](#system-binary-paths) to set the path manually.

Installation

This installs the menu bar app and the agentoast CLI in one step.

Or download the DMG from Releases.

To uninstall:

Usage

Works With

All agents utilize the built-in CLI (agentoast hook ). See the Integration section for setup details. If you'd like to see support for other agents, please feel free to open an issue.

Config

Opens ~/.config/agentoast/config.toml in your editor, creating a default one if it doesn't exist yet.

Editor resolution priority is config.toml editor field → $EDITOR → vim

For the most common options (toast duration, global shortcut, auto-update, editor), you can also right-click the menu bar icon and choose Settings… to open a GUI editor. Changes are written back to…