[{"data":1,"prerenderedAt":46},["ShallowReactive",2],{"doc:en:notifications":3},{"title":4,"lede":5,"html":6,"headings":7},"Notifications","Escouade tells you when an agent asks a question, asks for permission, finishes, or fails. This page describes each signal, what a notification says, and how to choose what notifies you.","\u003Cp>\u003Cimg src=\"\u002Fimages\u002Fen\u002Fnotifications.jpg\" alt=\"Escouade with the agent “tests-e2e” in the “Question” state and its question card, a project tab highlighted, and the Windows notification area icon with its badge\" width=\"1920\" height=\"960\" loading=\"lazy\" decoding=\"async\">\u003C\u002Fp>\n\u003Ch2 id=\"what-triggers-a-notification\">What triggers a notification\u003C\u002Fh2>\n\u003Cdiv class=\"table\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Event\u003C\u002Fth>\n\u003Cth>Blink color\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>An agent asks a question or asks for permission (“Question” status)\u003C\u002Ftd>\n\u003Ctd>amber\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>An agent finishes its turn (“Done”)\u003C\u002Ftd>\n\u003Ctd>green\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>An agent fails (“Error”), for example because its process stopped\u003C\u002Ftd>\n\u003Ctd>red\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\n\u003Cp>A ticket that reaches “To review” or gets blocked also sends a notification (see \u003Ca href=\"\u002Fen\u002Fdocs\u002Fboard\u002F\">the Kanban\u003C\u002Fa>), without making an agent blink.\u003C\u002Fp>\n\u003Cp>These signals also apply to an agent running in \u003Ca href=\"\u002Fen\u002Fdocs\u002Fclaude-code-view\u002F\">the Claude Code view\u003C\u002Fa>. When you interrupt a turn yourself (\u003Ccode class=\"key\">Esc\u003C\u002Fcode>), or when a message sent during the turn is waiting in the agent’s queue, the end of the turn sends no notification. For an agent working on an “In progress” ticket, only its questions notify you: the Kanban announces when the ticket is ready to review or blocked.\u003C\u002Fp>\n\u003Ch2 id=\"in-the-window\">In the window\u003C\u002Fh2>\n\u003Ch3 id=\"the-tab-and-the-card-that-blink\">The tab and the card that blink\u003C\u002Fh3>\n\u003Cp>When an agent asks a question, finishes, or fails while you weren’t looking at it, its card in the sidebar blinks, and so does its project’s tab (if it isn’t the one you’re looking at). The color says what it is: amber for a question, green for an end, red for an error. When several agents of a project need a look, the tab takes the most pressing color: error first, then question, then end. Hover over the tab to read the names (“Needs a look: refacto-auth, tests-e2e”).\u003C\u002Fp>\n\u003Cp>The blinking lasts until you show the agent, with the window in the foreground. “Looking at” the agent means its conversation is on screen: if the editor, the Kanban, a terminal, a launch log, the statistics, or the overview hides it, the agent still needs a look. If your system asks to reduce animations, the card keeps a steady tint instead of blinking.\u003C\u002Fp>\n\u003Ch3 id=\"counters\">Counters\u003C\u002Fh3>\n\u003Cp>The project tabs show a pill with the number of agents waiting for an answer. The status bar, at the bottom, counts the “active”, “waiting”, and “done” agents, and its “N waiting” button takes you to the next agent that needs a look. \u003Ccode class=\"key\">Ctrl+J\u003C\u002Fcode> does the same (see \u003Ca href=\"\u002Fen\u002Fdocs\u002Foverview\u002F\">keeping track of your agents\u003C\u002Fa>).\u003C\u002Fp>\n\u003Ch2 id=\"outside-the-window\">Outside the window\u003C\u002Fh2>\n\u003Ch3 id=\"the-chime\">The chime\u003C\u002Fh3>\n\u003Cp>A two-note chime rings when an agent asks a question, finishes, or fails. It rings even when the window is in the foreground. On Linux, it is played by \u003Ccode class=\"key\">paplay\u003C\u002Fcode>: without that program, it stays silent. The “♪ On” \u002F “♪ Off” button in the status bar turns it on or off; the same setting is in Settings › Notifications, with a “▶ Test” button.\u003C\u002Fp>\n\u003Ch3 id=\"the-system-notification\">The system notification\u003C\u002Fh3>\n\u003Cp>When the window isn’t in the foreground (hidden, minimized, or without focus), Escouade also sends a system notification, on Windows and macOS. There are none on Linux. Its title is \u003Ccode>project · agent\u003C\u002Fcode>, and its text says what it’s about (see below). On Windows, a click on it brings the window back and opens the agent concerned, or the Kanban for a ticket notification. On macOS, a click brings the app to the foreground without opening the agent.\u003C\u002Fp>\n\u003Ch3 id=\"the-taskbar-and-the-dock\">The taskbar and the Dock\u003C\u002Fh3>\n\u003Cp>When the window isn’t in the foreground, Escouade’s button flashes in the Windows taskbar, and the Dock icon bounces on macOS. On Linux, Escouade asks the system for the window’s attention; what that does depends on the desktop.\u003C\u002Fp>\n\u003Ch3 id=\"the-notification-area\">The notification area\u003C\u002Fh3>\n\u003Cp>Escouade keeps an icon in the notification area (the menu bar on macOS). An amber badge sits in its corner as long as at least one agent is waiting for an answer, and the tooltip gives the count (“Escouade — 2 agents waiting”). A click on the icon shows the window; its menu offers “Show” and “Quit”. Closing the window only hides it: the agents go on, and they notify you as usual (see \u003Ca href=\"\u002Fen\u002Fdocs\u002Fmanaging-agents\u002F#closing-the-window-quitting-and-restarting\">agents\u003C\u002Fa>).\u003C\u002Fp>\n\u003Ch2 id=\"what-a-notification-says\">What a notification says\u003C\u002Fh2>\n\u003Cdiv class=\"table\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Case\u003C\u002Fth>\n\u003Cth>Text\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Question\u003C\u002Ftd>\n\u003Ctd>The question’s text (the first one, if there are several), on one line; “Claude is waiting for your answer” if there is none\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Permission\u003C\u002Ftd>\n\u003Ctd>“Allow Bash: npm test?”: the tool, and what it acts on (the command, the file relative to the agent’s folder, the address, the search)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Plan\u003C\u002Ftd>\n\u003Ctd>“Approve the plan: Add the PDF filter?”: the first line of the plan\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>End of turn\u003C\u002Ftd>\n\u003Ctd>The first line of Claude’s reply, without Markdown formatting; “Task done” if it has no text\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Error\u003C\u002Ftd>\n\u003Ctd>“Error: ” followed by the reason, for example “Error: Claude Code stopped (code 1)”\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Ticket\u003C\u002Ftd>\n\u003Ctd>The title is the project’s name, the text “ATL-42 ready to review” or “ATL-42 blocked: ” followed by the reason\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\n\u003Cp>An agent’s text is cut at 120 characters.\u003C\u002Fp>\n\u003Ch2 id=\"notify-me-about\">Notify me about\u003C\u002Fh2>\n\u003Cp>In Settings › Notifications, the “Notify me about” group chooses the types that chime and send a system notification: “Questions and permissions”, “Finished tasks”, “Errors”, and “Tickets (ready to review, blocked)”. A type turned off has neither chime nor system notification, but the tab, the card, and the taskbar (or the Dock) still flag the agent. The “Channels” group turns off system notifications all at once (“Windows notifications when the app is not in the foreground”, or “macOS” on macOS; on Linux the label also says “Windows”, but Escouade shows no system notification there), and the “Sound” group turns off the chime. All the options are described in \u003Ca href=\"\u002Fen\u002Fdocs\u002Fsettings-notifications\u002F\">the notification settings\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"a-launch-command-that-crashes\">A launch command that crashes\u003C\u002Fh2>\n\u003Cp>When a launch command stops with an error (see \u003Ca href=\"\u002Fen\u002Fdocs\u002Flaunch\u002F\">launching the project\u003C\u002Fa>), a red message appears in the window: it names the command and gives its exit code. The command also goes to “crashed (code 2)” in the “Launch” section of the sidebar. It isn’t a system notification and there’s no chime: the message is only seen in the window.\u003C\u002Fp>\n",[8,12,15,19,22,25,28,31,34,37,40,43],{"id":9,"text":10,"depth":11},"what-triggers-a-notification","What triggers a notification",2,{"id":13,"text":14,"depth":11},"in-the-window","In the window",{"id":16,"text":17,"depth":18},"the-tab-and-the-card-that-blink","The tab and the card that blink",3,{"id":20,"text":21,"depth":18},"counters","Counters",{"id":23,"text":24,"depth":11},"outside-the-window","Outside the window",{"id":26,"text":27,"depth":18},"the-chime","The chime",{"id":29,"text":30,"depth":18},"the-system-notification","The system notification",{"id":32,"text":33,"depth":18},"the-taskbar-and-the-dock","The taskbar and the Dock",{"id":35,"text":36,"depth":18},"the-notification-area","The notification area",{"id":38,"text":39,"depth":11},"what-a-notification-says","What a notification says",{"id":41,"text":42,"depth":11},"notify-me-about","Notify me about",{"id":44,"text":45,"depth":11},"a-launch-command-that-crashes","A launch command that crashes",1791926756202]