Skip to content

Chimes

A chime is the command center’s attention signal: an OS notification and an audio cue when an agent crosses a state you care about. Chimes are how you stop babysitting a fleet — you look away, and the command center calls you back when a decision is yours.

Chimes fire on agent and lifecycle state transitions. The available event kinds:

  • turn-complete — a turn finished.
  • needs-input — the agent is waiting on you.
  • exited — the agent process ended.
  • error — the agent failed.
  • pr-opened — a pull request was opened.
  • pr-merged — a pull request merged.
  • conflict-detected — a merge conflict surfaced.

By default, chimes fire on turn-complete, needs-input, exited, error, pr-opened, and conflict-detected.

A sink is where a chime is delivered:

  • os-notify — an OS banner, with conditional server-side audio.
  • browser-audio — a WAV played in the dashboard tab.

By default both are active.

Repeated transitions are debounced per workspace, chat, and target state (default 500 ms) so a chatty agent does not spam you. Audio uses a named preset, resolved against the bundled chime set and your user-local ~/.agentissimo/audio/ directory.

Chime volume is a global sound setting. Set it in Settings -> General -> Chimes with the Chime volume slider. It applies to dashboard audio, previews, and supported native fallback playback.

Turn chimes on or off, adjust volume, show or hide desktop notifications, pick event presets, and preview sounds in Settings -> General -> Chimes. Project configuration still accepts the legacy chimes block in agentissimo.yaml for repository defaults. See Configure chimes.