codevator 0.1.1 → 0.2.0

package/README.md

@@ -2,16 +2,10 @@
 
 Elevator music for your AI coding agent. Background sounds that play while Claude Code works and stop when it needs your attention.
 
-## Install
+## Quick Start
 
 ```bash
-npm install -g codevator
-```
-
-## Setup
-
-```bash
-codevator setup
+npx codevator
 ```
 
 This installs hooks into Claude Code (`~/.claude/settings.json`) that automatically:
@@ -68,8 +62,7 @@ Setup also installs a Claude Code skill that lets the agent control music direct
 ## Uninstall
 
 ```bash
-codevator uninstall
-npm uninstall -g codevator
+npx codevator uninstall
 ```
 
 ## License

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.1",
+  "version": "0.2.0",
   "type": "module",
   "description": "Elevator music for your AI coding agent",
   "bin": {