; <body> BEL` - Example (bash/zsh): `printf '\033]777;notify;Deploy;Success on prod\007'` Notes: - Works on macOS, Windows, and Linux where Warp is allowed to show notifications. - Newlines and semicolons should be avoided or escaped in payloads. - This feature is enabled by default in current releases of Warp. ## How to access it ### Notifications - Notifications are enabled by default and require system permissions to appear. - If you’ve turned Notifications off before, toggle it back on by going to **Settings** > **Features** > **Session**, or quickly toggle Notifications with the [Command Palette](https://docs.warp.dev/terminal/command-palette/). - Customize Notification triggers for long-running commands or password prompts by going to **Settings** > **Features** > **Notifications**. Note On macOS, you will want to **Allow** or **Accept** the request so that Warp can send you desktop notifications. If you accidentally denied it or would like to re-enable Notifications later, check the [troubleshooting guide below](https://docs.warp.dev/terminal/more-features/notifications/#troubleshooting-notifications). ## How it works ## Troubleshooting Notifications <a id="tabs-macos"></a> ### macOS Warp requires two distinct notification settings to work. macOS system settings found in > **System Settings** > **Notifications & Focus** and Warp app settings found in **Settings** > **Features** > **Session** must both be enabled for Notifications to show. If you have Notifications enabled in the system and Warp, but you still aren’t receiving desktop notifications, try the following: - Make sure that you are navigated away from Warp when you expect to receive the notification. - Make sure the **Do Not Disturb** mode is turned off in > **System Settings** > **Notifications** > **Notifications & Focus** > **Focus**. - Go to > **System Settings** > **Notifications & Focus** > **Notifications** and select Warp in the list. Make sure either banner style or alert style notifications are selected, then quit and restart Warp. - To get the macOS notification prompt to show again for Warp, run `defaults delete dev.warp.Warp-Stable Notifications`, then restart Warp and toggle on the **Settings** > **Features** > **Receive desktop notifications from Warp**. - Once all of the above is done, restart macOS to apply the changes, which should restore notifications in Warp. <a id="tabs-windows"></a> ### Windows Warp requires two distinct notification settings to work. Windows system settings found in **Settings** > **System** > **Notifications** > **Warp** and Warp app settings found in **Settings** > **Features** > **Session** must both be enabled for Notifications to show. If you have Notifications enabled in the system and Warp, but you still aren’t receiving desktop notifications, try the following: - Make sure that you are navigated away from Warp when you expect to receive the notification. - Make sure the **Do Not Disturb** mode or **Focus** is turned off. - Go to **System** > **Notifications** and select Warp in the list. Make sure notifications are turned on, then quit and restart Warp. <a id="tabs-linux"></a> ### Linux Warp requires two distinct notification settings to work. Linux system settings found in **Settings** > **Notifications** > **Warp** and Warp app settings found in **Settings** > **Features** > **Session** must both be enabled for Notifications to show. If you have Notifications enabled in the system and Warp, but you still aren’t receiving desktop notifications, try the following: - Make sure that you are navigated away from Warp when you expect to receive the notification. - Make sure the **Do Not Disturb** mode (if your distribution supports it) is turned off. - Go to **Settings** > **Notifications** and select Warp in the list. Make sure notifications are turned on, then quit and restart Warp. Please [reach out to us](https://docs.warp.dev/support-and-community/troubleshooting-and-support/sending-us-feedback/#sending-warp-feedback) if you have any other issues.

> For the complete documentation index, see [llms.txt](https://docs.warp.dev/llms.txt). > Markdown versions of each page are available by appending .md to any URL. # Desktop Notifications Receive desktop notifications when long-running commands complete or need your input. ## What is it Notifications can be sent when a command completes after a configurable number of seconds or when a running command needs you to enter a password to proceed. For either of these triggers, Warp will only send you a desktop notification if you are using a different app at the time the trigger is fired. Note For notifications from coding agents (Warp’s built-in Agent and third-party CLI agents like Claude Code and OpenCode), see [Agent Notifications](https://docs.warp.dev/agents/capabilities/agent-notifications/). ## Custom notification hooks (OSC 9 / OSC 777) Warp supports pluggable notifications triggered by terminal escape sequences, so scripts and tools can raise desktop notifications without additional dependencies. - OSC 9 (body only): sends a notification with just a body. - Format: `ESC ] 9 ; BEL` - Example (bash/zsh): `printf '\033]9;Build complete\007'` - OSC 777 (title + body): sends a notification with a title and body. - Format: `ESC ] 777 ; notify ; ; <body> BEL` - Example (bash/zsh): `printf '\033]777;notify;Deploy;Success on prod\007'` Notes: - Works on macOS, Windows, and Linux where Warp is allowed to show notifications. - Newlines and semicolons should be avoided or escaped in payloads. - This feature is enabled by default in current releases of Warp. ## How to access it ### Notifications - Notifications are enabled by default and require system permissions to appear. - If you’ve turned Notifications off before, toggle it back on by going to **Settings** > **Features** > **Session**, or quickly toggle Notifications with the [Command Palette](https://docs.warp.dev/terminal/command-palette/). - Customize Notification triggers for long-running commands or password prompts by going to **Settings** > **Features** > **Notifications**. Note On macOS, you will want to **Allow** or **Accept** the request so that Warp can send you desktop notifications. If you accidentally denied it or would like to re-enable Notifications later, check the [troubleshooting guide below](https://docs.warp.dev/terminal/more-features/notifications/#troubleshooting-notifications). ## How it works ## Troubleshooting Notifications <a id="tabs-macos"></a> ### macOS Warp requires two distinct notification settings to work. macOS system settings found in > **System Settings** > **Notifications & Focus** and Warp app settings found in **Settings** > **Features** > **Session** must both be enabled for Notifications to show. If you have Notifications enabled in the system and Warp, but you still aren’t receiving desktop notifications, try the following: - Make sure that you are navigated away from Warp when you expect to receive the notification. - Make sure the **Do Not Disturb** mode is turned off in > **System Settings** > **Notifications** > **Notifications & Focus** > **Focus**. - Go to > **System Settings** > **Notifications & Focus** > **Notifications** and select Warp in the list. Make sure either banner style or alert style notifications are selected, then quit and restart Warp. - To get the macOS notification prompt to show again for Warp, run `defaults delete dev.warp.Warp-Stable Notifications`, then restart Warp and toggle on the **Settings** > **Features** > **Receive desktop notifications from Warp**. - Once all of the above is done, restart macOS to apply the changes, which should restore notifications in Warp. <a id="tabs-windows"></a> ### Windows Warp requires two distinct notification settings to work. Windows system settings found in **Settings** > **System** > **Notifications** > **Warp** and Warp app settings found in **Settings** > **Features** > **Session** must both be enabled for Notifications to show. If you have Notifications enabled in the system and Warp, but you still aren’t receiving desktop notifications, try the following: - Make sure that you are navigated away from Warp when you expect to receive the notification. - Make sure the **Do Not Disturb** mode or **Focus** is turned off. - Go to **System** > **Notifications** and select Warp in the list. Make sure notifications are turned on, then quit and restart Warp. <a id="tabs-linux"></a> ### Linux Warp requires two distinct notification settings to work. Linux system settings found in **Settings** > **Notifications** > **Warp** and Warp app settings found in **Settings** > **Features** > **Session** must both be enabled for Notifications to show. If you have Notifications enabled in the system and Warp, but you still aren’t receiving desktop notifications, try the following: - Make sure that you are navigated away from Warp when you expect to receive the notification. - Make sure the **Do Not Disturb** mode (if your distribution supports it) is turned off. - Go to **Settings** > **Notifications** and select Warp in the list. Make sure notifications are turned on, then quit and restart Warp. Please [reach out to us](https://docs.warp.dev/support-and-community/troubleshooting-and-support/sending-us-feedback/#sending-warp-feedback) if you have any other issues.