vibeaudio 0.20.1 → 0.22.0

package/README.md

@@ -425,6 +425,36 @@ Installing the Claude Code hooks also adds a `/vibe` command (`~/.claude/command
 
 It asks Claude to run the matching `vibe` command, so Claude Code will ask permission for that command the first time. If you already have your own `vibe.md` there, VibeAudio leaves it alone and says so; `--uninstall-hooks` removes only its own.
 
+### `/vibeaudio`: instant controls and a pane (Claude Code mod)
+
+`/vibe` is a prompt, so Claude has to read it, run a command and answer: it costs a turn and a few tokens, and it waits for the current turn to end. The optional **VibeAudio mod** runs inside Claude Code instead, so `/vibeaudio mute` takes effect at once, even while Claude is working, and costs no tokens.
+
+```text
+claude plugin marketplace add kiril6/vibeaudio
+claude plugin install vibeaudio-mod@vibeaudio
+```
+
+Then `/reload-plugins` or a new session; `/plugin` shows `1 mod active`.
+
+```text
+/vibeaudio               open the pane: mute, music, genre, volume, speech, banners, test signal
+/vibeaudio mute 30       silence for 30 minutes (unmute ends it)
+/vibeaudio genre jazz    also: volume <n>, music on|off, speak off|auto|always, notify on|off, stop
+/vibeaudio genre zen here   genre, volume and music also take "here": save for this project only
+/vibeaudio card          make your week card; the pane shows it in terminals that draw images
+/vibeaudio strip on      an always-visible line above the prompt (off by default; strip off removes it)
+/vibeaudio doctor        the setup check in a pane, each problem with its fix (vibe --doctor)
+```
+
+While you are muted, a line above the prompt says how many minutes are left, so a forgotten mute does not look like a broken tool. Nothing else is shown unless you turn the strip on.
+
+The optional **strip** (`/vibeaudio strip on`, remembered across sessions) keeps one line above the prompt: the genre and volume, **Mute** and **Controls** buttons, and what your other agents are doing (`api waiting, web working`, in yellow when one needs you). It runs `vibe --state` every 5 seconds while it is on, and not at all while it is off. Tab to it with Ctrl+X then Tab.
+
+- **Per project.** The pane's **Saving** button switches genre, volume and music between everywhere and this project, and the pane notes when this folder has its own settings (`vibe --genre zen --here`, found from a subfolder the way the CLI does). There is no way to remove a project's settings yet, in the mod or the CLI.
+- **It changes nothing itself.** Every action runs the `vibe` command with a fixed argument list (no shell), so settings stay in `~/.vibeaudio/config.json` and the pane cannot disagree with the CLI. The one thing it keeps for itself is whether the strip is on, in Claude Code's own store for the mod. It needs `vibe` on your `PATH` (`npm i -g vibeaudio`) and **Claude Code 2.1.287 or later** (Desktop app 2.1.286). It draws in the terminal and the Desktop app; in the VS Code panel and `claude -p` the same commands answer in text. It makes no network request.
+- **A mod is code, not configuration.** It runs inside Claude Code with your permissions and is not sandboxed, which is why `--install-hooks` never installs it for you. Read it first: it is [`mods/vibe/hooks/register.js`](mods/vibe/hooks/register.js), and `claude plugin validate mods/vibe` lists every call it makes (it reads two files in `~/.vibeaudio/`, runs `vibe`, and draws).
+- **`/vibe` stays.** It works on every Claude Code version and surface; the mod is the faster path where it loads. Remove the mod with `claude plugin uninstall vibeaudio-mod@vibeaudio`.
+
 ### Changing the sound later
 
 One command, and it reaches everything:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibeaudio",
-  "version": "0.20.1",
+  "version": "0.22.0",
   "description": "Procedural focus music while your AI coding tools (Claude Code, Codex, Cursor, Grok, Gemini, Copilot) think — a different arrangement per project.",
   "bin": {
     "vibeaudio": "bin/vibeaudio.js",
@@ -10,7 +10,7 @@
   "scripts": {
     "test": "node test/test-synth.js",
     "start": "node bin/vibeaudio.js",
-    "version": "node -e \"const fs=require('fs'),v=require('./package.json').version;for(const f of ['.claude-plugin/plugin.json','.codex-plugin/plugin.json']){const j=JSON.parse(fs.readFileSync(f,'utf8'));j.version=v;fs.writeFileSync(f,JSON.stringify(j,null,2)+'\\n')}\" && git add .claude-plugin/plugin.json .codex-plugin/plugin.json"
+    "version": "node -e \"const fs=require('fs'),v=require('./package.json').version;for(const f of ['.claude-plugin/plugin.json','.codex-plugin/plugin.json','mods/vibe/.claude-plugin/plugin.json']){const j=JSON.parse(fs.readFileSync(f,'utf8'));j.version=v;fs.writeFileSync(f,JSON.stringify(j,null,2)+'\\n')}\" && git add .claude-plugin/plugin.json .codex-plugin/plugin.json mods/vibe/.claude-plugin/plugin.json"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",