oopsx 0.0.1 → 0.0.2

package/README.md

@@ -2,45 +2,66 @@
 
 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*
-```
-
 ## Install
 
 ```bash
 npm install -g oopsx
 ```
 
-Or run without installing:
+## Setup (recommended)
+
+Add this to your `~/.zshrc`:
 
 ```bash
-npx oopsx ls /nonexistent/path
+eval "$(oopsx init zsh)"
 ```
 
-Or via curl (macOS / Linux):
+Or for bash, add to `~/.bashrc`:
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/devesh760/oopsx/main/install.sh | bash
+eval "$(oopsx init bash)"
+```
+
+Restart your terminal. Now every failed command plays a sound automatically — no prefix needed.
+
+```
+$ git puhs origin main
+fatal: 'puhs' is not a git command.
+🔊 *sound plays*
+
+$ ls /does/not/exist
+ls: /does/not/exist: No such file or directory
+🔊 *sound plays*
+
+$ echo "hello"
+hello
+# silence — command passed
 ```
 
-## Usage
+## Wrap a single command
+
+If you don't want the shell hook, you can wrap individual commands:
 
 ```bash
-oopsx <command>
+oopsx ls /does/not/exist
+oopsx npm test
+oopsx --sound ~/bruh.mp3 make build
 ```
 
+## Custom sounds
+
 ```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
+# Use a local file
+oopsx --sound ~/bruh.mp3 npm test
+
+# Download from URL (cached automatically)
+oopsx --url https://example.com/fail.mp3 make build
+
+# Save a sound as the new default
+oopsx --sound ~/oof.mp3 --set-default echo hi
+
+# Set volume (0-100)
+oopsx --volume 50 cargo build
 ```
 
 ## Options
@@ -53,27 +74,22 @@ oopsx --once cargo build          # play only once per session
 | `--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.
+## Commands
 
-A default sound is bundled out of the box. You can replace it with `--sound <file> --set-default`.
+| Command         | Description                                      |
+| --------------- | ------------------------------------------------ |
+| `oopsx init zsh`  | Print shell hook for zsh                       |
+| `oopsx init bash` | Print shell hook for bash                      |
+| `oopsx play`      | Play the sound (used by the hook internally)   |
+| `oopsx <cmd>`     | Wrap a command and play sound on failure        |
 
-Sound priority: `--sound` > `--url` > `~/.merr/default.mp3`
+## How it works
 
-## Config
+**Shell hook mode**: After each command, the hook checks the exit code. If non-zero, it plays the sound in the background so it doesn't block your prompt.
 
-Stored in `~/.merr/`:
+**Wrapper mode**: Runs your command, checks exit code, plays sound if it failed, then exits with the same code.
 
-```
-~/.merr/
-├── config.json    # volume
-├── default.mp3    # default sound
-└── sounds/        # cached URL downloads
-```
+A default sound is bundled. Config and cached sounds live in `~/.merr/`.
 
 ## Platform support
 
@@ -90,6 +106,8 @@ npm uninstall -g oopsx
 rm -rf ~/.merr
 ```
 
+Remove the `eval "$(oopsx init ...)"` line from your shell rc file.
+
 ## License
 
 MIT

package/bin/merr.js

@@ -12,8 +12,60 @@ 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 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 +76,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 +86,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 +96,6 @@ program
       process.exit(exitCode);
     }
 
-    // --set-default: persist the resolved sound
     if (options.setDefault) {
       setDefault(soundFile);
     }
@@ -57,7 +106,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.2",
   "description": "Play a meme sound when your terminal command fails",
   "type": "module",
   "bin": {