daft list

List all worktrees with status information

Usage

daft list [REPO] [OPTIONS]

Description

Lists all worktrees in the current project with enriched status information including uncommitted changes, ahead/behind counts vs. both the base branch and the remote tracking branch, branch age, and last commit details.

Each worktree is shown with:

• A > marker for the current worktree
• Branch name, with ✦ for the default branch
• Relative path from the current directory
• Ahead/behind counts vs. the base branch (e.g. +3 -1)
• File status: !N conflicted, +N staged, -N unstaged, ?N untracked
• Remote tracking status: ⇡N unpushed, ⇣N unpulled
• Branch age since creation (e.g. 3d, 2w, 5mo)
• Last commit: shorthand age + subject (e.g. 1h fix login bug)
• Owner: author name of the branch's commit range owner, per daft.ownership.strategy (available via --columns owner)

Ages use shorthand notation: <1m, Xm, Xh, Xd, Xw, Xmo, Xy.

Use -b / --branches to also show local branches without a worktree. Use -r / --remotes to also show remote tracking branches. Use -a / --all to show both (equivalent to -b -r).

Non-worktree branches are shown with dimmed styling and blank Path/Changes columns.

Use --stat lines to show line-level change counts (insertions and deletions) instead of the default summary (commit counts for base/remote, file counts for changes). This is slower as it requires computing diffs for each worktree.

Use --format for machine-readable output suitable for scripting. Supported formats: json, ndjson, tsv, csv, yaml, toon, markdown. JSON output includes fields like is_default_branch, staged, unstaged, untracked, conflicted, operation, identity_source, remote_ahead, remote_behind, branch_age, owner_name, and owner_email. Use --template '<tera>' for custom output.

Use --columns to select which columns are shown and in what order.

Paused operations and detached HEAD

Git detaches a worktree's HEAD to run a rebase, and keeps it detached until the rebase finishes. A worktree in that state keeps its branch name here: the row still reads feat/x, sorts in its usual place, and keeps its Base, Age, Owner and PR cells. The annotation column gains a glyph for the paused operation — ⟲ rebase, ⇄ merge, ⤷ cherry-pick, ⎌ revert, ◐ bisect, ✉ git am — and unresolved conflicts appear as a red !N under Changes.

Add the status column to see the state in words:

daft list --columns +status

It reads rebasing · 2 conflicts while conflicts remain, and rebasing · resolved once they are resolved and staged but the operation is still waiting to be continued — a state nothing else in the table can show, since the conflict count is then zero.

Only a detached checkout that no operation explains is treated as a scratch sandbox (○, dimmed). Even then, if daft knows what branch the worktree was created for it keeps that name and reports the checked-out commit as detached @ <sha>.

If the checked-out branch disagrees with what daft recorded the worktree was for — someone checked out a different branch into it, or renamed one outside daft rename — the checkout wins the name and the row is marked drifted. daft doctor lists these, and daft doctor --fix updates the records to match what is checked out.

Structured output carries the same information as operation (null when none), conflicted, and identity_source (attached, recovered, persisted, or none).

Two-section layout

When git config user.email is set, the output is split into two sections:

• Your branches — branches whose resolved owner email (per the daft.ownership.strategy setting) matches your git config user.email.
• Other branches — all remaining branches.

This makes it easy to identify your active work at a glance. The section divider is only shown when both sections are non-empty.

Listing other repositories

Give a cataloged repository as the positional argument to list its worktrees from anywhere — daft list api is sugar for daft list --repo api. The name must be in the repo catalog; a miss is a hard error with suggestions (the positional never falls back to a branch or worktree meaning). Use --all-repos to sweep every cataloged repository, one section per repo. Both forms work from outside any repository.

Options

Option	Description	Default
[REPO]	Cataloged repository to list (same as --repo)
--repo <REPO>	List another cataloged repository's worktrees
--all-repos	List every cataloged repository's worktrees
--format <FORMAT>	Output format: json, ndjson, tsv, csv, yaml, toon, markdown
--template <STR>	Tera template string for custom output
--no-headers	Omit header row (tsv/csv only)
-v, --verbose	Be verbose; show detailed progress
-b, --branches	Also show local branches without a worktree
-r, --remotes	Also show remote tracking branches
-a, --all	Show all branches (equivalent to -b -r)
--stat <STAT>	Statistics mode: summary or lines (default: from git config daft.list.stat, or summary)
--columns <COLUMNS>	Columns to display (comma-separated). Replace mode: branch,path,age. Modifier mode: +col,-col
--sort <SORT>	Sort order (comma-separated). +col ascending, -col descending. Sortable columns: branch, path, size, age, owner, activity (aliases: commit, last-commit). Default: daft.list.sort or +branch.

Global Options

Option	Description
-h, --help	Print help information
-V, --version	Print version information

Examples

# List all worktrees with status
daft list

# Also show local branches without a worktree
daft list --branches

# Show all branches including remote tracking branches
daft list --all

# Show line-level insertions/deletions instead of commit counts
daft list --stat lines

# Machine-readable JSON output
daft list --format json

# Pipe JSON to jq for filtering
daft list --format json | jq '.[] | select(.unstaged > 0)'

# Show only branch, path, and age columns (replace mode)
daft list --columns branch,path,age

# Remove annotation and last-commit from defaults (modifier mode)
daft list --columns -annotation,-last-commit

# Add the Owner column to the default layout
daft list --columns +owner

# Show branch, path, and owner only
daft list --columns branch,path,owner

# List another cataloged repo's worktrees (sugar for --repo api)
daft list api

# Every cataloged repo, one section per repo
daft list --all-repos

Structured Output

daft list supports machine-readable output via --format: json, ndjson, tsv, csv, yaml, toon, markdown, plus --template <tera> for custom output.

# Two columns for awk / cut
daft list --format tsv --no-headers | cut -f2,3

# Pipe to jq
daft list --format json | jq '.[] | select(.is_current == true)'

# Custom one-liner per worktree
daft list --template '{% for r in items %}{{ r.name }} -> {{ r.path }}
{% endfor %}'

See the Output Formats guide for format details and Tera syntax.

See Also

• git worktree-list for the underlying git-native command