Skip to content
Arashi logo Arashi

Getting Started

Use this section when you are new to Arashi and need a quick setup and first workflow.

Install

Choose either install method below.

Prerequisites

  • git available in your shell
  • bash and curl for the curl installer path
  • node and npm for the npm path

Method 1: curl installer

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

Pin a specific version when needed:

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

Verify install:

Terminal window
arashi --version

The installer defaults to ~/.arashi/bin and updates your shell profile so arashi is available on PATH in new shells.

If this path fails, use npm (npm install -g arashi) or the manual release flow in repos/arashi/docs/INSTALLATION.md.

Method 2: npm global install

Terminal window
npm install -g arashi

Verify install:

Terminal window
arashi --version

If npm is unavailable or fails in your environment, use the curl installer command above or the manual release flow in repos/arashi/docs/INSTALLATION.md.

Troubleshooting and fallback

  • command not found: install missing prerequisite (curl, bash, npm, or node) and rerun.
  • Permission errors writing to global paths: rerun curl with ARASHI_INSTALL_DIR="$HOME/.local/bin" or use a user-level npm prefix.
  • Network/download failures: retry once, then switch to the other install method.
  • Checksum mismatch on curl path: stop and use npm/manual fallback, then report the failure.

First Workflow

Terminal window
arashi init
arashi add git@github.com:your-org/frontend.git
arashi create feature-docs-bootstrap
arashi switch feature-docs-bootstrap
arashi status

By default, new managed worktrees are created under .arashi/worktrees. Set command defaults in .arashi/config.json (defaults.create, defaults.switch) to define preferred switch/launch behavior.

Next Steps

  • Continue to Commands for command-by-command behavior.
  • Continue to Contributing if you are adding or editing docs.