Kilo-Org · IamCoder18 · Apr 3, 2026 · Apr 3, 2026 · Apr 3, 2026 · Apr 3, 2026
diff --git a/.changeset/system-notifications-sounds.md b/.changeset/system-notifications-sounds.md
@@ -0,0 +1,5 @@
+---
+"kilo-code": minor
+---
+
+Add OS-level system notifications with sound playback for agent events. When VS Code is not focused, users receive native desktop notifications (macOS Notification Center, Windows Toast, Linux notify-send) for agent task completion, permission requests, questions, and session errors. Includes 45+ configurable notification sounds and per-event enable/disable settings.
diff --git a/packages/kilo-vscode/.vscodeignore b/packages/kilo-vscode/.vscodeignore
@@ -25,3 +25,7 @@ AGENTS.md
 
 # Include bin/ directory for CLI binary (production)
 !bin/**
+
+# Include audio files for sound notifications
+!audio-wav/**
+audio/**
diff --git a/packages/kilo-vscode/audio-wav/alert-01.wav b/packages/kilo-vscode/audio-wav/alert-01.wav
diff --git a/packages/kilo-vscode/audio-wav/alert-02.wav b/packages/kilo-vscode/audio-wav/alert-02.wav
diff --git a/packages/kilo-vscode/audio-wav/alert-03.wav b/packages/kilo-vscode/audio-wav/alert-03.wav
diff --git a/packages/kilo-vscode/audio-wav/alert-04.wav b/packages/kilo-vscode/audio-wav/alert-04.wav
diff --git a/packages/kilo-vscode/audio-wav/alert-05.wav b/packages/kilo-vscode/audio-wav/alert-05.wav
diff --git a/packages/kilo-vscode/audio-wav/alert-06.wav b/packages/kilo-vscode/audio-wav/alert-06.wav
diff --git a/packages/kilo-vscode/audio-wav/alert-07.wav b/packages/kilo-vscode/audio-wav/alert-07.wav
diff --git a/packages/kilo-vscode/audio-wav/alert-08.wav b/packages/kilo-vscode/audio-wav/alert-08.wav
diff --git a/packages/kilo-vscode/audio-wav/alert-09.wav b/packages/kilo-vscode/audio-wav/alert-09.wav
diff --git a/packages/kilo-vscode/audio-wav/alert-10.wav b/packages/kilo-vscode/audio-wav/alert-10.wav
diff --git a/packages/kilo-vscode/audio-wav/bip-bop-01.wav b/packages/kilo-vscode/audio-wav/bip-bop-01.wav
diff --git a/packages/kilo-vscode/audio-wav/bip-bop-02.wav b/packages/kilo-vscode/audio-wav/bip-bop-02.wav
diff --git a/packages/kilo-vscode/audio-wav/bip-bop-03.wav b/packages/kilo-vscode/audio-wav/bip-bop-03.wav
diff --git a/packages/kilo-vscode/audio-wav/bip-bop-04.wav b/packages/kilo-vscode/audio-wav/bip-bop-04.wav
diff --git a/packages/kilo-vscode/audio-wav/bip-bop-05.wav b/packages/kilo-vscode/audio-wav/bip-bop-05.wav
diff --git a/packages/kilo-vscode/audio-wav/bip-bop-06.wav b/packages/kilo-vscode/audio-wav/bip-bop-06.wav
diff --git a/packages/kilo-vscode/audio-wav/bip-bop-07.wav b/packages/kilo-vscode/audio-wav/bip-bop-07.wav
diff --git a/packages/kilo-vscode/audio-wav/bip-bop-08.wav b/packages/kilo-vscode/audio-wav/bip-bop-08.wav
diff --git a/packages/kilo-vscode/audio-wav/bip-bop-09.wav b/packages/kilo-vscode/audio-wav/bip-bop-09.wav
diff --git a/packages/kilo-vscode/audio-wav/bip-bop-10.wav b/packages/kilo-vscode/audio-wav/bip-bop-10.wav
diff --git a/packages/kilo-vscode/audio-wav/nope-01.wav b/packages/kilo-vscode/audio-wav/nope-01.wav
diff --git a/packages/kilo-vscode/audio-wav/nope-02.wav b/packages/kilo-vscode/audio-wav/nope-02.wav
diff --git a/packages/kilo-vscode/audio-wav/nope-03.wav b/packages/kilo-vscode/audio-wav/nope-03.wav
diff --git a/packages/kilo-vscode/audio-wav/nope-04.wav b/packages/kilo-vscode/audio-wav/nope-04.wav
diff --git a/packages/kilo-vscode/audio-wav/nope-05.wav b/packages/kilo-vscode/audio-wav/nope-05.wav
diff --git a/packages/kilo-vscode/audio-wav/nope-06.wav b/packages/kilo-vscode/audio-wav/nope-06.wav
diff --git a/packages/kilo-vscode/audio-wav/nope-07.wav b/packages/kilo-vscode/audio-wav/nope-07.wav
diff --git a/packages/kilo-vscode/audio-wav/nope-08.wav b/packages/kilo-vscode/audio-wav/nope-08.wav
diff --git a/packages/kilo-vscode/audio-wav/nope-09.wav b/packages/kilo-vscode/audio-wav/nope-09.wav
diff --git a/packages/kilo-vscode/audio-wav/nope-10.wav b/packages/kilo-vscode/audio-wav/nope-10.wav
diff --git a/packages/kilo-vscode/audio-wav/nope-11.wav b/packages/kilo-vscode/audio-wav/nope-11.wav
diff --git a/packages/kilo-vscode/audio-wav/nope-12.wav b/packages/kilo-vscode/audio-wav/nope-12.wav
diff --git a/packages/kilo-vscode/audio-wav/staplebops-01.wav b/packages/kilo-vscode/audio-wav/staplebops-01.wav
diff --git a/packages/kilo-vscode/audio-wav/staplebops-02.wav b/packages/kilo-vscode/audio-wav/staplebops-02.wav
diff --git a/packages/kilo-vscode/audio-wav/staplebops-03.wav b/packages/kilo-vscode/audio-wav/staplebops-03.wav
diff --git a/packages/kilo-vscode/audio-wav/staplebops-04.wav b/packages/kilo-vscode/audio-wav/staplebops-04.wav
diff --git a/packages/kilo-vscode/audio-wav/staplebops-05.wav b/packages/kilo-vscode/audio-wav/staplebops-05.wav
diff --git a/packages/kilo-vscode/audio-wav/staplebops-06.wav b/packages/kilo-vscode/audio-wav/staplebops-06.wav
diff --git a/packages/kilo-vscode/audio-wav/staplebops-07.wav b/packages/kilo-vscode/audio-wav/staplebops-07.wav
diff --git a/packages/kilo-vscode/audio-wav/yup-01.wav b/packages/kilo-vscode/audio-wav/yup-01.wav
diff --git a/packages/kilo-vscode/audio-wav/yup-02.wav b/packages/kilo-vscode/audio-wav/yup-02.wav
diff --git a/packages/kilo-vscode/audio-wav/yup-03.wav b/packages/kilo-vscode/audio-wav/yup-03.wav
diff --git a/packages/kilo-vscode/audio-wav/yup-04.wav b/packages/kilo-vscode/audio-wav/yup-04.wav
diff --git a/packages/kilo-vscode/audio-wav/yup-05.wav b/packages/kilo-vscode/audio-wav/yup-05.wav
diff --git a/packages/kilo-vscode/audio-wav/yup-06.wav b/packages/kilo-vscode/audio-wav/yup-06.wav
diff --git a/packages/kilo-vscode/audio/alert-01.aac b/packages/kilo-vscode/audio/alert-01.aac
diff --git a/packages/kilo-vscode/audio/alert-02.aac b/packages/kilo-vscode/audio/alert-02.aac
diff --git a/packages/kilo-vscode/audio/alert-03.aac b/packages/kilo-vscode/audio/alert-03.aac
diff --git a/packages/kilo-vscode/audio/alert-04.aac b/packages/kilo-vscode/audio/alert-04.aac
diff --git a/packages/kilo-vscode/audio/alert-05.aac b/packages/kilo-vscode/audio/alert-05.aac
diff --git a/packages/kilo-vscode/audio/alert-06.aac b/packages/kilo-vscode/audio/alert-06.aac
diff --git a/packages/kilo-vscode/audio/alert-07.aac b/packages/kilo-vscode/audio/alert-07.aac
diff --git a/packages/kilo-vscode/audio/alert-08.aac b/packages/kilo-vscode/audio/alert-08.aac
diff --git a/packages/kilo-vscode/audio/alert-09.aac b/packages/kilo-vscode/audio/alert-09.aac
diff --git a/packages/kilo-vscode/audio/alert-10.aac b/packages/kilo-vscode/audio/alert-10.aac
diff --git a/packages/kilo-vscode/audio/bip-bop-01.aac b/packages/kilo-vscode/audio/bip-bop-01.aac
diff --git a/packages/kilo-vscode/audio/bip-bop-02.aac b/packages/kilo-vscode/audio/bip-bop-02.aac
diff --git a/packages/kilo-vscode/audio/bip-bop-03.aac b/packages/kilo-vscode/audio/bip-bop-03.aac
diff --git a/packages/kilo-vscode/audio/bip-bop-04.aac b/packages/kilo-vscode/audio/bip-bop-04.aac
diff --git a/packages/kilo-vscode/audio/bip-bop-05.aac b/packages/kilo-vscode/audio/bip-bop-05.aac
diff --git a/packages/kilo-vscode/audio/bip-bop-06.aac b/packages/kilo-vscode/audio/bip-bop-06.aac
diff --git a/packages/kilo-vscode/audio/bip-bop-07.aac b/packages/kilo-vscode/audio/bip-bop-07.aac
diff --git a/packages/kilo-vscode/audio/bip-bop-08.aac b/packages/kilo-vscode/audio/bip-bop-08.aac
diff --git a/packages/kilo-vscode/audio/bip-bop-09.aac b/packages/kilo-vscode/audio/bip-bop-09.aac
diff --git a/packages/kilo-vscode/audio/bip-bop-10.aac b/packages/kilo-vscode/audio/bip-bop-10.aac
diff --git a/packages/kilo-vscode/audio/nope-01.aac b/packages/kilo-vscode/audio/nope-01.aac
diff --git a/packages/kilo-vscode/audio/nope-02.aac b/packages/kilo-vscode/audio/nope-02.aac
diff --git a/packages/kilo-vscode/audio/nope-03.aac b/packages/kilo-vscode/audio/nope-03.aac
diff --git a/packages/kilo-vscode/audio/nope-04.aac b/packages/kilo-vscode/audio/nope-04.aac
diff --git a/packages/kilo-vscode/audio/nope-05.aac b/packages/kilo-vscode/audio/nope-05.aac
diff --git a/packages/kilo-vscode/audio/nope-06.aac b/packages/kilo-vscode/audio/nope-06.aac
diff --git a/packages/kilo-vscode/audio/nope-07.aac b/packages/kilo-vscode/audio/nope-07.aac
diff --git a/packages/kilo-vscode/audio/nope-08.aac b/packages/kilo-vscode/audio/nope-08.aac
diff --git a/packages/kilo-vscode/audio/nope-09.aac b/packages/kilo-vscode/audio/nope-09.aac
diff --git a/packages/kilo-vscode/audio/nope-10.aac b/packages/kilo-vscode/audio/nope-10.aac
diff --git a/packages/kilo-vscode/audio/nope-11.aac b/packages/kilo-vscode/audio/nope-11.aac
diff --git a/packages/kilo-vscode/audio/nope-12.aac b/packages/kilo-vscode/audio/nope-12.aac
diff --git a/packages/kilo-vscode/audio/staplebops-01.aac b/packages/kilo-vscode/audio/staplebops-01.aac
diff --git a/packages/kilo-vscode/audio/staplebops-02.aac b/packages/kilo-vscode/audio/staplebops-02.aac
diff --git a/packages/kilo-vscode/audio/staplebops-03.aac b/packages/kilo-vscode/audio/staplebops-03.aac
diff --git a/packages/kilo-vscode/audio/staplebops-04.aac b/packages/kilo-vscode/audio/staplebops-04.aac
diff --git a/packages/kilo-vscode/audio/staplebops-05.aac b/packages/kilo-vscode/audio/staplebops-05.aac
diff --git a/packages/kilo-vscode/audio/staplebops-06.aac b/packages/kilo-vscode/audio/staplebops-06.aac
diff --git a/packages/kilo-vscode/audio/staplebops-07.aac b/packages/kilo-vscode/audio/staplebops-07.aac
diff --git a/packages/kilo-vscode/audio/yup-01.aac b/packages/kilo-vscode/audio/yup-01.aac
diff --git a/packages/kilo-vscode/audio/yup-02.aac b/packages/kilo-vscode/audio/yup-02.aac
diff --git a/packages/kilo-vscode/audio/yup-03.aac b/packages/kilo-vscode/audio/yup-03.aac
diff --git a/packages/kilo-vscode/audio/yup-04.aac b/packages/kilo-vscode/audio/yup-04.aac
diff --git a/packages/kilo-vscode/audio/yup-05.aac b/packages/kilo-vscode/audio/yup-05.aac
diff --git a/packages/kilo-vscode/audio/yup-06.aac b/packages/kilo-vscode/audio/yup-06.aac
diff --git a/packages/kilo-vscode/eslint.config.mjs b/packages/kilo-vscode/eslint.config.mjs
@@ -38,7 +38,7 @@ export default [
   // New code must stay ≤ 20. Do not raise these caps; refactor instead.
   {
     files: ["src/KiloProvider.ts"],
-    rules: { complexity: ["error", 150], "max-lines": ["error", 3600] },
+    rules: { complexity: ["error", 154], "max-lines": ["error", 3689] },
   },
   {
     files: ["webview-ui/agent-manager/AgentManagerApp.tsx"],

diff --git a/packages/kilo-vscode/package.json b/packages/kilo-vscode/package.json
@@ -839,28 +839,166 @@
         },
         "kilo-code.new.sounds.agent": {
           "type": "string",
-          "default": "default",
+          "default": "system",
           "enum": [
             "default",
-            "none"
+            "none",
+            "system",
+            "alert-01",
+            "alert-02",
+            "alert-03",
+            "alert-04",
+            "alert-05",
+            "alert-06",
+            "alert-07",
+            "alert-08",
+            "alert-09",
+            "alert-10",
+            "bip-bop-01",
+            "bip-bop-02",
+            "bip-bop-03",
+            "bip-bop-04",
+            "bip-bop-05",
+            "bip-bop-06",
+            "bip-bop-07",
+            "bip-bop-08",
+            "bip-bop-09",
+            "bip-bop-10",
+            "staplebops-01",
+            "staplebops-02",
+            "staplebops-03",
+            "staplebops-04",
+            "staplebops-05",
+            "staplebops-06",
+            "staplebops-07",
+            "nope-01",
+            "nope-02",
+            "nope-03",
+            "nope-04",
+            "nope-05",
+            "nope-06",
+            "nope-07",
+            "nope-08",
+            "nope-09",
+            "nope-10",
+            "nope-11",
+            "nope-12",
+            "yup-01",
+            "yup-02",
+            "yup-03",
+            "yup-04",
+            "yup-05",
+            "yup-06"
           ],
           "description": "Sound to play when agent completes"
         },
         "kilo-code.new.sounds.permissions": {
           "type": "string",
-          "default": "default",
+          "default": "system",
           "enum": [
             "default",
-            "none"
+            "none",
+            "system",
+            "alert-01",
+            "alert-02",
+            "alert-03",
+            "alert-04",
+            "alert-05",
+            "alert-06",
+            "alert-07",
+            "alert-08",
+            "alert-09",
+            "alert-10",
+            "bip-bop-01",
+            "bip-bop-02",
+            "bip-bop-03",
+            "bip-bop-04",
+            "bip-bop-05",
+            "bip-bop-06",
+            "bip-bop-07",
+            "bip-bop-08",
+            "bip-bop-09",
+            "bip-bop-10",
+            "staplebops-01",
+            "staplebops-02",
+            "staplebops-03",
+            "staplebops-04",
+            "staplebops-05",
+            "staplebops-06",
+            "staplebops-07",
+            "nope-01",
+            "nope-02",
+            "nope-03",
+            "nope-04",
+            "nope-05",
+            "nope-06",
+            "nope-07",
+            "nope-08",
+            "nope-09",
+            "nope-10",
+            "nope-11",
+            "nope-12",
+            "yup-01",
+            "yup-02",
+            "yup-03",
+            "yup-04",
+            "yup-05",
+            "yup-06"
           ],
           "description": "Sound to play on permission requests"
         },
         "kilo-code.new.sounds.errors": {
           "type": "string",
-          "default": "default",
+          "default": "system",
           "enum": [
             "default",
-            "none"
+            "none",
+            "system",
+            "alert-01",
+            "alert-02",
+            "alert-03",
+            "alert-04",
+            "alert-05",
+            "alert-06",
+            "alert-07",
+            "alert-08",
+            "alert-09",
+            "alert-10",
+            "bip-bop-01",
+            "bip-bop-02",
+            "bip-bop-03",
+            "bip-bop-04",
+            "bip-bop-05",
+            "bip-bop-06",
+            "bip-bop-07",
+            "bip-bop-08",
+            "bip-bop-09",
+            "bip-bop-10",
+            "staplebops-01",
+            "staplebops-02",
+            "staplebops-03",
+            "staplebops-04",
+            "staplebops-05",
+            "staplebops-06",
+            "staplebops-07",
+            "nope-01",
+            "nope-02",
+            "nope-03",
+            "nope-04",
+            "nope-05",
+            "nope-06",
+            "nope-07",
+            "nope-08",
+            "nope-09",
+            "nope-10",
+            "nope-11",
+            "nope-12",
+            "yup-01",
+            "yup-02",
+            "yup-03",
+            "yup-04",
+            "yup-05",
+            "yup-06"
           ],
           "description": "Sound to play on errors"
         },