; <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](/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](/terminal/more-features/notifications/#troubleshooting-notifications). ## How it works ## Troubleshooting Notifications - [macOS](#tab-panel-803) - [Windows](#tab-panel-804) - [Linux](#tab-panel-805) 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, please restart macOS to apply the changes and that should help with restoring notifications in Warp. 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. 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](/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](/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](/agent-platform/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](/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](/terminal/more-features/notifications/#troubleshooting-notifications). ## How it works ## Troubleshooting Notifications - [macOS](#tab-panel-803) - [Windows](#tab-panel-804) - [Linux](#tab-panel-805) 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, please restart macOS to apply the changes and that should help with restoring notifications in Warp. 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. 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](/support-and-community/troubleshooting-and-support/sending-us-feedback/#sending-warp-feedback) if you have any other issues.