Skip to content
OpenDucktor Docs
openducktor.devInstall

Notifications

OpenDucktor notifies you when an agent needs you, fails, or moves a task. A notification shows in OpenDucktor, from your operating system, or both.

Turn on notifications

  1. Open Settings, then Notifications.
  2. Turn on system notifications for your platform. See System permission.
  3. Select Test in-app notification and Test system notification. A test message shows in the corner of OpenDucktor, and one shows from your operating system.
The Notifications settings in the browser runner after you allow notifications: System notifications are on, the Test in-app notification and Test system notification buttons, and the Sound and focus options.The Notifications settings in the browser runner after you allow notifications: System notifications are on, the Test in-app notification and Test system notification buttons, and the Sound and focus options.

System permission

The section shows Turn on system notifications. In step 3, select Test system notification, then select Allow in the macOS request. If the section shows System notifications are off, select Open system settings and turn on notifications for OpenDucktor.

Where notifications show

Each event uses one Delivery: In-app, System, or Both. An in-app message shows in the corner of OpenDucktor for 10 seconds. Select Open to go to the session or task.

An in-app notification in the corner of OpenDucktor: the role and task, Spec - Pin notebooks to the sidebar, the request "Codex wants to run a shell command: node --version", a close button, and Open.An in-app notification in the corner of OpenDucktor: the role and task, Spec - Pin notebooks to the sidebar, the request "Codex wants to run a shell command: node --version", a close button, and Open.

By default, system notifications show only when OpenDucktor does not have focus (When unfocused). Sounds do not play while OpenDucktor has focus (Mute when focused). To change this, set System notifications to Always and Notification sounds to Always play.

Choose the events

Each event has a rule. Turn on its Enabled switch, then choose its Delivery and its Sound.

The Agent activity rules: Permission request, Question, Session error, Session started, and Session idle, each with a Delivery choice, a Sound menu, and an Enabled switch.The Agent activity rules: Permission request, Question, Session error, Session started, and Session idle, each with a Delivery choice, a Sound menu, and an Enabled switch.
EventWhen it showsDefault
Permission requestAn agent asks for a permission.Both, Open sound
QuestionAn agent asks you a question.Both, Open sound
Session errorA session fails.Both
Session startedA main session starts.In-app
Session idleThe agent finishes its turn and waits for you.Off (Both when you turn it on)
Spec Ready, Ready for Dev, In Progress, AI Review, Human ReviewA task moves to this lane of Spec, Plan, Build. Each workflow declares its own lane events.Both
Task BlockedThe Builder blocks a task.Both, Open sound
Task ClosedA task moves to Done.In-app
Task not closedThe pull request of a task merged, but OpenDucktor could not close the task. See Approve a task.Both

Keep Permission request and Question on, because the agent waits until you reply.

A rule with no sound in the table uses Use global sound. It plays the Default sound, which is Success at 30% volume until you change it.

Next

Coding sessions

Answer the questions and permissions of an agent.

Autopilot

Let OpenDucktor start the next agent when a task moves.

Settings reference

Look up each notification setting.

Command palette

Find tasks, workspace sessions, and actions, and run workflow steps from the keyboard.

Agent prompts

Learn which prompts OpenDucktor sends to the Spec, Planner, Builder, and QA agents, and add your instructions to them or replace them, for all repositories or one repository.

On this page

Turn on notificationsSystem permissionWhere notifications showChoose the eventsNext