From 542c4a3d35edbc06f2beb824b158e19b5fdfc92b Mon Sep 17 00:00:00 2001
From: Danilo Leal <67129314+danilo-leal@users.noreply.github.com>
Date: Wed, 7 May 2025 10:41:49 -0300
Subject: [PATCH] docs: Add section about agent notification (#30121)

Release Notes:

- N/A
---
 docs/src/ai/agent-panel.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/src/ai/agent-panel.md b/docs/src/ai/agent-panel.md
index 855265e1f5..f99d1b8035 100644
--- a/docs/src/ai/agent-panel.md
+++ b/docs/src/ai/agent-panel.md
@@ -43,6 +43,12 @@ This approach extends to collaboration with AI as well.
 
 As soon as you send a prompt to the Agent, click on the "crosshair" icon at the bottom left of the panel to follow along as it reads through your codebase and performs edits.
 
+### Get Notified {#get-notified}
+
+If you send a prompt to the Agent and then move elsewhere, putting Zed in the background, a notification will pop up at the top right of your monitor indicating that the Agent has completed its work.
+
+You can customize the notification behavior or turn it off entirely by using the `agent.notify_when_agent_waiting` key.
+
 ### Reviewing Changes {#reviewing-changes}
 
 If you are using a profile that includes write tools, and the agent has made changes to your project, you'll notice the Agent Panel surfaces the fact that edits have been applied.