oopsx 0.0.1 → 0.0.3

package/README.md

@@ -1,14 +1,6 @@
 # oopsx
 
-A CLI that plays a meme sound when your terminal command fails.
-
-Wrap any command with `oopsx`. If it fails (non-zero exit code), you hear a sound. If it passes, nothing happens. Your original output and exit code are preserved.
-
-```
-$ oopsx git puhs origin main
-fatal: 'puhs' is not a git command.
-🔊 *plays sound*
-```
+Play a meme sound when your terminal command fails. Comes with a default sound out of the box.
 
 ## Install
 
@@ -16,76 +8,18 @@ fatal: 'puhs' is not a git command.
 npm install -g oopsx
 ```
 
-Or run without installing:
-
-```bash
-npx oopsx ls /nonexistent/path
-```
-
-Or via curl (macOS / Linux):
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/devesh760/oopsx/main/install.sh | bash
-```
+Restart your terminal. Every failed command now plays a sound.
 
-## Usage
-
-```bash
-oopsx <command>
-```
+## Custom sound
 
 ```bash
-oopsx ls /does/not/exist          # plays default sound on failure
-oopsx --sound ~/bruh.mp3 npm test # use a custom sound
-oopsx --url https://x.com/f.mp3 make build  # download + cache a sound
-oopsx --volume 50 python script.py           # set volume (0-100)
-oopsx --sound ~/oof.mp3 --set-default echo hi  # save as default
-oopsx --once cargo build          # play only once per session
+oopsx --sound ~/bruh.mp3 --set-default echo hi
 ```
 
-## Options
-
-| Option              | Description                                   |
-| ------------------- | --------------------------------------------- |
-| `--sound <path>`    | Use a local `.mp3` or `.wav` file             |
-| `--url <url>`       | Download and cache a sound from a URL         |
-| `--volume <0-100>`  | Playback volume (default: `80`)               |
-| `--set-default`     | Save the resolved sound as the new default    |
-| `--once`            | Play sound only once per shell session        |
-
-## How it works
-
-1. Runs your command with inherited stdio — you see all output as normal.
-2. If exit code is `0`, does nothing.
-3. If exit code is non-zero, plays a sound.
-4. Exits with the **same exit code** as your command.
-
-A default sound is bundled out of the box. You can replace it with `--sound <file> --set-default`.
-
-Sound priority: `--sound` > `--url` > `~/.merr/default.mp3`
-
-## Config
-
-Stored in `~/.merr/`:
-
-```
-~/.merr/
-├── config.json    # volume
-├── default.mp3    # default sound
-└── sounds/        # cached URL downloads
-```
-
-## Platform support
-
-| Platform | Backend              |
-| -------- | -------------------- |
-| macOS    | `afplay` (built-in)  |
-| Linux    | `aplay` / `mpg123`   |
-| Windows  | PowerShell fallback  |
-
 ## Uninstall
 
 ```bash
+oopsx remove
 npm uninstall -g oopsx
 rm -rf ~/.merr
 ```

package/bin/merr.js

@@ -1,10 +1,33 @@
 #!/usr/bin/env node
 
