arashi 1.9.0 → 1.10.1

package/README.md

@@ -36,7 +36,7 @@ Verify install:
 arashi --version
 ```
 
-By default, the installer places `arashi` in `~/.arashi/bin` and adds that path to your shell config.
+By default, the installer places `arashi` in `~/.arashi/bin`, adds that path to your shell config, and in interactive installs offers to enable shell integration for `arashi switch --cd`.
 
 If curl installation fails, use npm installation below or the manual release instructions in [`docs/INSTALLATION.md`](./docs/INSTALLATION.md).
 
@@ -99,7 +99,9 @@ Arashi currently provides these commands:
 - `arashi list`
 - `arashi status`
 - `arashi remove <branch|path>`
-- `arashi switch [filter] [--repos|--all] [--sesh] [--no-default-launch]`
+- `arashi switch [filter] [--repos|--all] [--cd|--no-cd] [--sesh] [--no-default-launch]`
+- `arashi shell init <bash|zsh|fish>`
+- `arashi shell install`
 - `arashi pull`
 - `arashi sync`
 - `arashi setup [--only <repo>] [--verbose]`
@@ -113,14 +115,48 @@ arashi add git@github.com:your-org/backend.git
 arashi create feature-auth-refresh
 arashi create feature-auth-refresh --launch
 arashi create feature-auth-refresh --no-launch
+arashi shell install
 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
+arashi switch --cd feature-auth-refresh     # parent-shell cd when shell integration is active
 arashi switch --no-default-launch           # bypass configured launch mode defaults once
 ```
 
+## Workflow Guides
+
+Use the docs site workflow guides when you want setup guidance by outcome instead of by individual command.
+
+- Hooks and configuration defaults: [arashi.haphazard.dev/workflows/hooks-and-config](https://arashi.haphazard.dev/workflows/hooks-and-config/)
+- Integrations for VSCode, tmux, and `tmux` plus `sesh`: [arashi.haphazard.dev/workflows/integrations](https://arashi.haphazard.dev/workflows/integrations/)
+- Agent-assisted and spec-driven change flow: [arashi.haphazard.dev/workflows/agents-and-specs](https://arashi.haphazard.dev/workflows/agents-and-specs/)
+
+## Shell Integration
+
+Use shell integration when you want `arashi switch` to change the current shell directory instead of only opening a new terminal or editor context.
+
+The official curl installer can offer this automatically. If you skip it or use npm, install it for the active shell with:
+
+```bash
+arashi shell install
+```
+
+Or print wrapper code for manual setup:
+
+```bash
+arashi shell init bash
+arashi shell init zsh
+arashi shell init fish
+```
+
+Once installed, you can use `arashi switch --cd <filter>` for one-off parent-shell switching or set `.arashi/config.json` `defaults.switch.mode` to `"cd"` or `"auto"`.
+
+If shell integration is inactive, `arashi switch --cd` warns and skips launch fallback for that invocation.
+
+For automated installs, set `ARASHI_SHELL_INTEGRATION=yes` to enable it without prompting or `ARASHI_SHELL_INTEGRATION=no` to skip it.
+
 ## Hooks
 
 Arashi can run lifecycle hooks during `arashi create` and `arashi remove`.
@@ -220,6 +256,7 @@ Example config header:
       "launchMode": "sesh"
     },
     "switch": {
+      "mode": "auto",
       "launchMode": "sesh"
     }
   },
@@ -227,6 +264,8 @@ Example config header:
 }
 ```
 
+`defaults.switch.mode` accepts `"launch"`, `"cd"`, or `"auto"`. `"auto"` prefers parent-shell switching only when shell integration is active.
+
 Defaults precedence for create/switch behavior: explicit CLI flag > opt-out flag > config default > built-in default.
 
 ## skills.sh Integration
@@ -244,6 +283,8 @@ Arashi also ships a dedicated `skills.sh` integration package for guided install
 - Configuration details: [`docs/configuration.md`](./docs/configuration.md)
 - Clone command details: [`docs/commands/clone.md`](./docs/commands/clone.md)
 - Hook behavior: [`docs/hooks.md`](./docs/hooks.md)
+- Workflow guides: [https://arashi.haphazard.dev/workflows/](https://arashi.haphazard.dev/workflows/)
+- Shell integration details: [`docs/commands/shell.md`](./docs/commands/shell.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)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arashi",
-  "version": "1.9.0",
+  "version": "1.10.1",
   "description": "Git worktree manager for meta-repositories - The eye of the storm for your development workflow",
   "keywords": [
     "cli",
@@ -48,7 +48,8 @@
   "type": "module",
   "scripts": {
     "dev": "bun run src/index.ts",
-    "build": "bun build src/index.ts --compile --minify --sourcemap --outfile bin/arashi.bin",
+    "build": "bun build src/index.ts --compile --minify --outfile bin/arashi.bin",
+    "build:debug": "bun build src/index.ts --compile --sourcemap --outfile bin/arashi.bin",
     "build:all": "bun run build:mac && bun run build:linux && bun run build:windows",
     "build:mac": "bun build src/index.ts --compile --target=bun-darwin-arm64 --outfile bin/arashi-macos-arm64",
     "build:linux": "bun build src/index.ts --compile --target=bun-linux-x64 --outfile bin/arashi-linux-x64",

package/schema/config.schema.json

@@ -119,9 +119,17 @@
         "launchMode": {
           "$ref": "#/definitions/LaunchMode",
           "description": "Preferred launch mode when running switch"
+        },
+        "mode": {
+          "$ref": "#/definitions/SwitchMode",
+          "description": "Preferred switch behavior when running switch"
         }
       },
       "type": "object"
+    },
+    "SwitchMode": {
+      "enum": ["launch", "cd", "auto"],
+      "type": "string"
     }
   }
 }