claudible 0.1.1__tar.gz → 0.1.2__tar.gz
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.
- {claudible-0.1.1 → claudible-0.1.2}/PKG-INFO +58 -36
- claudible-0.1.2/README.md +140 -0
- {claudible-0.1.1 → claudible-0.1.2}/pyproject.toml +1 -1
- {claudible-0.1.1 → claudible-0.1.2}/src/claudible.egg-info/PKG-INFO +58 -36
- claudible-0.1.1/README.md +0 -118
- {claudible-0.1.1 → claudible-0.1.2}/setup.cfg +0 -0
- {claudible-0.1.1 → claudible-0.1.2}/src/claudible/__init__.py +0 -0
- {claudible-0.1.1 → claudible-0.1.2}/src/claudible/__main__.py +0 -0
- {claudible-0.1.1 → claudible-0.1.2}/src/claudible/audio.py +0 -0
- {claudible-0.1.1 → claudible-0.1.2}/src/claudible/cli.py +0 -0
- {claudible-0.1.1 → claudible-0.1.2}/src/claudible/materials.py +0 -0
- {claudible-0.1.1 → claudible-0.1.2}/src/claudible/monitor.py +0 -0
- {claudible-0.1.1 → claudible-0.1.2}/src/claudible.egg-info/SOURCES.txt +0 -0
- {claudible-0.1.1 → claudible-0.1.2}/src/claudible.egg-info/dependency_links.txt +0 -0
- {claudible-0.1.1 → claudible-0.1.2}/src/claudible.egg-info/entry_points.txt +0 -0
- {claudible-0.1.1 → claudible-0.1.2}/src/claudible.egg-info/requires.txt +0 -0
- {claudible-0.1.1 → claudible-0.1.2}/src/claudible.egg-info/top_level.txt +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: claudible
|
|
3
|
-
Version: 0.1.
|
|
3
|
+
Version: 0.1.2
|
|
4
4
|
Summary: Ambient audio soundscape feedback for terminal output - an opus for your terminals
|
|
5
5
|
License: MIT
|
|
6
6
|
Project-URL: Homepage, https://github.com/anthropics/claudible
|
|
@@ -23,23 +23,45 @@ Requires-Dist: numpy>=1.20.0
|
|
|
23
23
|
Requires-Dist: scipy>=1.7.0
|
|
24
24
|
Requires-Dist: sounddevice>=0.4.0
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
```
|
|
27
|
+
♪ ♫ ♪
|
|
28
|
+
┌─────────┐
|
|
29
|
+
│ ╭─────╮ │ ♩
|
|
30
|
+
│ │ ▓▓▓ │ │
|
|
31
|
+
│ │ ▓▓▓ │ │ ♬ ┈┈┈╮
|
|
32
|
+
│ ╰─────╯ │ ♪ │
|
|
33
|
+
│ claude │ ♫ │
|
|
34
|
+
└────┬────┘ ♩ ≋≋≋
|
|
35
|
+
══════╧══════ ≋≋≋≋≋
|
|
36
|
+
♪ audible ♫ ≋≋≋
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
# 🎵 claudible
|
|
27
40
|
|
|
28
41
|
*An opus for your terminals.*
|
|
29
42
|
|
|
30
43
|
Possibly the most annoying Claude utility ever made but here it is anyway. Ambient audio soundscape feedback for terminal output.
|
|
31
44
|
|
|
32
|
-
## The Idea
|
|
45
|
+
## 🎼 The Idea
|
|
33
46
|
|
|
34
|
-
Imagine you are working in a factory. Each Claude Code session is a machine that must be attended to. When it's working, you hear it
|
|
47
|
+
Imagine you are working in a factory. Each Claude Code session is a machine that must be attended to. When it's working, you hear it — crystalline sparkles as text flows, soft chimes when tasks complete. When it goes quiet, you know something needs your attention.
|
|
35
48
|
|
|
36
|
-
## Installation
|
|
49
|
+
## 🎶 Installation
|
|
37
50
|
|
|
38
51
|
```bash
|
|
52
|
+
# Recommended (handles PATH automatically)
|
|
53
|
+
brew install pipx && pipx ensurepath # macOS
|
|
54
|
+
# or: pip install --user pipx && pipx ensurepath
|
|
55
|
+
|
|
56
|
+
pipx install claudible
|
|
57
|
+
|
|
58
|
+
# Or with pip
|
|
39
59
|
pip install claudible
|
|
40
60
|
```
|
|
41
61
|
|
|
42
|
-
|
|
62
|
+
> **`claudible` command not found?** If you used `pip install --user`, the script directory may not be on your PATH. Use `python3 -m claudible` instead, or switch to `pipx`.
|
|
63
|
+
|
|
64
|
+
## 🎹 Usage
|
|
43
65
|
|
|
44
66
|
```bash
|
|
45
67
|
# Run claude with audio feedback (default)
|
|
@@ -61,7 +83,7 @@ claudible --volume 0.3
|
|
|
61
83
|
claudible --list-characters
|
|
62
84
|
```
|
|
63
85
|
|
|
64
|
-
### Reverse Mode
|
|
86
|
+
### 🔇 Reverse Mode
|
|
65
87
|
|
|
66
88
|
In reverse mode, claudible is silent while output is flowing and plays ambient sound during silence. Useful when you want to know a task is *waiting* rather than *working*.
|
|
67
89
|
|
|
@@ -73,7 +95,7 @@ claudible --reverse
|
|
|
73
95
|
claudible --reverse -c shell
|
|
74
96
|
```
|
|
75
97
|
|
|
76
|
-
## Works With Any CLI
|
|
98
|
+
## 🎧 Works With Any CLI
|
|
77
99
|
|
|
78
100
|
Built for Claude Code, but claudible works with anything that produces terminal output.
|
|
79
101
|
|
|
@@ -88,37 +110,37 @@ npm run dev 2>&1 | claudible --pipe
|
|
|
88
110
|
tail -f /var/log/app.log | claudible --pipe -c droplet
|
|
89
111
|
```
|
|
90
112
|
|
|
91
|
-
## Sound Characters
|
|
92
|
-
|
|
93
|
-
| Character | Description |
|
|
94
|
-
|
|
95
|
-
| `ice` | Brittle, very high, fast decay with pitch drop |
|
|
96
|
-
| `glass` | Classic wine glass ping |
|
|
97
|
-
| `crystal` | Pure lead crystal with beating from close partial pairs |
|
|
98
|
-
| `ceramic` | Duller muted earthenware tap |
|
|
99
|
-
| `bell` | Small metallic bell, classic ratios, long ring |
|
|
100
|
-
| `droplet` | Water droplet, pitch bend down, liquid |
|
|
101
|
-
| `click` | Sharp mechanical click, keyboard-like |
|
|
102
|
-
| `wood` | Hollow wooden tap, warm marimba-like resonance |
|
|
103
|
-
| `stone` | Dense slate tap, heavy and earthy |
|
|
104
|
-
| `bamboo` | Hollow tube resonance, odd harmonics, breathy and airy |
|
|
105
|
-
| `ember` | Warm crackling ember, fire-like with wide pitch scatter |
|
|
106
|
-
| `silk` | Soft breathy whisper, delicate airy texture |
|
|
107
|
-
| `shell` | Swirly ocean interference, dense phase beating |
|
|
108
|
-
| `moss` | Ultra-soft muffled earth, mossy dampness |
|
|
109
|
-
|
|
110
|
-
## Options
|
|
113
|
+
## 🎻 Sound Characters
|
|
114
|
+
|
|
115
|
+
| Character | | Description |
|
|
116
|
+
|-----------|---|-------------|
|
|
117
|
+
| `ice` | 🧊 | Brittle, very high, fast decay with pitch drop |
|
|
118
|
+
| `glass` | 🍷 | Classic wine glass ping |
|
|
119
|
+
| `crystal` | 💎 | Pure lead crystal with beating from close partial pairs |
|
|
120
|
+
| `ceramic` | 🏺 | Duller muted earthenware tap |
|
|
121
|
+
| `bell` | 🔔 | Small metallic bell, classic ratios, long ring |
|
|
122
|
+
| `droplet` | 💧 | Water droplet, pitch bend down, liquid |
|
|
123
|
+
| `click` | ⌨️ | Sharp mechanical click, keyboard-like |
|
|
124
|
+
| `wood` | 🪵 | Hollow wooden tap, warm marimba-like resonance |
|
|
125
|
+
| `stone` | 🪨 | Dense slate tap, heavy and earthy |
|
|
126
|
+
| `bamboo` | 🎋 | Hollow tube resonance, odd harmonics, breathy and airy |
|
|
127
|
+
| `ember` | 🔥 | Warm crackling ember, fire-like with wide pitch scatter |
|
|
128
|
+
| `silk` | 🪶 | Soft breathy whisper, delicate airy texture |
|
|
129
|
+
| `shell` | 🐚 | Swirly ocean interference, dense phase beating |
|
|
130
|
+
| `moss` | 🌿 | Ultra-soft muffled earth, mossy dampness |
|
|
131
|
+
|
|
132
|
+
## 🎛️ Options
|
|
111
133
|
|
|
112
134
|
| Flag | Description |
|
|
113
135
|
|------|-------------|
|
|
114
|
-
| `--pipe` | Read from stdin instead of wrapping |
|
|
115
|
-
| `--character`, `-c` | Sound character |
|
|
116
|
-
| `--volume`, `-v` | Volume 0.0
|
|
117
|
-
| `--attention`, `-a` | Silence alert seconds (default: 30) |
|
|
118
|
-
| `--reverse`, `-r` | Reverse mode: sound during silence, quiet during output |
|
|
119
|
-
| `--list-characters` | Show presets |
|
|
136
|
+
| `--pipe` | 📥 Read from stdin instead of wrapping |
|
|
137
|
+
| `--character`, `-c` | 🎵 Sound character |
|
|
138
|
+
| `--volume`, `-v` | 🔊 Volume 0.0–1.0 (default: 0.5) |
|
|
139
|
+
| `--attention`, `-a` | ⏰ Silence alert seconds (default: 30) |
|
|
140
|
+
| `--reverse`, `-r` | 🔄 Reverse mode: sound during silence, quiet during output |
|
|
141
|
+
| `--list-characters` | 📋 Show presets |
|
|
120
142
|
|
|
121
|
-
## Development
|
|
143
|
+
## 🛠️ Development
|
|
122
144
|
|
|
123
145
|
Test locally without installing:
|
|
124
146
|
|
|
@@ -138,6 +160,6 @@ echo "test" | PYTHONPATH=src python3 -m claudible --pipe -c glass
|
|
|
138
160
|
PYTHONPATH=src python3 -m claudible --list-characters
|
|
139
161
|
```
|
|
140
162
|
|
|
141
|
-
## License
|
|
163
|
+
## 📜 License
|
|
142
164
|
|
|
143
165
|
MIT
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
```
|
|
2
|
+
♪ ♫ ♪
|
|
3
|
+
┌─────────┐
|
|
4
|
+
│ ╭─────╮ │ ♩
|
|
5
|
+
│ │ ▓▓▓ │ │
|
|
6
|
+
│ │ ▓▓▓ │ │ ♬ ┈┈┈╮
|
|
7
|
+
│ ╰─────╯ │ ♪ │
|
|
8
|
+
│ claude │ ♫ │
|
|
9
|
+
└────┬────┘ ♩ ≋≋≋
|
|
10
|
+
══════╧══════ ≋≋≋≋≋
|
|
11
|
+
♪ audible ♫ ≋≋≋
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
# 🎵 claudible
|
|
15
|
+
|
|
16
|
+
*An opus for your terminals.*
|
|
17
|
+
|
|
18
|
+
Possibly the most annoying Claude utility ever made but here it is anyway. Ambient audio soundscape feedback for terminal output.
|
|
19
|
+
|
|
20
|
+
## 🎼 The Idea
|
|
21
|
+
|
|
22
|
+
Imagine you are working in a factory. Each Claude Code session is a machine that must be attended to. When it's working, you hear it — crystalline sparkles as text flows, soft chimes when tasks complete. When it goes quiet, you know something needs your attention.
|
|
23
|
+
|
|
24
|
+
## 🎶 Installation
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
# Recommended (handles PATH automatically)
|
|
28
|
+
brew install pipx && pipx ensurepath # macOS
|
|
29
|
+
# or: pip install --user pipx && pipx ensurepath
|
|
30
|
+
|
|
31
|
+
pipx install claudible
|
|
32
|
+
|
|
33
|
+
# Or with pip
|
|
34
|
+
pip install claudible
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
> **`claudible` command not found?** If you used `pip install --user`, the script directory may not be on your PATH. Use `python3 -m claudible` instead, or switch to `pipx`.
|
|
38
|
+
|
|
39
|
+
## 🎹 Usage
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
# Run claude with audio feedback (default)
|
|
43
|
+
claudible
|
|
44
|
+
|
|
45
|
+
# Run a different command
|
|
46
|
+
claudible "python my_script.py"
|
|
47
|
+
|
|
48
|
+
# Pipe mode
|
|
49
|
+
some-command 2>&1 | claudible --pipe
|
|
50
|
+
|
|
51
|
+
# Choose a sound character
|
|
52
|
+
claudible --character crystal
|
|
53
|
+
|
|
54
|
+
# Adjust volume
|
|
55
|
+
claudible --volume 0.3
|
|
56
|
+
|
|
57
|
+
# List available characters
|
|
58
|
+
claudible --list-characters
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### 🔇 Reverse Mode
|
|
62
|
+
|
|
63
|
+
In reverse mode, claudible is silent while output is flowing and plays ambient sound during silence. Useful when you want to know a task is *waiting* rather than *working*.
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
# Ambient grains play when Claude is idle/waiting for you
|
|
67
|
+
claudible --reverse
|
|
68
|
+
|
|
69
|
+
# Combine with a character
|
|
70
|
+
claudible --reverse -c shell
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
## 🎧 Works With Any CLI
|
|
74
|
+
|
|
75
|
+
Built for Claude Code, but claudible works with anything that produces terminal output.
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
# Aider
|
|
79
|
+
claudible "aider"
|
|
80
|
+
|
|
81
|
+
# Watch a dev server
|
|
82
|
+
npm run dev 2>&1 | claudible --pipe
|
|
83
|
+
|
|
84
|
+
# Monitor logs
|
|
85
|
+
tail -f /var/log/app.log | claudible --pipe -c droplet
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## 🎻 Sound Characters
|
|
89
|
+
|
|
90
|
+
| Character | | Description |
|
|
91
|
+
|-----------|---|-------------|
|
|
92
|
+
| `ice` | 🧊 | Brittle, very high, fast decay with pitch drop |
|
|
93
|
+
| `glass` | 🍷 | Classic wine glass ping |
|
|
94
|
+
| `crystal` | 💎 | Pure lead crystal with beating from close partial pairs |
|
|
95
|
+
| `ceramic` | 🏺 | Duller muted earthenware tap |
|
|
96
|
+
| `bell` | 🔔 | Small metallic bell, classic ratios, long ring |
|
|
97
|
+
| `droplet` | 💧 | Water droplet, pitch bend down, liquid |
|
|
98
|
+
| `click` | ⌨️ | Sharp mechanical click, keyboard-like |
|
|
99
|
+
| `wood` | 🪵 | Hollow wooden tap, warm marimba-like resonance |
|
|
100
|
+
| `stone` | 🪨 | Dense slate tap, heavy and earthy |
|
|
101
|
+
| `bamboo` | 🎋 | Hollow tube resonance, odd harmonics, breathy and airy |
|
|
102
|
+
| `ember` | 🔥 | Warm crackling ember, fire-like with wide pitch scatter |
|
|
103
|
+
| `silk` | 🪶 | Soft breathy whisper, delicate airy texture |
|
|
104
|
+
| `shell` | 🐚 | Swirly ocean interference, dense phase beating |
|
|
105
|
+
| `moss` | 🌿 | Ultra-soft muffled earth, mossy dampness |
|
|
106
|
+
|
|
107
|
+
## 🎛️ Options
|
|
108
|
+
|
|
109
|
+
| Flag | Description |
|
|
110
|
+
|------|-------------|
|
|
111
|
+
| `--pipe` | 📥 Read from stdin instead of wrapping |
|
|
112
|
+
| `--character`, `-c` | 🎵 Sound character |
|
|
113
|
+
| `--volume`, `-v` | 🔊 Volume 0.0–1.0 (default: 0.5) |
|
|
114
|
+
| `--attention`, `-a` | ⏰ Silence alert seconds (default: 30) |
|
|
115
|
+
| `--reverse`, `-r` | 🔄 Reverse mode: sound during silence, quiet during output |
|
|
116
|
+
| `--list-characters` | 📋 Show presets |
|
|
117
|
+
|
|
118
|
+
## 🛠️ Development
|
|
119
|
+
|
|
120
|
+
Test locally without installing:
|
|
121
|
+
|
|
122
|
+
```bash
|
|
123
|
+
cd claudible
|
|
124
|
+
|
|
125
|
+
# Run wrapping claude (Ctrl+C to stop)
|
|
126
|
+
PYTHONPATH=src python3 -m claudible
|
|
127
|
+
|
|
128
|
+
# Wrap a different command
|
|
129
|
+
PYTHONPATH=src python3 -m claudible "ls -la"
|
|
130
|
+
|
|
131
|
+
# Pipe mode
|
|
132
|
+
echo "test" | PYTHONPATH=src python3 -m claudible --pipe -c glass
|
|
133
|
+
|
|
134
|
+
# List characters
|
|
135
|
+
PYTHONPATH=src python3 -m claudible --list-characters
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
## 📜 License
|
|
139
|
+
|
|
140
|
+
MIT
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: claudible
|
|
3
|
-
Version: 0.1.
|
|
3
|
+
Version: 0.1.2
|
|
4
4
|
Summary: Ambient audio soundscape feedback for terminal output - an opus for your terminals
|
|
5
5
|
License: MIT
|
|
6
6
|
Project-URL: Homepage, https://github.com/anthropics/claudible
|
|
@@ -23,23 +23,45 @@ Requires-Dist: numpy>=1.20.0
|
|
|
23
23
|
Requires-Dist: scipy>=1.7.0
|
|
24
24
|
Requires-Dist: sounddevice>=0.4.0
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
```
|
|
27
|
+
♪ ♫ ♪
|
|
28
|
+
┌─────────┐
|
|
29
|
+
│ ╭─────╮ │ ♩
|
|
30
|
+
│ │ ▓▓▓ │ │
|
|
31
|
+
│ │ ▓▓▓ │ │ ♬ ┈┈┈╮
|
|
32
|
+
│ ╰─────╯ │ ♪ │
|
|
33
|
+
│ claude │ ♫ │
|
|
34
|
+
└────┬────┘ ♩ ≋≋≋
|
|
35
|
+
══════╧══════ ≋≋≋≋≋
|
|
36
|
+
♪ audible ♫ ≋≋≋
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
# 🎵 claudible
|
|
27
40
|
|
|
28
41
|
*An opus for your terminals.*
|
|
29
42
|
|
|
30
43
|
Possibly the most annoying Claude utility ever made but here it is anyway. Ambient audio soundscape feedback for terminal output.
|
|
31
44
|
|
|
32
|
-
## The Idea
|
|
45
|
+
## 🎼 The Idea
|
|
33
46
|
|
|
34
|
-
Imagine you are working in a factory. Each Claude Code session is a machine that must be attended to. When it's working, you hear it
|
|
47
|
+
Imagine you are working in a factory. Each Claude Code session is a machine that must be attended to. When it's working, you hear it — crystalline sparkles as text flows, soft chimes when tasks complete. When it goes quiet, you know something needs your attention.
|
|
35
48
|
|
|
36
|
-
## Installation
|
|
49
|
+
## 🎶 Installation
|
|
37
50
|
|
|
38
51
|
```bash
|
|
52
|
+
# Recommended (handles PATH automatically)
|
|
53
|
+
brew install pipx && pipx ensurepath # macOS
|
|
54
|
+
# or: pip install --user pipx && pipx ensurepath
|
|
55
|
+
|
|
56
|
+
pipx install claudible
|
|
57
|
+
|
|
58
|
+
# Or with pip
|
|
39
59
|
pip install claudible
|
|
40
60
|
```
|
|
41
61
|
|
|
42
|
-
|
|
62
|
+
> **`claudible` command not found?** If you used `pip install --user`, the script directory may not be on your PATH. Use `python3 -m claudible` instead, or switch to `pipx`.
|
|
63
|
+
|
|
64
|
+
## 🎹 Usage
|
|
43
65
|
|
|
44
66
|
```bash
|
|
45
67
|
# Run claude with audio feedback (default)
|
|
@@ -61,7 +83,7 @@ claudible --volume 0.3
|
|
|
61
83
|
claudible --list-characters
|
|
62
84
|
```
|
|
63
85
|
|
|
64
|
-
### Reverse Mode
|
|
86
|
+
### 🔇 Reverse Mode
|
|
65
87
|
|
|
66
88
|
In reverse mode, claudible is silent while output is flowing and plays ambient sound during silence. Useful when you want to know a task is *waiting* rather than *working*.
|
|
67
89
|
|
|
@@ -73,7 +95,7 @@ claudible --reverse
|
|
|
73
95
|
claudible --reverse -c shell
|
|
74
96
|
```
|
|
75
97
|
|
|
76
|
-
## Works With Any CLI
|
|
98
|
+
## 🎧 Works With Any CLI
|
|
77
99
|
|
|
78
100
|
Built for Claude Code, but claudible works with anything that produces terminal output.
|
|
79
101
|
|
|
@@ -88,37 +110,37 @@ npm run dev 2>&1 | claudible --pipe
|
|
|
88
110
|
tail -f /var/log/app.log | claudible --pipe -c droplet
|
|
89
111
|
```
|
|
90
112
|
|
|
91
|
-
## Sound Characters
|
|
92
|
-
|
|
93
|
-
| Character | Description |
|
|
94
|
-
|
|
95
|
-
| `ice` | Brittle, very high, fast decay with pitch drop |
|
|
96
|
-
| `glass` | Classic wine glass ping |
|
|
97
|
-
| `crystal` | Pure lead crystal with beating from close partial pairs |
|
|
98
|
-
| `ceramic` | Duller muted earthenware tap |
|
|
99
|
-
| `bell` | Small metallic bell, classic ratios, long ring |
|
|
100
|
-
| `droplet` | Water droplet, pitch bend down, liquid |
|
|
101
|
-
| `click` | Sharp mechanical click, keyboard-like |
|
|
102
|
-
| `wood` | Hollow wooden tap, warm marimba-like resonance |
|
|
103
|
-
| `stone` | Dense slate tap, heavy and earthy |
|
|
104
|
-
| `bamboo` | Hollow tube resonance, odd harmonics, breathy and airy |
|
|
105
|
-
| `ember` | Warm crackling ember, fire-like with wide pitch scatter |
|
|
106
|
-
| `silk` | Soft breathy whisper, delicate airy texture |
|
|
107
|
-
| `shell` | Swirly ocean interference, dense phase beating |
|
|
108
|
-
| `moss` | Ultra-soft muffled earth, mossy dampness |
|
|
109
|
-
|
|
110
|
-
## Options
|
|
113
|
+
## 🎻 Sound Characters
|
|
114
|
+
|
|
115
|
+
| Character | | Description |
|
|
116
|
+
|-----------|---|-------------|
|
|
117
|
+
| `ice` | 🧊 | Brittle, very high, fast decay with pitch drop |
|
|
118
|
+
| `glass` | 🍷 | Classic wine glass ping |
|
|
119
|
+
| `crystal` | 💎 | Pure lead crystal with beating from close partial pairs |
|
|
120
|
+
| `ceramic` | 🏺 | Duller muted earthenware tap |
|
|
121
|
+
| `bell` | 🔔 | Small metallic bell, classic ratios, long ring |
|
|
122
|
+
| `droplet` | 💧 | Water droplet, pitch bend down, liquid |
|
|
123
|
+
| `click` | ⌨️ | Sharp mechanical click, keyboard-like |
|
|
124
|
+
| `wood` | 🪵 | Hollow wooden tap, warm marimba-like resonance |
|
|
125
|
+
| `stone` | 🪨 | Dense slate tap, heavy and earthy |
|
|
126
|
+
| `bamboo` | 🎋 | Hollow tube resonance, odd harmonics, breathy and airy |
|
|
127
|
+
| `ember` | 🔥 | Warm crackling ember, fire-like with wide pitch scatter |
|
|
128
|
+
| `silk` | 🪶 | Soft breathy whisper, delicate airy texture |
|
|
129
|
+
| `shell` | 🐚 | Swirly ocean interference, dense phase beating |
|
|
130
|
+
| `moss` | 🌿 | Ultra-soft muffled earth, mossy dampness |
|
|
131
|
+
|
|
132
|
+
## 🎛️ Options
|
|
111
133
|
|
|
112
134
|
| Flag | Description |
|
|
113
135
|
|------|-------------|
|
|
114
|
-
| `--pipe` | Read from stdin instead of wrapping |
|
|
115
|
-
| `--character`, `-c` | Sound character |
|
|
116
|
-
| `--volume`, `-v` | Volume 0.0
|
|
117
|
-
| `--attention`, `-a` | Silence alert seconds (default: 30) |
|
|
118
|
-
| `--reverse`, `-r` | Reverse mode: sound during silence, quiet during output |
|
|
119
|
-
| `--list-characters` | Show presets |
|
|
136
|
+
| `--pipe` | 📥 Read from stdin instead of wrapping |
|
|
137
|
+
| `--character`, `-c` | 🎵 Sound character |
|
|
138
|
+
| `--volume`, `-v` | 🔊 Volume 0.0–1.0 (default: 0.5) |
|
|
139
|
+
| `--attention`, `-a` | ⏰ Silence alert seconds (default: 30) |
|
|
140
|
+
| `--reverse`, `-r` | 🔄 Reverse mode: sound during silence, quiet during output |
|
|
141
|
+
| `--list-characters` | 📋 Show presets |
|
|
120
142
|
|
|
121
|
-
## Development
|
|
143
|
+
## 🛠️ Development
|
|
122
144
|
|
|
123
145
|
Test locally without installing:
|
|
124
146
|
|
|
@@ -138,6 +160,6 @@ echo "test" | PYTHONPATH=src python3 -m claudible --pipe -c glass
|
|
|
138
160
|
PYTHONPATH=src python3 -m claudible --list-characters
|
|
139
161
|
```
|
|
140
162
|
|
|
141
|
-
## License
|
|
163
|
+
## 📜 License
|
|
142
164
|
|
|
143
165
|
MIT
|
claudible-0.1.1/README.md
DELETED
|
@@ -1,118 +0,0 @@
|
|
|
1
|
-
# claudible
|
|
2
|
-
|
|
3
|
-
*An opus for your terminals.*
|
|
4
|
-
|
|
5
|
-
Possibly the most annoying Claude utility ever made but here it is anyway. Ambient audio soundscape feedback for terminal output.
|
|
6
|
-
|
|
7
|
-
## The Idea
|
|
8
|
-
|
|
9
|
-
Imagine you are working in a factory. Each Claude Code session is a machine that must be attended to. When it's working, you hear it - crystalline sparkles as text flows, soft chimes when tasks complete. When it goes quiet, you know something needs your attention.
|
|
10
|
-
|
|
11
|
-
## Installation
|
|
12
|
-
|
|
13
|
-
```bash
|
|
14
|
-
pip install claudible
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
## Usage
|
|
18
|
-
|
|
19
|
-
```bash
|
|
20
|
-
# Run claude with audio feedback (default)
|
|
21
|
-
claudible
|
|
22
|
-
|
|
23
|
-
# Run a different command
|
|
24
|
-
claudible "python my_script.py"
|
|
25
|
-
|
|
26
|
-
# Pipe mode
|
|
27
|
-
some-command 2>&1 | claudible --pipe
|
|
28
|
-
|
|
29
|
-
# Choose a sound character
|
|
30
|
-
claudible --character crystal
|
|
31
|
-
|
|
32
|
-
# Adjust volume
|
|
33
|
-
claudible --volume 0.3
|
|
34
|
-
|
|
35
|
-
# List available characters
|
|
36
|
-
claudible --list-characters
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
### Reverse Mode
|
|
40
|
-
|
|
41
|
-
In reverse mode, claudible is silent while output is flowing and plays ambient sound during silence. Useful when you want to know a task is *waiting* rather than *working*.
|
|
42
|
-
|
|
43
|
-
```bash
|
|
44
|
-
# Ambient grains play when Claude is idle/waiting for you
|
|
45
|
-
claudible --reverse
|
|
46
|
-
|
|
47
|
-
# Combine with a character
|
|
48
|
-
claudible --reverse -c shell
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
## Works With Any CLI
|
|
52
|
-
|
|
53
|
-
Built for Claude Code, but claudible works with anything that produces terminal output.
|
|
54
|
-
|
|
55
|
-
```bash
|
|
56
|
-
# Aider
|
|
57
|
-
claudible "aider"
|
|
58
|
-
|
|
59
|
-
# Watch a dev server
|
|
60
|
-
npm run dev 2>&1 | claudible --pipe
|
|
61
|
-
|
|
62
|
-
# Monitor logs
|
|
63
|
-
tail -f /var/log/app.log | claudible --pipe -c droplet
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
## Sound Characters
|
|
67
|
-
|
|
68
|
-
| Character | Description |
|
|
69
|
-
|-----------|-------------|
|
|
70
|
-
| `ice` | Brittle, very high, fast decay with pitch drop |
|
|
71
|
-
| `glass` | Classic wine glass ping |
|
|
72
|
-
| `crystal` | Pure lead crystal with beating from close partial pairs |
|
|
73
|
-
| `ceramic` | Duller muted earthenware tap |
|
|
74
|
-
| `bell` | Small metallic bell, classic ratios, long ring |
|
|
75
|
-
| `droplet` | Water droplet, pitch bend down, liquid |
|
|
76
|
-
| `click` | Sharp mechanical click, keyboard-like |
|
|
77
|
-
| `wood` | Hollow wooden tap, warm marimba-like resonance |
|
|
78
|
-
| `stone` | Dense slate tap, heavy and earthy |
|
|
79
|
-
| `bamboo` | Hollow tube resonance, odd harmonics, breathy and airy |
|
|
80
|
-
| `ember` | Warm crackling ember, fire-like with wide pitch scatter |
|
|
81
|
-
| `silk` | Soft breathy whisper, delicate airy texture |
|
|
82
|
-
| `shell` | Swirly ocean interference, dense phase beating |
|
|
83
|
-
| `moss` | Ultra-soft muffled earth, mossy dampness |
|
|
84
|
-
|
|
85
|
-
## Options
|
|
86
|
-
|
|
87
|
-
| Flag | Description |
|
|
88
|
-
|------|-------------|
|
|
89
|
-
| `--pipe` | Read from stdin instead of wrapping |
|
|
90
|
-
| `--character`, `-c` | Sound character |
|
|
91
|
-
| `--volume`, `-v` | Volume 0.0-1.0 (default: 0.5) |
|
|
92
|
-
| `--attention`, `-a` | Silence alert seconds (default: 30) |
|
|
93
|
-
| `--reverse`, `-r` | Reverse mode: sound during silence, quiet during output |
|
|
94
|
-
| `--list-characters` | Show presets |
|
|
95
|
-
|
|
96
|
-
## Development
|
|
97
|
-
|
|
98
|
-
Test locally without installing:
|
|
99
|
-
|
|
100
|
-
```bash
|
|
101
|
-
cd claudible
|
|
102
|
-
|
|
103
|
-
# Run wrapping claude (Ctrl+C to stop)
|
|
104
|
-
PYTHONPATH=src python3 -m claudible
|
|
105
|
-
|
|
106
|
-
# Wrap a different command
|
|
107
|
-
PYTHONPATH=src python3 -m claudible "ls -la"
|
|
108
|
-
|
|
109
|
-
# Pipe mode
|
|
110
|
-
echo "test" | PYTHONPATH=src python3 -m claudible --pipe -c glass
|
|
111
|
-
|
|
112
|
-
# List characters
|
|
113
|
-
PYTHONPATH=src python3 -m claudible --list-characters
|
|
114
|
-
```
|
|
115
|
-
|
|
116
|
-
## License
|
|
117
|
-
|
|
118
|
-
MIT
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|