arashi 1.5.1 → 1.7.0

package/README.md

@@ -94,10 +94,12 @@ Arashi currently provides these commands:
 
 - `arashi init`
 - `arashi add <git-url>`
+- `arashi clone [--all]`
 - `arashi create <branch>`
 - `arashi list`
 - `arashi status`
 - `arashi remove <branch|path>`
+- `arashi switch [filter] [--repos|--all] [--sesh]`
 - `arashi pull`
 - `arashi sync`
 - `arashi setup [--only <repo>] [--verbose]`
@@ -110,19 +112,27 @@ arashi add git@github.com:your-org/frontend.git
 arashi add git@github.com:your-org/backend.git
 arashi create feature-auth-refresh
 arashi status
+arashi switch feature-auth-refresh          # parent repo worktrees
+arashi switch --repos feature-auth-refresh  # child repo worktrees in current workspace
+arashi switch --all feature-auth-refresh    # all repos
+arashi switch --repos docs                  # repo-name matching in child repos
 ```
 
 ## Hooks
 
-Arashi can run lifecycle hooks during `arashi create` to automate setup steps.
+Arashi can run lifecycle hooks during `arashi create` and `arashi remove`.
 
 - Global hooks in `.arashi/hooks/`:
   - `pre-create.sh`
   - `post-create.sh`
+  - `pre-remove.sh`
+  - `post-remove.sh`
 - Repository-specific hooks:
   - `pre-create.<repo>.sh`
   - `post-create.<repo>.sh`
 
+`pre-remove.sh` is useful for teardown before deletion (for example, stopping tmux sessions), and `post-remove.sh` can run final cleanup after remove operations complete.
+
 See [`docs/hooks.md`](./docs/hooks.md) for hook behavior, environment variables, and examples.
 
 ## Workflow Shortcuts
@@ -163,6 +173,10 @@ bind '"\C-s":"sesh connect \$(arashi list | fzf)\n"'
 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.
+
 ### Fast remove selection
 
 ```bash
@@ -188,8 +202,10 @@ Arashi also ships a dedicated `skills.sh` integration package for guided install
 ## Documentation
 
 - Installation details: [`docs/INSTALLATION.md`](./docs/INSTALLATION.md)
+- Clone command details: [`docs/commands/clone.md`](./docs/commands/clone.md)
 - Hook behavior: [`docs/hooks.md`](./docs/hooks.md)
 - Setup command details: [`docs/commands/setup.md`](./docs/commands/setup.md)
+- Switch command details: [`docs/commands/switch.md`](./docs/commands/switch.md)
 - Remove command details: [`docs/commands/remove.md`](./docs/commands/remove.md)
 - FZF integration: [`docs/FZF_COMPATIBILITY.md`](./docs/FZF_COMPATIBILITY.md)
 

package/bin/arashi.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -8,14 +9,68 @@ const __dirname = dirname(__filename);
 
 const argv = process.argv.slice(2);
 const isWindows = process.platform === "win32";
+
+const ensureInstalled = () => {
+  const wrapper = isWindows ? "arashi.bat" : "arashi";
+  const wrapperPath = join(__dirname, wrapper);
+  const postinstallPath = join(__dirname, "..", "scripts", "postinstall.js");
+  const defaultBinary = isWindows ? "arashi.bin.exe" : "arashi.bin";
+  const defaultBinaryPath = join(__dirname, defaultBinary);
+  const platformBinary = (() => {
+    if (isWindows) {
+      return "arashi-windows-x64.exe";
+    }
+
+    if (process.platform === "darwin" && process.arch === "arm64") {
+      return "arashi-macos-arm64";
+    }
+
+    if (process.platform === "linux" && process.arch === "x64") {
+      return "arashi-linux-x64";
+    }
+
+    return null;
+  })();
+  const platformBinaryPath = platformBinary ? join(__dirname, platformBinary) : null;
+  const binaryExists = () => {
+    if (existsSync(defaultBinaryPath)) {
+      return true;
+    }
+
+    if (platformBinaryPath && existsSync(platformBinaryPath)) {
+      return true;
+    }
+
+    return false;
+  };
+
+  if (existsSync(wrapperPath) && binaryExists()) {
+    return;
+  }
+
+  console.log("arashi binary missing; running postinstall to download.");
+  const result = spawnSync(process.execPath, [postinstallPath], { stdio: "inherit" });
+
+  if (result.error) {
+    console.error(`Failed to run postinstall. ${result.error.message}.`);
+    process.exit(1);
+  }
+
+  if (typeof result.status === "number" && result.status !== 0) {
+    process.exit(result.status);
+  }
+};
+
+ensureInstalled();
+
 const wrapper = isWindows ? "arashi.bat" : "arashi";
 const wrapperPath = join(__dirname, wrapper);
 
 const child = isWindows
   ? spawn(process.env.ComSpec ?? "cmd.exe", ["/d", "/s", "/c", wrapperPath, ...argv], {
-      stdio: "inherit",
-      windowsHide: false,
-    })
+    stdio: "inherit",
+    windowsHide: false,
+  })
   : spawn(wrapperPath, argv, { stdio: "inherit" });
 
 child.on("exit", (code, signal) => {

package/package.json

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