+import { existsSync, readFileSync, appendFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
 import { Command } from "commander";
 import { runCommand } from "../src/runner.js";
 import { resolveSound, playAudio, setDefault, setVolume } from "../src/sound.js";
 import { readConfig } from "../src/config.js";
 
+const HOOK_MARKER = "# oopsx shell hook";
+
+const getShellRc = () => {
+  const shell = (process.env.SHELL || "").toLowerCase();
+  if (shell.endsWith("zsh")) return { file: join(homedir(), ".zshrc"), type: "zsh" };
+  if (shell.endsWith("bash")) return { file: join(homedir(), ".bashrc"), type: "bash" };
+  return null;
+};
+
+const hookSnippet = (type) => {
+  if (type === "zsh") {
+    return `
+${HOOK_MARKER}
+eval "$(oopsx init zsh)"`;
+  }
+  return `
+${HOOK_MARKER}
+eval "$(oopsx init bash)"`;
+};
+
 const SESSION_KEY = `OOPSX_PLAYED_${process.ppid}`;
 
 const program = new Command();
@@ -12,8 +35,111 @@ const program = new Command();
 program
   .name("oopsx")
   .description("Play a meme sound when your terminal command fails")
-  .version("1.0.0")
-  .argument("<command...>", "Shell command to execute")
+  .version("1.0.0");
+
+// --- `oopsx init <shell>` — output shell hook snippet ---
+program
+  .command("init <shell>")
+  .description("Print shell hook to auto-play sound on errors (zsh or bash)")
+  .action((shell) => {
+    const normalized = shell.toLowerCase().trim();
+
+    if (normalized === "zsh") {
+      console.log(`
+__oopsx_precmd() {
+  local exit_code=$?
+  [[ $exit_code -ne 0 ]] && oopsx play &>/dev/null &
+  return $exit_code
+}
+precmd_functions+=(__oopsx_precmd)
+`.trim());
+    } else if (normalized === "bash") {
+      console.log(`
+__oopsx_prompt_command() {
+  local exit_code=$?
+  [[ $exit_code -ne 0 ]] && oopsx play &>/dev/null &
+  return $exit_code
+}
+PROMPT_COMMAND="__oopsx_prompt_command;\${PROMPT_COMMAND}"
+`.trim());
+    } else {
+      console.error(`Unsupported shell: ${shell}. Use "zsh" or "bash".`);
+      process.exit(1);
+    }
+  });
+
+// --- `oopsx setup` — auto-add hook to shell rc file ---
+program
+  .command("setup")
+  .description("Automatically add the shell hook to your .zshrc or .bashrc")
+  .action(() => {
+    const rc = getShellRc();
+    if (!rc) {
+      console.error("Could not detect your shell. Manually add: eval \"$(oopsx init zsh)\" to your rc file.");
+      process.exit(1);
+    }
+
+    if (existsSync(rc.file)) {
+      const contents = readFileSync(rc.file, "utf-8");
+      if (contents.includes(HOOK_MARKER)) {
+        console.log(`Already set up in ${rc.file}`);
+        return;
+      }
+    }
+
+    appendFileSync(rc.file, hookSnippet(rc.type), "utf-8");
+    console.log(`Added oopsx hook to ${rc.file}`);
+    console.log("Restart your terminal or run: source " + rc.file);
+  });
+
+// --- `oopsx remove` — remove hook from shell rc file ---
+program
+  .command("remove")
+  .description("Remove the shell hook from your .zshrc or .bashrc")
+  .action(() => {
+    const rc = getShellRc();
+    if (!rc || !existsSync(rc.file)) {
+      console.log("Nothing to remove.");
+      return;
+    }
+
+    const contents = readFileSync(rc.file, "utf-8");
+    if (!contents.includes(HOOK_MARKER)) {
+      console.log("No oopsx hook found in " + rc.file);
+      return;
+    }
+
+    const cleaned = contents
+      .split("\n")
+      .filter((line) => !line.includes("oopsx") && line !== HOOK_MARKER)
+      .join("\n");
+
+    writeFileSync(rc.file, cleaned, "utf-8");
+    console.log(`Removed oopsx hook from ${rc.file}`);
+    console.log("Restart your terminal or run: source " + rc.file);
+  });
+
+// --- `oopsx play` — just play the sound (used by shell hook) ---
+program
+  .command("play")
+  .description("Play the error sound (used internally by the shell hook)")
+  .action(async () => {
+    const config = readConfig();
+    const soundFile = await resolveSound({});
+
+    if (!soundFile) process.exit(0);
+
+    try {
+      await playAudio(soundFile, config.volume ?? 80);
+    } catch {
+      // silent — this runs in background, don't pollute the terminal
+    }
+  });
+
+// --- `oopsx run <command...>` — wrap a single command (original behavior) ---
+program
+  .command("run <command...>", { isDefault: true })
+  .description("Execute a command and play sound on failure")
   .option("--sound <path>", "Use a local sound file (mp3/wav)")
   .option("--url <url>", "Download and cache a sound from a URL")
   .option("--volume <number>", "Playback volume 0–100", parseInt)
@@ -24,7 +150,6 @@ program
     const config = readConfig();
     const volume = options.volume ?? config.volume ?? 80;
 
-    // Persist volume if explicitly provided
     if (options.volume !== undefined) {
       setVolume(options.volume);
     }
@@ -35,7 +160,6 @@ program
       process.exit(0);
     }
 
-    // --once: skip if already played in this shell session
     if (options.once && process.env[SESSION_KEY]) {
       process.exit(exitCode);
     }
@@ -46,7 +170,6 @@ program
       process.exit(exitCode);
     }
 
-    // --set-default: persist the resolved sound
     if (options.setDefault) {
       setDefault(soundFile);
     }
@@ -57,7 +180,6 @@ program
       console.error(`Sound playback failed: ${err.message}`);
     }
 
-    // Mark as played for --once (only useful if parent reads env, but we set it anyway)
     if (options.once) {
       process.env[SESSION_KEY] = "1";
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oopsx",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Play a meme sound when your terminal command fails",
   "type": "module",
   "bin": {
@@ -32,6 +32,9 @@
   "bugs": {
     "url": "https://github.com/devesh760/oopsx/issues"
   },
+  "scripts": {
+    "postinstall": "node bin/merr.js setup"
+  },
   "dependencies": {
     "commander": "^12.1.0",
     "play-sound": "^1.1.6"