Agent Notifications

Warp surfaces notifications from coding agents, both in-app and via desktop alerts, so you know exactly when an agent needs your attention.

Warp delivers notifications from any supported coding agent so you always know when an agent finishes a task, encounters an error, or needs your input. Notifications work whether you’re in a different tab or a different app.

Notification types

Warp categorizes agent notifications by what happened:

Complete - the agent finished its task successfully. You can review the output and continue working.
Request - the agent is blocked and needs your input. This includes command approval, permission requests, and idle prompts where the agent is waiting for you.
Error - the agent encountered an error that requires your attention.

In-app notifications

When you’re working in Warp but not looking at the agent’s tab, Warp provides several visual signals.

Toast notifications

Floating toast notifications appear in the corner of the Warp window when an agent in another tab needs attention. Toasts auto-dismiss after a few seconds. Hover over a toast to pause the timer, or click it to jump directly to the agent’s session.

Up to two toasts are visible at a time. If additional notifications arrive, the oldest toast is replaced.

A Warp toast notification in the upper-right corner showing an agent task completed, with an Open conversation action and a keyboard shortcut chip

Notification mailbox

The notification mailbox is a sidebar panel that collects all agent notifications in one place. Open it from the bell icon in the top-right corner of Warp.

The Warp notification mailbox open in the upper-right of the window with All tabs and Unread filter tabs, a Mark all as read action, and a notification entry

The mailbox includes:

Filter tabs - switch between All tabs, Unread, and Errors to find what needs attention. If there are no unreads or errors, those filters don’t appear.
Mark all as read - clear all unread indicators at once
Click to navigate - click any notification to jump directly to that agent’s tab

Keyboard shortcuts:

↑ / ↓ - select previous / next notification
Enter - open the selected notification’s session
Shift-Tab - cycle through filter tabs
Esc - close the mailbox

Tab status indicators

Each tab displays an icon reflecting its agent’s current state — working, blocked, completed, or errored. Tabs with unread notifications show an attention badge so you can spot which sessions need action, even with many tabs open.

Notifications are automatically marked as read when you navigate to the agent’s tab.

Desktop notifications

When Warp is in the background or minimized, agent notifications are delivered as native system-level desktop alerts. This ensures you’re aware of agent activity even while working in other apps.

Supported agents

Agent notifications currently work with:

Oz agent - supported out of the box. No setup required.
Claude Code - full support via notification plugin.
Codex - full support via native Codex configuration.
OpenCode - full support via notification plugin.

Setting up notifications

For the Oz agent, notifications work out of the box — no setup needed.

For third-party CLI agents, each agent requires a one-time setup. The process varies by agent:

Claude Code - one-click auto-install via a chip in Warp, or manual plugin commands. See Claude Code setup.
Codex - add notification_condition = "always" under [tui] in ~/.codex/config.toml, then restart Codex. See Codex setup.
OpenCode - add "@warp-dot-dev/opencode-warp" to the plugin array in your OpenCode config. See OpenCode setup.

The Enable Claude Code notifications chip in the agent utility bar with a tooltip reading Install the Warp plugin to enable rich agent notifications within Warp

If auto-install doesn’t work or you’re running an agent over SSH, Warp displays an installation-instructions chip in the terminal with setup steps you can follow directly.

Desktop Notifications - configure system-level notification permissions and troubleshoot delivery
Managing Agents - monitor all agent conversations, filter by status, and inspect sessions
Third-Party CLI Agents - overview of supported CLI agents and Warp features
Claude Code - setup and notification plugin installation
Codex - setup and notification configuration
OpenCode - setup and notification plugin installation