Set Up a Workspace

Initialize

For a new workspace:

mkdir my-workspace
cd my-workspace
aw init

Enter . when asked for the repository target. In an existing meta-repository, run aw init from its root.

Arashi stores shared workspace settings in .arashi/config.json. Commit it when the team should share the configuration.

Add repositories

aw add [email protected]:your-org/frontend.git
aw add [email protected]:your-org/backend.git

Non-bare workspaces keep managed worktrees inside the workspace by default. Bare workspaces place them alongside the bare repository. See init for custom paths.

Ignore managed paths

Repository-local ignore rules are the default. Choose another policy only when needed:

# Share the rules through .gitignore
aw init --ignore-scope tracked

# Do not write ignore rules
aw init --ignore-scope none

Use aw doctor to inspect managed-ignore state.

Start work

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

Continue with Work on a Change.