Arashi

Arashi is a Git worktree manager for meta-repositories.

It keeps related repositories aligned while you work on a feature branch across a shared workspace.

Documentation

Installation

Option 1: Install with curl (official direct install)

Prerequisites:

• curl
• bash
• A SHA-256 tool (shasum, sha256sum, or openssl)

curl -fsSL https://arashi.haphazard.dev/install | bash

Install a specific release:

curl -fsSL https://arashi.haphazard.dev/install | ARASHI_VERSION=1.4.0 bash

Verify install:

arashi --version

By default, the installer places arashi in ~/.arashi/bin and adds that path to your shell config.

If curl installation fails, use npm installation below or the manual release instructions in docs/INSTALLATION.md.

Option 2: Install with npm

npm install -g arashi

Verify install:

arashi --version

If npm is unavailable or fails, use the curl installer command above or the manual release instructions in docs/INSTALLATION.md.

Manual install from GitHub Releases

If you prefer not to use npm, download a platform binary from GitHub Releases and place it on your PATH.

macOS (Apple Silicon):

curl -L https://github.com/corwinm/arashi/releases/latest/download/arashi-macos-arm64 -o arashi
chmod +x arashi
sudo mv arashi /usr/local/bin/arashi

Linux (x64):

curl -L https://github.com/corwinm/arashi/releases/latest/download/arashi-linux-x64 -o arashi
chmod +x arashi
sudo mv arashi /usr/local/bin/arashi

Windows (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

You can also build from source for local development:

bun install
bun run build

Command Surface

Arashi currently provides these commands:

• arashi init
• arashi add <git-url>
• arashi create <branch>
• arashi list
• arashi status
• arashi remove <branch|path>
• arashi pull
• arashi sync
• arashi setup [--only <repo>] [--verbose]

Quick Example

arashi init
arashi add [email protected]:your-org/frontend.git
arashi add [email protected]:your-org/backend.git
arashi create feature-auth-refresh
arashi status

Hooks

Arashi can run lifecycle hooks during arashi create to automate setup steps.

• Global hooks in .arashi/hooks/:
  • pre-create.sh
  • post-create.sh
• Repository-specific hooks:
  • pre-create.<repo>.sh
  • post-create.<repo>.sh

See docs/hooks.md for hook behavior, environment variables, and examples.

Workflow Shortcuts

Use arashi list with fzf and optional keybinds to speed up daily navigation.

Jump to a worktree (cd)

# One-off jump
cd "$(arashi list | fzf)"

# Bash keybind (Ctrl+G)
bind '"\C-g":"cd \$(arashi list | fzf)\n"'

# Zsh keybind (Ctrl+G)
bindkey -s '^g' 'cd $(arashi list | fzf)\n'

Open or switch tmux sessions with sesh

# One-off session connect
sesh connect "$(arashi list | fzf)"

# Bash keybind (Ctrl+S)
bind '"\C-s":"sesh connect \$(arashi list | fzf)\n"'

# Zsh keybind (Ctrl+S)
bindkey -s '^s' 'sesh connect $(arashi list | fzf)\n'

Fast remove selection

# Select and remove a worktree quickly
arashi remove -f "$(arashi list | fzf)"

If you prefer the term delete, create a shell alias:

alias arashi-delete='arashi remove -f'

skills.sh Integration

Arashi also ships a dedicated skills.sh integration package for guided installation, workflow examples, and troubleshooting.

• Skill repository: repos/arashi-skills
• Canonical skill manifest: repos/arashi-skills/skills/arashi/SKILL.md
• Workflow catalog: repos/arashi-skills/skills/arashi/references/workflows.md
• Session shortcuts: repos/arashi-skills/skills/arashi/references/session-shortcuts.md

Documentation

• Installation details: docs/INSTALLATION.md
• Hook behavior: docs/hooks.md
• Setup command details: docs/commands/setup.md
• Remove command details: docs/commands/remove.md
• FZF integration: docs/FZF_COMPATIBILITY.md

Contributing

Use the canonical guide: CONTRIBUTING.md.

For specs and planning workflow, see the specs repository: github.com/corwinm/arashi-arashi.

License

MIT