Quickstart

Use this guide for the shortest path from installation to a working multi-repository Arashi workspace.

Install

Install Arashi with the supported installer for your platform:

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

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

Open a new terminal if the installer changed your PATH, then verify the CLI:

aw --version

See Install Arashi for npm installation, pinned versions, platform details, and troubleshooting.

Create a workspace

Initialize the repository that will coordinate your projects, then add each child repository:

mkdir my-workspace
cd my-workspace
aw init
aw add [email protected]:your-org/frontend.git
aw add [email protected]:your-org/backend.git

When aw init asks for the repository target, enter . so the current directory becomes the workspace root.

Commit .arashi/config.json when the workspace configuration should be shared with your team. See Set Up a Workspace for layout, base branches, and managed-ignore choices.

Start the first change

Create aligned worktrees, open the change, and inspect its state:

aw create feature-auth
aw switch feature-auth
aw status

Continue with Work on a Change for the complete day-to-day lifecycle.

Other paths

• Use Arashi in One Repository when a project has not adopted workspace configuration.
• Open Integrations to connect Arashi with your editor, terminal, or workspace manager.
• Browse Commands when you need exact CLI behavior.