arashi 1.1.3 → 1.3.0

package/README.md

@@ -68,22 +68,49 @@ arashi add git@github.com:user/backend.git
 # Create a new feature worktree across all repos
 arashi create feature-new-api
 
+# Preview worktrees without creating them
+arashi create --dry-run feature-new-api
+
 # Check status across all repos
 arashi status
 
+# Sync repos to the parent branch
+arashi sync
+
 # Remove worktree when done
 arashi remove feature-new-api
+
+# Remove a specific worktree path
+arashi remove -f "$(arashi list | fzf)"
 ```
 
+Note: `arashi remove` requires an interactive TTY. In non-interactive runs it exits with a clear error.
+
+## Hooks
+
+Arashi can run lifecycle hooks during `arashi create` to automate setup tasks.
+
+- Global hooks in `.arashi/hooks/`:
+  - `pre-create.sh`
+  - `post-create.sh`
+- Repo-specific hooks in `.arashi/hooks/`:
+  - `pre-create.<child-repo>.sh`
+  - `post-create.<child-repo>.sh`
+
+Repo-specific hooks run in the new child worktree context and receive main/parent repo paths via environment variables.
+
+See `docs/hooks.md` for details.
+
 ## Planned Commands
 
 - `arashi init` - Initialize arashi in current repository
 - `arashi add <git-url>` - Add a repository to the repos folder
 - `arashi create <branch>` - Create coordinated worktrees
 - `arashi list` - List all worktrees
-- `arashi remove <branch>` - Remove worktrees and branches
+- `arashi remove <branch|path>` - Remove worktrees and branches
 - `arashi setup` - Run setup scripts
 - `arashi status` - Show status of all repositories
+- `arashi sync` - Align repositories to the parent branch
 
 ## Integration with fzf, tmux, and sesh
 
@@ -96,6 +123,9 @@ Navigate to any worktree interactively:
 ```bash
 # Interactive worktree selection
 cd $(arashi list | fzf)
+
+# Remove a selected worktree
+arashi remove -f "$(arashi list | fzf)"
 ```
 
 **Add as a shell keybinding** for instant access:
@@ -168,68 +198,25 @@ bindkey -s '^g' 'arashi-tmux\n'  # Zsh
 
 #### Setup
 
-```bash
-# Install sesh
-brew install joshmedeski/sesh/sesh
-
-# Add arashi as a sesh source
-# ~/.config/sesh/sesh.toml
-[sources]
-arashi = "arashi list"
-```
+Follow sesh's [installation instructions](https://github.com/joshmedeski/sesh?tab=readme-ov-file#how-to-install)
 
 #### Usage
 
 ```bash
-# Select from all sessions + arashi worktrees
-sesh connect $(sesh list | fzf)
+# Select from arashi worktrees
+sesh connect $(arashi list | fzf)
 
-# Or create a keybinding (Ctrl+A)
-bind '"\C-a":"sesh connect \$(sesh list | fzf)\n"'
+# Or create a keybinding (Ctrl+G)
+bind '"\C-g":"sesh connect \$(arashi list | fzf)\n"'
+# zsh:
+bindkey -s '^g' 'sesh connect $(arashi list | fzf)\n'
 ```
 
 **Benefits of sesh:**
-- Unified list of existing tmux sessions + arashi worktrees
 - Smart session naming and path handling
 - Automatic tmux session creation
 - Works seamlessly with zoxide and other tools
 
-### Fish + tmux Integration
-
-For Fish shell users, here's a complete solution:
-
-```fish
-# ~/.config/fish/functions/arashi_session.fish
-function arashi_session
-    set -l worktree (arashi list | fzf \
-        --preview 'cd {} && git status' \
-        --preview-window=right:60% \
-        --height=80%)
-    
-    if test -n "$worktree"
-        set -l session_name (basename $worktree)
-        
-        if not tmux has-session -t $session_name 2>/dev/null
-            tmux new-session -d -s $session_name -c $worktree
-        end
-        
-        if set -q TMUX
-            tmux switch-client -t $session_name
-        else
-            tmux attach-session -t $session_name
-        end
-    end
-end
-
-# Bind to Ctrl+G
-bind \cg arashi_session
-```
-
-This includes:
-- Live git status preview in fzf
-- Automatic session creation with smart naming
-- Works both inside and outside tmux
-
 ### Comparison Table
 
 | Method | Setup Complexity | Features | Best For |
@@ -248,7 +235,7 @@ This includes:
 ### Example Workflow
 
 ```bash
-# Morning routine:
+1. Run `arashi create feature-new-api` to set up worktrees across repos
 1. Press Ctrl+G
 2. Type "feature" to filter worktrees
 3. Select your feature branch worktree
@@ -282,9 +269,6 @@ bun install
 # Run in development mode
 bun run dev
 
-# Build single-file executable
-bun run build
-
 # Build for all platforms
 bun run build:all
 
@@ -328,16 +312,6 @@ Arashi is built with:
 
 See the [Design Document](https://github.com/corwinm/arashi-arashi/tree/main/setup/.specify/memory/design.md) in the specs repository for the complete feature roadmap organized by implementation phases.
 
-### Current Phase: Foundation (Phase 1)
-- [x] Project setup and structure
-- [x] Type definitions
-- [ ] Utility libraries (git, config, filesystem, logger, prompts)
-
-### Next Phase: Core Commands (Phase 2)
-- [ ] `init` command
-- [ ] `add` command
-- [ ] `create` command
-
 ## Why "Arashi"?
 
 嵐 (Arashi) means "storm" in Japanese. This tool aims to be the calm center - the eye of the storm - that brings order to the chaos of managing multiple repositories and worktrees.

package/bin/arashi

@@ -38,5 +38,25 @@ if [ ! -f "$BINARY" ]; then
   exit 1
 fi
 
-# Execute with stdin closed (0<&-) for fzf compatibility
-exec "$BINARY" "$@" 0<&-
+# Close stdin only when piping list output (fzf compatibility)
+command=""
+force_remove="false"
+for arg in "$@"; do
+  case "$arg" in
+    -*)
+      case "$arg" in
+        -f|--force) force_remove="true" ;;
+      esac
+      continue
+      ;;
+    *) command="$arg"; break ;;
+  esac
+done
+
+if [ ! -t 1 ]; then
+  if [ "$command" = "list" ] || { [ "$command" = "remove" ] && [ "$force_remove" = "true" ]; }; then
+    exec "$BINARY" "$@" 0<&-
+  fi
+fi
+
+exec "$BINARY" "$@"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arashi",
-  "version": "1.1.3",
+  "version": "1.3.0",
   "description": "Git worktree manager for meta-repositories - The eye of the storm for your development workflow",
   "type": "module",
   "bin": {

package/scripts/postinstall.js

@@ -96,7 +96,7 @@ async function install() {
     try {
       await access(srcDir, constants.F_OK);
       console.log("✓ Development environment detected, skipping binary download");
-      console.log("  Run 'bun run build:all' to build binaries locally");
+      console.log("  Run 'bun run build' to build binary locally");
       return;
     } catch {
       // Not in development, continue with download