feat(cli): add coven-cave alias

Add coven-cave as an alias for coven-code across npm installs, standalone installers, source builds, and documentation.

Author: BunsDev

COVEN.md

@@ -24,7 +24,7 @@ are rebranded. This boundary is explicit and documented below.
 
 | Surface | File(s) | Current value |
 |---|---|---|
-| Binary name | `src-rust/crates/cli/Cargo.toml` `[[bin]]` | `coven-code` |
+| Binary name | `src-rust/crates/cli/src/main.rs`, `src-rust/crates/cli/src/bin/coven-cave.rs` | `coven-code`; `coven-cave` alias |
 | npm package | `npm/package.json` | `@opencoven/coven-code` |
 | Data/cache dirs | `src-rust/crates/core/src/snapshot/`, `skill_discovery.rs`, `update_check.rs`, `app.rs` | `coven-code/` |
 | Env var prefix | throughout `src-rust/` | `COVEN_CODE_*` |

README.md

@@ -43,7 +43,7 @@ Recent highlights:
 npm install -g @opencoven/coven-code
 ```
 
-Then open a new terminal and run `coven-code`.
+Then open a new terminal and run `coven-code`. `coven-cave` is also installed as an alias for the same CLI.
 
 ### Upgrade
 
@@ -74,7 +74,7 @@ Each archive contains a single `coven-code` (or `coven-code.exe`) binary.
 ```bash
 git clone https://github.com/OpenCoven/coven-code.git
 cd coven-code/src-rust
-cargo build --release --package claurst   # binary outputs as coven-code
+cargo build --release --package claurst   # binary outputs as coven-code; coven-cave is an alias target
 ```
 
 > Internal Rust crate names (`claurst-core`, `claurst-tui`, etc.) are preserved from upstream for merge-friendliness. The compiled binary is named `coven-code`.

docs/installation.md

@@ -79,7 +79,8 @@ npm install -g @opencoven/coven-code
 bun install -g @opencoven/coven-code
 ```
 
-After installation, run `coven-code` directly from your terminal.
+After installation, run `coven-code` directly from your terminal. `coven-cave`
+is installed as an alias for the same CLI.
 
 You can also run Coven Code without a permanent install:
 
@@ -128,6 +129,7 @@ If you'd rather not run an install script, grab archives directly from
 | `coven-code-macos-aarch64.tar.gz` | macOS Apple Silicon |
 
 Every archive contains a single binary named `coven-code` (or `coven-code.exe`).
+The installers also place `coven-cave` on PATH as an alias for that binary.
 Extract it and put it somewhere on your `PATH`. For example on Linux:
 
 ```bash

install.ps1

@@ -168,17 +168,21 @@ function Install-FromBinary {
 
 function Install-Binary($source) {
     $target = Join-Path $InstallDir 'coven-code.exe'
+    $aliasTarget = Join-Path $InstallDir 'coven-cave.exe'
 
     # The currently running coven-code.exe (if any) holds an exclusive file lock on
     # Windows.  Try to swap by renaming the old one first.
-    if (Test-Path $target) {
-        $stale = "$target.old"
+    foreach ($path in @($target, $aliasTarget)) {
+        if (-not (Test-Path $path)) { continue }
+        $stale = "$path.old"
         if (Test-Path $stale) { Remove-Item -Force $stale -ErrorAction SilentlyContinue }
-        try { Move-Item -Force $target $stale } catch { }
+        try { Move-Item -Force $path $stale } catch { }
     }
 
     Copy-Item -Force $source $target
+    Copy-Item -Force $source $aliasTarget
     Write-Success "Installed: $target"
+    Write-Success "Installed alias: $aliasTarget"
 }
 
 # ----- PATH modification -----
@@ -241,6 +245,7 @@ Write-Host   "  `$env:ANTHROPIC_API_KEY = 'sk-ant-...'"
 Write-Host   ""
 Write-Muted  "  # Open a new terminal, then:"
 Write-Success "  coven-code             "
