arashi 1.22.0 → 1.24.0

package/README.md

@@ -41,7 +41,17 @@ It also runs a quick `arashi --version` smoke test before declaring success.
 
 If curl installation fails, or if the smoke test reports a bad release artifact, use npm installation below or the manual release instructions in [`docs/INSTALLATION.md`](./docs/INSTALLATION.md).
 
-### Option 2: Install with npm
+### Option 2: Install on Windows with PowerShell
+
+PowerShell is the canonical Windows installer:
+
+```powershell
+powershell -c "irm https://arashi.haphazard.dev/install.ps1 | iex"
+```
+
+It verifies and installs `arashi.bin.exe`, the extensionless `arashi` wrapper for Git Bash, `arashi.ps1`, and `arashi.bat` from the same release. The default directory is `%USERPROFILE%\.arashi\bin`; the installer adds it to the persistent user PATH. It does not create or modify `.bashrc` or another shell profile. Open a new Git Bash window before running `arashi --version` so it inherits the PATH change.
+
+### Option 3: Install with npm
 
 ```bash
 npm install -g arashi
@@ -93,13 +103,17 @@ chmod +x arashi
 sudo mv arashi /usr/local/bin/arashi
 ```
 
-Windows (PowerShell):
+Windows (PowerShell and Git Bash):
 
 ```powershell
-Invoke-WebRequest -Uri "https://github.com/corwinm/arashi/releases/latest/download/arashi-windows-x64.exe" -OutFile "arashi.exe"
-# Move arashi.exe to a folder on your PATH
+# Download arashi-windows-x64.exe, arashi, arashi.ps1, arashi.bat,
+# and arashi-checksums.txt from the same release.
+# Verify all four payload files against arashi-checksums.txt.
+# Rename arashi-windows-x64.exe to arashi.bin.exe and keep the four files together on PATH.
 ```
 
+Windows manual installation requires `arashi-windows-x64.exe`, `arashi`, `arashi.ps1`, `arashi.bat`, and `arashi-checksums.txt` from the same release. Verify all four payload files, rename the executable to `arashi.bin.exe`, and keep the payload together on PATH.
+
 You can also build from source for local development:
 
 ```bash
@@ -117,12 +131,12 @@ Arashi currently provides these commands:
 - `arashi update [--check] [--dry-run] [--yes]`
 - `arashi add <git-url>`
 - `arashi clone [--all]`
-- `arashi create <branch> [--tmux|--sesh|--herdr]`
+- `arashi create <branch> [--tab] [--tmux|--sesh|--herdr]`
 - `arashi list`
 - `arashi status`
 - `arashi remove <branch|path>`
 - `arashi prune [--dry-run]` - clean stale Git worktree metadata
-- `arashi switch [filter] [--repos|--all] [--cd|--no-cd] [--tmux|--sesh|--herdr] [--no-default-launch]`
+- `arashi switch [filter] [--repos|--all] [--tab] [--cd|--no-cd] [--tmux|--sesh|--herdr] [--no-default-launch]`
 - `arashi shell init <bash|zsh|fish>`
 - `arashi shell install`
 - `arashi pull`
@@ -141,6 +155,7 @@ arashi create feature-auth-refresh
 arashi create feature-auth-refresh --launch
 arashi create feature-auth-refresh --tmux
 arashi create feature-auth-refresh --herdr
+arashi create feature-auth-refresh --tab
 arashi create feature-auth-refresh --no-launch
 arashi shell install
 arashi status
@@ -151,11 +166,14 @@ arashi switch --repos docs                  # repo-name matching in child repos
 arashi switch --cd feature-auth-refresh     # parent-shell cd when shell integration is active
 arashi switch --tmux feature-auth-refresh   # force a new plain tmux window
 arashi switch --herdr feature-auth-refresh  # open or focus a persistent Herdr workspace
+arashi switch --tab feature-auth-refresh    # request a true tab or managed equivalent
 arashi switch --no-default-launch           # bypass configured sesh/Herdr mode once
 ```
 
 Explicit `--tmux` is a per-invocation launcher override for `create` and `switch`; it is not a persisted configuration mode. It requires an active tmux context whose `TMUX` value is non-empty after trimming, uses the selected worktree path as one argv-safe `tmux new-window -c` argument, and does not fall back to another launcher when the prerequisite or launch fails. On `create`, it implies both launch and switch, while validation failures occur before worktree mutation.
 
+`--tab` is a CLI-only launch disposition for `create` and `switch`; it is never persisted. It requests a true terminal tab or documented managed-context equivalent, implies launch (and selection for `create`), overrides automatic parent-shell `cd`, and never degrades to a window or another launcher. Unsupported adapters fail with `TAB_DISPOSITION_UNSUPPORTED`; launch/preflight failures use `LAUNCH_FAILED`. Human-only tab launch is incompatible with `--json`.
+
 ### Managed Git ignore rules
 
 Configured workspaces keep `reposDir` and `worktreesDir` effectively ignored. Arashi asks Git
