codevator 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,70 @@
+# codevator
+
+Elevator music for your AI coding agent. Background sounds that play while Claude Code works and stop when it needs your attention.
+
+## Quick Start
+
+```bash
+npx codevator
+```
+
+This installs hooks into Claude Code (`~/.claude/settings.json`) that automatically:
+
+- **Play** music when the agent starts working
+- **Stop** when it finishes or needs your input
+
+## Sound Modes
+
+Five built-in modes:
+
+| Mode | Description |
+|------|-------------|
+| `elevator` | Classic smooth jazz elevator music (default) |
+| `typewriter` | Rhythmic mechanical keystrokes |
+| `ambient` | Soft atmospheric background |
+| `retro` | Mellow 8-bit synthesized arpeggios |
+| `minimal` | Deep warm hum with slow breathing |
+
+Switch modes:
+
+```bash
+codevator mode ambient
+```
+
+## Commands
+
+```
+codevator setup            Install hooks into Claude Code
+codevator mode <name>      Set sound mode
+codevator on               Enable sounds
+codevator off              Disable sounds
+codevator volume <0-100>   Set volume level
+codevator status           Show current settings
+codevator uninstall        Remove hooks from Claude Code
+```
+
+## How It Works
+
+Codevator registers hooks in Claude Code's settings:
+
+- **PreToolUse** — starts playback when the agent begins working
+- **Stop** — stops playback when the session ends
+- **Notification** — stops on permission prompts and idle states
+
+Music plays through your system's native audio player (`afplay` on macOS, `paplay`/`aplay` on Linux).
+
+Config is stored at `~/.codevator/config.json`.
+
+## Claude Code Skill
+
+Setup also installs a Claude Code skill that lets the agent control music directly. Ask Claude to "change the music to retro" or "turn off the elevator music" and it will run the right command.
+
+## Uninstall
+
+```bash
+npx codevator uninstall
+```
+
+## License
+
+MIT

package/dist/bin.js

@@ -116,6 +116,7 @@ import fs3 from "fs";
 import path3 from "path";
 import os2 from "os";
 import { fileURLToPath as fileURLToPath2 } from "url";
+import { execSync as execSync2 } from "child_process";
 var __dirname2 = path3.dirname(fileURLToPath2(import.meta.url));
 function getClaudeDir() {
   if (process.env.CODEVATOR_CLAUDE_HOME) return process.env.CODEVATOR_CLAUDE_HOME;
@@ -136,29 +137,45 @@ function writeSettings(settings) {
   fs3.mkdirSync(dir, { recursive: true });
   fs3.writeFileSync(getSettingsPath(), JSON.stringify(settings, null, 2));
 }
-var CODEVATOR_HOOKS = {
-  PreToolUse: {
-    matcher: "",
-    hooks: [{ type: "command", command: "codevator play", async: true }]
-  },
-  Stop: {
-    matcher: "",
-    hooks: [{ type: "command", command: "codevator stop" }]
-  },
-  Notification: {
-    matcher: "permission_prompt|idle_prompt",
-    hooks: [{ type: "command", command: "codevator stop" }]
+function codevatorCommand(sub, extra) {
+  const isGlobal = isGloballyInstalled();
+  const cmd = isGlobal ? `codevator ${sub}` : `npx -y codevator ${sub}`;
+  return { type: "command", command: cmd, ...extra };
+}
+function isGloballyInstalled() {
+  try {
+    execSync2("command -v codevator", { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
   }
-};
+}
+function buildHooks() {
+  return {
+    PreToolUse: {
+      matcher: "",
+      hooks: [codevatorCommand("play", { async: true })]
+    },
+    Stop: {
+      matcher: "",
+      hooks: [codevatorCommand("stop")]
+    },
+    Notification: {
+      matcher: "permission_prompt|idle_prompt",
+      hooks: [codevatorCommand("stop")]
+    }
+  };
+}
 function isCodevatorHook(entry) {
   return entry?.hooks?.some(
-    (h) => typeof h.command === "string" && h.command.startsWith("codevator")
+    (h) => typeof h.command === "string" && (h.command.startsWith("codevator") || h.command.includes("npx -y codevator"))
   );
 }
 function setupHooks() {
   const settings = readSettings();
   if (!settings.hooks) settings.hooks = {};
-  for (const [event, hookEntry] of Object.entries(CODEVATOR_HOOKS)) {
+  const hooks = buildHooks();
+  for (const [event, hookEntry] of Object.entries(hooks)) {
     if (!settings.hooks[event]) settings.hooks[event] = [];
     settings.hooks[event] = settings.hooks[event].filter(
       (e) => !isCodevatorHook(e)
@@ -188,7 +205,7 @@ function removeSkill() {
 function removeHooks() {
   const settings = readSettings();
   if (!settings.hooks) return;
-  for (const event of Object.keys(CODEVATOR_HOOKS)) {
+  for (const event of ["PreToolUse", "Stop", "Notification"]) {
     if (!settings.hooks[event]) continue;
     settings.hooks[event] = settings.hooks[event].filter(
       (e) => !isCodevatorHook(e)
@@ -219,7 +236,10 @@ var VALID_COMMANDS = [
 ];
 function parseArgs(argv) {
   const [cmd, ...args2] = argv;
-  if (!cmd || !VALID_COMMANDS.includes(cmd)) {
+  if (!cmd) {
+    return { command: "setup", args: [] };
+  }
+  if (!VALID_COMMANDS.includes(cmd)) {
     return { command: "help", args: [] };
   }
   return { command: cmd, args: args2 };
@@ -314,16 +334,18 @@ function runUninstall() {
 function runHelp() {
   console.log(`\u{1F6D7} Codevator \u2014 Elevator music for your AI coding agent
 
-Usage: codevator <command>
+Usage: npx codevator <command>
 
 Commands:
-  setup              Install hooks into Claude Code
+  setup              Install hooks into Claude Code (default)
   mode <name>        Set sound mode (elevator|typewriter|ambient|retro|minimal)
   on                 Enable sounds
   off                Disable sounds
   volume <0-100>     Set volume level
   status             Show current settings
-  uninstall          Remove hooks from Claude Code`);
+  uninstall          Remove hooks from Claude Code
+
+Quick start: npx codevator`);
 }
 
 // src/bin.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codevator",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "description": "Elevator music for your AI coding agent",
   "bin": {