Arashi

Arashi

[](https://www.npmjs.com/package/arashi) [](https://github.com/corwinm/arashi/actions/workflows/ci.yml) [](https://github.com/corwinm/arashi/blob/main/LICENSE)

Arashi is a Git worktree manager for meta-repositories. It coordinates related repositories in one feature workspace while each repository keeps its own history, CI, and pull requests.

[Documentation](https://arashi.haphazard.dev) · [Command reference](https://arashi.haphazard.dev/commands/) · [Workflow guides](https://arashi.haphazard.dev/workflows/)

Installation

macOS and Linux:

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

Windows PowerShell:

powershell -c "irm https://arashi.haphazard.dev/install.ps1 | iex"

Open a new terminal after the Windows installer so it inherits the updated user `PATH`.

With npm:

npm install -g arashi

Verify the installation:

aw --version

`aw` is the preferred command name. `arashi` remains available for existing scripts and workflows. See the [installation guide](./docs/INSTALLATION.md) for version pinning, manual installation, and troubleshooting, or the [`update` command guide](https://arashi.haphazard.dev/commands/update/) for upgrades.

Quick start

From the repository that will coordinate your projects:

aw init
aw add git@github.com:your-org/frontend.git
aw add git@github.com:your-org/backend.git
aw create feature-auth-refresh

Arashi creates matching worktrees for the configured repositories. From there, use:

aw status                         # inspect the coordinated workspace
aw switch feature-auth-refresh    # return to a worktree
aw pull                           # update repositories
aw push --set-upstream            # publish branches
aw remove feature-auth-refre