Configure chimes

Chimes are on by default. Tune the everyday controls in Settings -> General -> Chimes:

• Chimes enabled — master switch.
• Chime volume — audio level from muted to full volume.
• Show desktop notifications — OS banner toggle; sound can stay on.
• Event rows — enable each event, choose its preset, and preview it.

Repository config still accepts a chimes block in agentissimo.yaml for project defaults.

A full example

version: 1
chimes:
  enabled: true
  events:
    - needs-input
    - error
    - pr-opened
  sinks:
    - os-notify
    - browser-audio
  debounceMs: 500
  audio:
    enabled: true
    preset: default
  notify:
    enabled: true

Fields

• enabled — master switch. false silences all chimes.
• events — which transitions fire. Choose from turn-complete, needs-input, exited, error, pr-opened, pr-merged, conflict-detected. Omit to use the defaults.
• sinks — delivery channels: os-notify, browser-audio. An explicit list is honoured literally — the loader never appends a default member you left out.
• debounceMs — per workspace, chat, and target state. Default 500.
• audio.preset — a name resolved against the bundled chime set and ~/.agentissimo/audio/<preset>.wav. Path separators and .. are rejected.

Quiet it down

Use Settings -> General -> Chimes to lower volume first. Want only the signal that needs you? Narrow events to needs-input and error, and drop browser-audio if the OS banner is enough:

chimes:
  events: [needs-input, error]
  sinks: [os-notify]