agent-noti 1.2.0 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +80 -11
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -10,21 +10,94 @@ Works on macOS, Linux, and Windows.
|
|
|
10
10
|
npm i -g agent-noti
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
That's it. Hooks are added
|
|
13
|
+
That's it. Hooks are added automatically and the interactive sound picker launches so you can choose a theme. Restart your agent.
|
|
14
14
|
|
|
15
15
|
## What it does
|
|
16
16
|
|
|
17
17
|
| Event | Sound | Claude Code | Codex |
|
|
18
18
|
|---|---|---|---|
|
|
19
|
-
| Agent finished |
|
|
20
|
-
| Needs your input |
|
|
19
|
+
| Agent finished | idle sound | Stop | agent-turn-complete |
|
|
20
|
+
| Needs your input | input sound | PermissionRequest | approval-requested |
|
|
21
|
+
|
|
22
|
+
## Sound themes
|
|
23
|
+
|
|
24
|
+
Each theme includes a separate idle and input sound.
|
|
25
|
+
|
|
26
|
+
| Theme | Description |
|
|
27
|
+
|---|---|
|
|
28
|
+
| default | Original notification |
|
|
29
|
+
| cow | Moo! |
|
|
30
|
+
| goose | Honk! |
|
|
31
|
+
| duck | Quack quack |
|
|
32
|
+
| car | Vroom vroom |
|
|
33
|
+
| slide-whistle | Wheee! |
|
|
34
|
+
| video-game | Retro gaming |
|
|
35
|
+
| digital-glass | Sleek & modern |
|
|
21
36
|
|
|
22
37
|
## Commands
|
|
23
38
|
|
|
24
39
|
```sh
|
|
25
|
-
agent-noti
|
|
26
|
-
agent-noti
|
|
27
|
-
agent-noti
|
|
40
|
+
agent-noti install # Add hooks + pick theme (i)
|
|
41
|
+
agent-noti uninstall # Remove hooks
|
|
42
|
+
agent-noti test # Play current sounds (t)
|
|
43
|
+
agent-noti sounds # List available themes (s)
|
|
44
|
+
agent-noti pick # Interactive sound picker (p)
|
|
45
|
+
agent-noti add-custom # Use your own sound files (ac)
|
|
46
|
+
agent-noti volume <1-10> # Set volume level (v)
|
|
47
|
+
agent-noti mute # Mute notifications (m)
|
|
48
|
+
agent-noti unmute # Unmute notifications (u)
|
|
49
|
+
agent-noti reset # Reset everything (r)
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
Every command has a short alias shown in parentheses — e.g. `agent-noti v 5` instead of `agent-noti volume 5`.
|
|
53
|
+
|
|
54
|
+
## Interactive picker
|
|
55
|
+
|
|
56
|
+
```
|
|
57
|
+
agent-noti pick
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Navigate with arrow keys, preview sounds before selecting:
|
|
61
|
+
|
|
62
|
+
- **Up / Down** — navigate themes
|
|
63
|
+
- **Left** — play idle sound
|
|
64
|
+
- **Right** — play input sound
|
|
65
|
+
- **Enter** — select theme
|
|
66
|
+
- **q** — quit
|
|
67
|
+
|
|
68
|
+
The picker also includes **+ Add custom** at the bottom, which walks you through importing your own sound files. Once added, your custom sounds appear in the picker below default.
|
|
69
|
+
|
|
70
|
+
## Custom sounds
|
|
71
|
+
|
|
72
|
+
Run `agent-noti add-custom` (or select **+ Add custom** in the picker) for an interactive flow:
|
|
73
|
+
|
|
74
|
+
1. Choose idle sound — enter a file path or skip (use default)
|
|
75
|
+
2. Choose input sound — enter a file path, use same as idle, or skip
|
|
76
|
+
|
|
77
|
+
Custom files are copied to `~/.agent-noti/sounds/` so they persist across package updates.
|
|
78
|
+
|
|
79
|
+
## Volume & mute
|
|
80
|
+
|
|
81
|
+
```sh
|
|
82
|
+
agent-noti volume 5 # Set volume 1-10
|
|
83
|
+
agent-noti volume # Show current volume
|
|
84
|
+
agent-noti mute # Silence all notifications
|
|
85
|
+
agent-noti unmute # Re-enable notifications
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Setting volume while muted auto-unmutes. Volume works across all platforms.
|
|
89
|
+
|
|
90
|
+
## Config
|
|
91
|
+
|
|
92
|
+
All settings are stored in `~/.agent-noti/config.json`:
|
|
93
|
+
|
|
94
|
+
```json
|
|
95
|
+
{
|
|
96
|
+
"idle": "cow",
|
|
97
|
+
"input": "cow",
|
|
98
|
+
"volume": 10,
|
|
99
|
+
"muted": false
|
|
100
|
+
}
|
|
28
101
|
```
|
|
29
102
|
|
|
30
103
|
## Uninstall
|
|
@@ -35,16 +108,12 @@ npm uninstall -g agent-noti
|
|
|
35
108
|
|
|
36
109
|
Hooks are removed automatically.
|
|
37
110
|
|
|
38
|
-
## Custom sounds
|
|
39
|
-
|
|
40
|
-
Replace `sounds/idle.mp3` and `sounds/input.mp3` in the package directory with your own files.
|
|
41
|
-
|
|
42
111
|
## Platform support
|
|
43
112
|
|
|
44
113
|
| OS | Audio player |
|
|
45
114
|
|---|---|
|
|
46
115
|
| macOS | `afplay` (built-in) |
|
|
47
|
-
| Linux | `ffplay`, `paplay`, or `mpv` |
|
|
116
|
+
| Linux | `ffplay`, `paplay`, or `mpv` (tries in order) |
|
|
48
117
|
| Windows | PowerShell MediaPlayer |
|
|
49
118
|
|
|
50
119
|
## License
|