+Write-Success "  coven-cave             "
 Write-Muted  "  # or"
 Write-Success "  coven-code -p `"...`"      "
 Write-Host   ""

install.sh

@@ -13,6 +13,7 @@
 set -euo pipefail
 
 APP=coven-code
+ALIAS=coven-cave
 REPO=OpenCoven/coven-code
 
 RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
@@ -112,6 +113,9 @@ else
   chmod +x "${INSTALL_DIR}/${APP}"
 fi
 
+ln -sf "${APP}" "${INSTALL_DIR}/${ALIAS}" || cp "${INSTALL_DIR}/${APP}" "${INSTALL_DIR}/${ALIAS}"
+chmod +x "${INSTALL_DIR}/${ALIAS}"
+
 # PATH setup
 shell_rc=""
 case "${SHELL:-}" in
@@ -128,8 +132,10 @@ if [[ -n "$shell_rc" ]] && ! grep -qF "$INSTALL_DIR" "$shell_rc" 2>/dev/null; th
 fi
 
 print_message success "${APP} v${specific_version} installed to ${INSTALL_DIR}/${APP}"
+print_message success "${ALIAS} alias installed to ${INSTALL_DIR}/${ALIAS}"
 echo ""
 echo -e "  ${GREEN}${APP}${NC}              ${MUTED}# Interactive TUI${NC}"
+echo -e "  ${GREEN}${ALIAS}${NC}              ${MUTED}# Alias for ${APP}${NC}"
 echo -e "  ${GREEN}${APP} -p \"...\"${NC}       ${MUTED}# Headless one-shot${NC}"
 echo ""
 echo -e "  ${MUTED}Restart your shell or run: source ${shell_rc:-~/.bashrc}${NC}"

npm/README.md

@@ -20,6 +20,7 @@ On install, the correct pre-built native binary for your platform is automatical
 
 ```bash
 coven-code                    # interactive TUI
+coven-cave                    # alias for coven-code
 coven-code -p "fix this bug"  # headless one-shot
 ```
 

npm/package.json

@@ -23,7 +23,8 @@
   ],
   "author": "OpenCoven (based on Claurst by Kuber Mehta)",
   "bin": {
-    "coven-code": "bin/coven-code"
+    "coven-code": "bin/coven-code",
+    "coven-cave": "bin/coven-code"
   },
   "scripts": {
     "postinstall": "node install.js"

scripts/prepare-npm-package.test.mjs

@@ -39,6 +39,10 @@ function readJson(file) {
 
   assert.equal(pkg.name, 'coven-code');
   assert.equal(pkg.version, '1.2.3');
+  assert.deepEqual(pkg.bin, {
+    'coven-code': 'bin/coven-code',
+    'coven-cave': 'bin/coven-code',
+  });
   assert.match(readme, /^# coven-code$/m);
   assert.match(readme, /npm\/v\/coven-code\?style=flat-square/);
   assert.match(readme, /npmjs\.com\/package\/coven-code/);

src-rust/crates/cli/src/bin/coven-cave.rs

@@ -0,0 +1,31 @@
+use std::ffi::OsString;
+use std::process::{Command, ExitCode};
+
+fn main() -> ExitCode {
+    let mut target = match std::env::current_exe() {
+        Ok(path) => path,
+        Err(error) => {
+            eprintln!("coven-cave: failed to locate executable path: {error}");
+            return ExitCode::FAILURE;
+        }
+    };
+
+    target.set_file_name(if cfg!(windows) {
+        "coven-code.exe"
+    } else {
+        "coven-code"
+    });
+
+    let args: Vec<OsString> = std::env::args_os().skip(1).collect();
+    match Command::new(&target).args(args).status() {
+        Ok(status) => match status.code() {
+            Some(0) => ExitCode::SUCCESS,
+            Some(code) if (1..=255).contains(&code) => ExitCode::from(code as u8),
+            _ => ExitCode::FAILURE,
+        },
+        Err(error) => {
+            eprintln!("coven-cave: failed to run {}: {error}", target.display());
+            ExitCode::FAILURE
+        }
+    }
+}