ra2-eva-cursor-hooks 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,95 @@
+# Red Alert 2 EVA Cursor Hooks
+
+Nostalgic Red Alert 2 EVA voice lines for Cursor IDE agent events. Transform your coding sessions with iconic audio feedback from the classic RTS game.
+
+## Features
+
+- **17 hook events** with custom EVA voice lines
+- **Allied & Soviet factions** - alternates based on hour (odd = Allied, even = Soviet)
+- **Audio queue** - prevents overlapping sounds when parallel tools execute
+- **Easy install** - one command via npx
+
+## Sound Mappings
+
+| Event | Sound |
+|-------|-------|
+| Session Start | "Establishing battlefield control. Stand by." |
+| Session End | "Battle control terminated." |
+| Before Shell | "Building." |
+| After Shell | "Unit ready." |
+| Before Read File | "Training." |
+| After File Edit | "Unit promoted." |
+| Before MCP | "Upgrade in progress." |
+| After MCP | "New technology acquired." |
+| Before Prompt | "New mission objective received." / "New construction options." |
+| Tool Failure | "Unit lost." |
+| Delete File | "Unit lost." |
+| Stop (completed) | "Construction complete." / "Primary objective achieved." |
+| Stop (aborted) | "Cancelled." |
+| Stop (error) | "Cannot deploy here." |
+| Subagent Start | "Reinforcements have arrived." |
+| Subagent Stop | "Objective achieved." |
+| Agent Thought | "Incoming transmission." |
+| Context Compact | "Low power." |
+
+## Installation
+
+### Via npx (recommended)
+
+```bash
+npx ra2-eva-cursor-hooks
+```
+
+Or use the shorter alias:
+
+```bash
+npx ra2-eva
+```
+
+### Manual Installation
+
+```bash
+git clone https://github.com/Toubat/cursor-hooks.git
+cd cursor-hooks
+./install.sh
+```
+
+## Prerequisites
+
+- **Bun runtime** - required to run the TypeScript hooks
+  ```bash
+  curl -fsSL https://bun.sh/install | bash
+  ```
+- **macOS** - uses `afplay` for audio playback
+
+## Uninstall
+
+```bash
+npx ra2-eva-cursor-hooks --uninstall
+```
+
+## Faction Selection
+
+The EVA voice alternates between factions based on the current hour:
+
+- **Odd hours** (1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23) → **Allied EVA** (English)
+- **Even hours** (0, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22) → **Soviet EVA** (Russian accent)
+
+## How It Works
+
+This package installs Cursor hooks that:
+
+1. Listen for agent events (tool use, file edits, shell commands, etc.)
+2. Play appropriate Red Alert 2 EVA voice lines via `afplay`
+3. Queue audio to prevent overlapping when multiple events fire simultaneously
+4. Return proper JSON responses to allow Cursor to continue
+
+Files are installed to `~/.cursor/hooks/ra2-eva/` and configured in `~/.cursor/hooks.json`.
+
+## Audio Credits
+
+Voice lines are from **Command & Conquer: Red Alert 2** by Westwood Studios / EA Games. This is a fan project for nostalgic/educational purposes.
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ra2-eva-cursor-hooks",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Red Alert 2 EVA voice lines for Cursor IDE hooks - nostalgic audio feedback for your coding sessions",
   "keywords": [
     "cursor",
@@ -25,7 +25,8 @@
   "files": [
     "bin/",
     "src/",
-    "assets/"
+    "assets/",
+    "README.md"
   ],
   "engines": {
     "node": ">=18.0.0"

package/src/player.ts

@@ -13,7 +13,7 @@ import type { Faction, HookInput, PostToolUseInput, StopInput } from "./types";
 
 // Resolve assets directory relative to this file
 const SCRIPT_DIR = dirname(Bun.main);
-const ASSETS_DIR = resolve(SCRIPT_DIR, "assets");
+const ASSETS_DIR = resolve(SCRIPT_DIR, "assets", "audio");
 
 // Lock file for audio queue
 const LOCK_FILE = "/tmp/ra2-eva-audio.lock";
@@ -130,6 +130,9 @@ export function getSoundKey(input: HookInput): string | null {
     if (toolInput.tool_name === "Read") {
       return null; // Skip - beforeReadFile handles read
     }
+    if (toolInput.tool_name === "Grep") {
+      return "beforeReadFile"; // Grep is like Read - play "Training"
+    }
     if (
       toolInput.tool_name === "Write" ||
       toolInput.tool_name === "StrReplace"
@@ -149,6 +152,10 @@ export function getSoundKey(input: HookInput): string | null {
     if (toolInput.tool_name === "Read") {
       return null;
     }
+    // Skip Grep - no sound needed after grep (like Read)
+    if (toolInput.tool_name === "Grep") {
+      return null;
+    }
     // Skip Write/StrReplace - afterFileEdit handles it
     if (
       toolInput.tool_name === "Write" ||

package/assets/audio/eva_allied/TRANSCRIPTIONS.txt

@@ -1,131 +0,0 @@
-RED ALERT 2 EVA SOUND TRANSCRIPTIONS
-============================================================
-
-ceva001.wav = Warning, nuclear silo detected.
-ceva002.wav = nuclear missile launched.
-ceva003.wav = Nuclear missile ready.
-ceva004.wav = Warning, iron curtain detected.
-ceva005.wav = Warning, iron curtain activated.
-ceva006.wav = Iron Curtain ready!
-ceva007.wav = Chronosphere detected.
-ceva008.wav = Chronosphere activated.
-ceva009.wav = Chronosphere ready.
-ceva010.wav = Weather control device detected
-ceva011.wav = Lightning storm created
-ceva012.wav = Lightning storm ready.
-ceva013.wav = Mission accomplished.
-ceva014.wav = Mission failed.
-ceva015.wav = Battle control terminated.
-ceva016.wav = Establishing battlefield control. Stand by.
-ceva017.wav = Primary objective achieved.
-ceva018.wav = Secondary objective achieved.
-ceva019.wav = Tertiary objective achieved.
-ceva020.wav = Critical unit lost.
-ceva021.wav = Critical structure lost.
-ceva022.wav = You are victorious.
-ceva023.wav = You have lost.
-ceva024.wav = You have resigned.
-ceva025.wav = Player resigned.
-ceva026.wav = player defeated.
-ceva027.wav = 20 minutes remaining.
-ceva028.wav = 10 minutes remaining.
-ceva029.wav = 5 minutes remaining.
-ceva030.wav = 4 minutes remaining.
-ceva031.wav = 3 minutes remaining.
-ceva032.wav = two minutes remaining.
-ceva033.wav = One minute remaining.
-ceva035.wav = Timer started.
-ceva036.wav = Timer stopped.
-ceva037.wav = or minor under attack.
-ceva038.wav = Reinforcements have arrived.
-ceva039.wav = New terrain discovered.
-ceva040.wav = Incoming transmission.
-ceva041.wav = Beacon detected.
-ceva042.wav = Beacon placed.
-ceva043.wav = Alliance formed.
-ceva044.wav = Alliance broken.
-ceva045.wav = Our ally is under attack.
-ceva046.wav = Bridge repaired.
-ceva047.wav = Unable to comply, building and progress.
-ceva048.wav = Construction complete.
-ceva052.wav = building.
-ceva076.wav = Unit firepower upgraded.
-ceva098.wav = Warning, enemy armor battalion detected.
-cevau13.wav = The ultimate in Soviet long-range bombardment, the Dreadnought, is powerful from a distance but can be easily destroyed at close range. The Dreadnought's missiles can also be shot down by Patriot missiles.
-cevau27.wav = Commander, this is a chrono legionnaire. Using Professor Einstein's chrono technology, they teleport next to any enemy and utterly erase them from time.
-ceva049.wav = New construction options.
-ceva050.wav = insufficient funds.
-ceva051.wav = Cancelled.
-ceva053.wav = Low power.
-ceva054.wav = Our base is under attack.
-ceva055.wav = primary building selected.
-ceva056.wav = on hold.
-ceva057.wav = Repairing
-ceva058.wav = Structure sold.
-ceva059.wav = Base defenses offline
-ceva060.wav = Building Offline
-ceva061.wav = Building online
-ceva062.wav = Unit ready.
-ceva063.wav = cannot deploy here.
-ceva064.wav = Unit lost.
-ceva065.wav = Select Target.
-ceva066.wav = Training.
-ceva067.wav = Armor upgraded.
-ceva068.wav = Firepower upgraded.
-ceva069.wav = Speed upgraded.
-ceva070.wav = Unit repaired.
-ceva071.wav = Unit sold.
-ceva072.wav = Building Captured
-ceva073.wav = Building infiltrated.
-ceva074.wav = New technology acquired.
-ceva075.wav = Enemy base powered down.
-ceva077.wav = Unit armor upgraded.
-ceva078.wav = Unit speed upgraded.
-ceva079.wav = Unit promoted.
-ceva080.wav = Unit upgraded.
-ceva081.wav = Firepower technology stolen, all units gain firepower upgrade.
-ceva082.wav = Armor technology stolen, all units gain armor upgrade.
-ceva083.wav = New mission objective received
-ceva084.wav = Upgrade in progress.
-ceva085.wav = Upgrade complete.
-ceva086.wav = or minor offline.
-ceva087.wav = Enemy power restored.
-ceva088.wav = Building infiltrated, technology stolen.
-ceva089.wav = Building infiltrated, radar sabotaged.
-ceva090.wav = Building infiltrated, cash stolen.
-ceva091.wav = Building infiltrated, power sabotaged.
-ceva092.wav = Technology stolen.
-ceva093.wav = Radar sabotaged.
-ceva094.wav = Cash stolen.
-ceva095.wav = Power sabotaged.
-ceva096.wav = Warning, enemy air armada detected.
-ceva097.wav = enemy fleet detected
-ceva099.wav = Warning, enemy infantry battalion detected.
-ceva100.wav = New rally point established.
-ceva101.wav = Alliance requested.
-ceva102.wav = Requesting Alliance
-ceva103.wav = Enemy alliance formed.
-ceva104.wav = New objective received.
-ceva105.wav = Tech building captured.
-ceva106.wav = Tech building lost.
-ceva107.wav = Structure Garrison
-ceva108.wav = Structure abandoned
-ceva109.wav = Chronominer Offline
-ceva120.wav = Battle Control Online
-ceva121.wav = reinforcements ready
-ceva122.wav = Weather Control Device Offline
-cevau06.wav = The V3 is a powerful long-range artillery weapon. Beware, Commander. It can level your base in minutes without you ever getting a chance to even return fire.
-cevau07.wav = The most powerful Soviet tank ever built. The Apocalypse is a small army all by itself and is equipped to handle both ground and air threats.
-cevau08.wav = The most powerful air unit ever created. The Kirov can take a beating and drop an almost unlimited number of heavy iron bombs.
-cevau15.wav = The Soviets have taken Tesla technology to the final step, a man in a Tesla-powered suit. These soldiers are excellent at destroying tanks and also seem to be able to power up Tesla coils with their extra energy.
-cevau19.wav = This soldier is equipped with a nuclear battle suit. He can irradiate large patches of ground, making them impassable to infantry or light vehicles.
-cevau20.wav = The Soviets have been experimenting with psychic technology, with some success. Their elite Psy Corps can cause our own loyal soldiers to turn against us.
-cevau22.wav = This, sir, is our IFV. It is a multi-purpose raider capable of boosting the standard weapon capabilities of any infantryman inside.
-cevau23.wav = Sir, this is an engineer. He can repair any Allied building, and once inside an enemy building, turn it to our side. He is much smarter than his Soviet counterpart.
-cevau24.wav = Sir, the seal is the elite soldier. No enemy is safe from him, whether on land or water.
-cevau25.wav = Commander, the spy's ability to mask himself as the enemy and pass through their ranks gives him the needed edge to infiltrate even the most well-guarded enemy building. If only they didn't taste so good to Soviet dogs.
-cevau26.wav = The Rocketeers are the brave men who strap maneuvering thrusters to their backs and then go out to hunt enemy tanks and air forces. They are very brave.
-cevau31.wav = Commander, our Mirage tank's ability to hide itself among any natural objects around it make it the perfect ambush or covert surveillance vehicle.
-cevau36.wav = Commander, our destroyer is the workhorse of the Navy. No naval unit can long hide from it, and once detected, it makes short work of the enemy.
-cevau37.wav = Commander, there is no airborne threat that can evade the sight or missiles of the Aegis cruiser. It is the premier anti-air weapon.
-cevau38.wav = Sir, our aircraft carriers are the pride of the Allied Navy. In a moment's notice, the carrier's planes can take out any target quickly and from a very safe distance.