list Command

What It’s For

Find and jump to worktrees quickly.

What It Does

• Prints known worktree paths from the workspace.
• Supports shell workflows like fzf selection.
• Helps users navigate without manually searching directory trees.

Usage

arashi list [options]

Key Options

• -v, --verbose include detailed sub-repository information.
• -j, --json output JSON.
• -t, --table print a table with headers.
• --max-depth <depth> set sub-repo discovery depth (default 3).

Examples

# Pipe-friendly path list
arashi list

# Table output
arashi list --table

# Interactive navigation
cd "$(arashi list | fzf)"

# Emit structured worktree data
arashi list --json

Notes

• Default output is intentionally simple for shell composition.
• Use --json when another tool needs structured output.
• Standalone mode never traverses sub-repositories. --max-depth is not supported there, and --verbose reports detailed Git metadata for the standalone repository’s worktrees only.

Related Commands

list supports standalone repositories from the main or a linked worktree. See the Standalone Repository workflow for discovery and lifecycle scope.

• status
• remove