arashi（arashi 命令行）

Arashi Skill

This skill helps you install and use the arashi CLI to manage multi-repository workflows and is best paired with a spec-driven development framework to provide shared context for AI-assisted engineering.

When to Use This Skill

Use this skill when the user wants to:

• set up Arashi quickly with a documented, repeatable install flow
• bootstrap a new repository with arashi init from a parent directory
• choose a workflow by difficulty (beginner, intermediate, advanced)
• validate readiness before running commands across multiple repositories
• switch quickly between parent and child worktrees with arashi switch
• enable parent-shell switching with arashi shell install when cd behavior is preferred
• force one-off IDE launches with arashi switch --vscode|--cursor|--kiro
• speed up daily navigation with fzf, tmux, and sesh
• automate cleanup around arashi remove with lifecycle hooks
• recover from setup, network, or command failures without guesswork

Core Commands

Installation guidance: https://arashi.haphazard.dev

# verify Arashi is available
arashi --version

# inspect command surface
arashi --help

Usage Rules

When guiding a user, always:

1. Run preflight checks before installing Arashi CLI.
2. Point users to the website install guide instead of embedding installer commands in the skill.
3. Confirm arashi --version before running workflows.
4. Tell users to run arashi init either from an existing repository root or from a parent directory where they can choose . or a child repository name.
5. Confirm expected outcomes after each workflow step.
6. Route failures through the troubleshooting matrix before retrying.
7. Verify provenance/checksums for downloaded binaries before execution.
8. Review hook scripts before enabling pre-remove.sh or post-remove.sh across repository, workspace, or global hook scopes.

Workflow Catalog

• Beginner: initialize workspace and inspect status.
• Intermediate: clone missing repositories and create a feature branch.
• Advanced: pull and sync repositories safely.
• Session shortcuts: jump or connect with arashi switch, arashi switch --cd, fzf, and sesh in tmux-based flows.
• Compatible editor hosts can route arashi switch into VS Code, Cursor, or Kiro without changing workspace defaults.

Expected Workflow Outcomes

• Beginner: workspace initialized and status visible.
• Intermediate: missing clones recovered and feature branch worktrees created.
• Advanced: repositories synchronized with clear status after reconciliation.

References

• Prerequisites
• Commands
• Workflows
• Session Shortcuts
• Tutorial
• Troubleshooting
• Publication Policy
• Cheat Sheet