Skip to content
Arashi logoArashi

pull Command

What It’s For

Section titled “What It’s For”

Update repositories in your workspace without entering each one manually.

What It Does

Section titled “What It Does”
  • Runs pull operations across managed repositories.
  • Brings local branches up to date with remote changes.
  • Reports which repositories succeeded or failed.

Usage

Section titled “Usage”
Terminal window
arashi pull [options]

Key Options

Section titled “Key Options”
  • --only <repo> limit pull to specific repositories (repeatable).
  • -v, --verbose print full git output.
  • --json output machine-readable pull results.

Examples

Section titled “Examples”
Terminal window
# Pull all eligible repositories
arashi pull


# Pull selected repositories only
arashi pull --only api --only web


# Pull with detailed command output
arashi pull --verbose


# Pull selected repositories and emit JSON
arashi pull --only api --json

Notes

Section titled “Notes”
  • Repositories with no remote changes are skipped.
  • Pull failures or manual-update states return a non-zero exit code.
  • In JSON mode, stdout contains one result document; verbose diagnostics stay out of stdout.

Agent Notes

Section titled “Agent Notes”
  • Use arashi pull before starting a new coordinated worktree when arashi status shows repositories are behind.
  • Prefer --only <repo> when the user has scoped the work to one repository and a full workspace pull would be unnecessary.
  • Re-run arashi status after pulling to confirm the workspace is ready for edits.
Section titled “Related Commands”