@@ -272,7 +290,11 @@ bindkey -s '^s' 'sesh connect $(arashi list | fzf)\n'
 
 You can also use `arashi switch --sesh` directly inside tmux to open the selected worktree in a new tmux window.
 
-`arashi switch` also detects tmux, Kitty, Ghostty, WezTerm, and iTerm2 contexts and prefers terminal-native launch behavior when available.
+`arashi switch` checks managed contexts in this order: tmux → Herdr → cmux → integrated IDE → Kitty. Managed Kitty selection applies when any one of `KITTY_PID`, `KITTY_WINDOW_ID`, or `TERM=xterm-kitty` is present after normalization.
+
+Managed Kitty requires Kitty 0.43 or newer plus working `kitten @` remote control. Arashi reuses only its exact worktree marker and focuses that tab before launching a new session-backed tab. Once managed Kitty is selected, missing or unsupported tooling, denied remote control, duplicate markers, and validation failures are reported directly instead of falling back to another launcher.
+
+`arashi create --launch` and `defaults.create.launch: "auto"` use the same managed Kitty behavior. If that post-create launch fails, Arashi exits nonzero but preserves the successfully created worktree and reports the launch as partial success. Fix the launcher problem and use `arashi switch`; do not retry creation for the same branch.
 
 ### Fast remove selection
 
@@ -321,7 +343,7 @@ Example config header:
 }
 ```
 
-`defaults.switch.mode` accepts `auto` | `cd` | `launch` | `sesh` | `herdr`. Contextual `auto` checks strict managed contexts in the order tmux → Herdr → cmux → integrated IDE, then uses parent-shell `cd` when shell integration is active, and otherwise follows terminal/platform launch fallback. An absent mode preserves the built-in automatic `launch` behavior rather than newly preferring `cd`.
+`defaults.switch.mode` accepts `auto` | `cd` | `launch` | `sesh` | `herdr`. Contextual `auto` checks strict managed contexts in the order tmux → Herdr → cmux → integrated IDE → managed Kitty, then uses parent-shell `cd` when shell integration is active, and otherwise follows terminal/platform launch fallback. An absent mode preserves the built-in automatic `launch` behavior rather than newly preferring `cd`.
 
 Explicit launcher flags take precedence over `--cd` / `--no-cd`, which take precedence over the configured mode and automatic context detection. `--no-default-launch` bypasses only configured `sesh` or `herdr`. `--herdr` remains available on both `create` and `switch`; Herdr launch uses `herdr worktree open` with the Git-resolved non-bare main checkout and selected worktree.
 

package/bin/arashi

@@ -14,23 +14,36 @@ done
 SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_SOURCE")" && pwd)"
 BINARY="$SCRIPT_DIR/arashi.bin"
 
-# Use platform-specific binary if main binary doesn't exist
+# Use the Windows binary only with explicit Git-for-Windows/MSYS/Cygwin evidence.
+# arashi.bin always retains precedence when both binaries are present.
 if [ ! -f "$BINARY" ]; then
   PLATFORM=$(uname -s | tr '[:upper:]' '[:lower:]')
   ARCH=$(uname -m)
-  
-  case "$PLATFORM-$ARCH" in
-    darwin-arm64)
-      BINARY="$SCRIPT_DIR/arashi-macos-arm64"
-      ;;
-    linux-x86_64)
-      BINARY="$SCRIPT_DIR/arashi-linux-x64"
-      ;;
-    *)
-      echo "Error: Unsupported platform $PLATFORM-$ARCH" >&2
-      exit 1
-      ;;
+  WINDOWS_SHELL="false"
+
+  case "${MSYSTEM:-}" in
+    MINGW*|MSYS*) WINDOWS_SHELL="true" ;;
   esac
+  case "$PLATFORM" in
+    mingw*|msys*|cygwin*) WINDOWS_SHELL="true" ;;
+  esac
+
+  if [ "$WINDOWS_SHELL" = "true" ]; then
+    BINARY="$SCRIPT_DIR/arashi.bin.exe"
+  else
+    case "$PLATFORM-$ARCH" in
+      darwin-arm64)
+        BINARY="$SCRIPT_DIR/arashi-macos-arm64"
+        ;;
+      linux-x86_64)
+        BINARY="$SCRIPT_DIR/arashi-linux-x64"
+        ;;
+      *)
+        echo "Error: Unsupported platform $PLATFORM-$ARCH" >&2
+        exit 1
+        ;;
+    esac
+  fi
 fi
 
 if [ ! -f "$BINARY" ]; then
@@ -49,7 +62,11 @@ for arg in "$@"; do
       esac
       continue
       ;;
-    *) command="$arg"; break ;;
+    *)
+      if [ -z "$command" ]; then
+        command="$arg"
+      fi
+      ;;
   esac
 done
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arashi",
-  "version": "1.22.0",
+  "version": "1.24.0",
   "description": "Git worktree manager for meta-repositories - The eye of the storm for your development workflow",
   "keywords": [
     "cli",