Skip to content
Arashi logo Arashi

create Command

What It’s For

Start feature work across multiple repositories from a single command.

What It Does

  • Creates a worktree for the target branch in each configured repository.
  • Ensures repositories are aligned to the same branch name.
  • Runs configured lifecycle hooks when present.

Usage

Terminal window
arashi create <branch> [options]

Key Options

  • --only <repos> limit creation to comma-separated repository names.
  • -i, --interactive pick repositories interactively.
  • --switch switch to the created parent worktree after create.
  • --no-switch disable configured create switch defaults for one invocation.
  • --launch open a terminal/editor context after create.
  • --no-launch disable configured create launch defaults for one invocation.
  • --sesh force sesh launch mode (implies launch behavior).
  • --conflict <strategy> preselect conflict handling (ABORT, REUSE_EXISTING).
  • --no-hooks disable hook execution.
  • --no-progress hide progress indicators.
  • --dry-run generate a plan without creating worktrees.

Examples

Terminal window
# Create branch worktrees across the workspace
arashi create feature-auth-refresh


# Create in specific repositories only
arashi create feature-auth-refresh --only api,web


# Force launch for this run
arashi create feature-auth-refresh --launch


# Disable configured launch default for this run
arashi create feature-auth-refresh --no-launch


# Review the plan first
arashi create feature-auth-refresh --dry-run

Notes

  • create validates branch names and repository readiness.
  • On failure, coordinated operations can roll back to keep repos consistent.
  • Configure defaults in .arashi/config.json under defaults.create (switch, launch, launchMode).
  • Precedence for launch/switch behavior is: explicit flag > opt-out flag > config default > built-in default.