treeman

treeman worktree health across all registered repos, in a dropdown.

Add it to your layout with treeman:

bar:
  layout:
    - monitor: "*"
      right: [treeman]

General

Field	Type	Default	Description
format	string	"{{ total }}"	Format string for the label.
icon-name	string	"ld-layers-symbolic"	Module icon (shown when every worktree is resting-ready).
icon-preparing	string	"ld-loader-circle-symbolic"	Icon shown while any worktree is being prepared.
icon-tearing-down	string	"ld-trash-2-symbolic"	Icon shown while any worktree is being torn down.
icon-failed	string	"ld-alert-triangle-symbolic"	Icon shown when any worktree's last finalize errored.
hide-if-empty	bool	false	Collapse the module entirely when there are no active worktrees.
border-show	bool	false	Display border around button.
icon-show	bool	true	Display module icon.
label-show	bool	true	Display count label.
label-max-length	u32	0	Max label characters before truncation with ellipsis. Set to 0 to disable.

More about format

Placeholders

• {{ total }} - Total active worktrees
• {{ stable }} - Worktrees in the ready bucket
• {{ up }} - Worktrees preparing
• {{ down }} - Worktrees tearing down
• {{ failed }} - Worktrees whose last finalize errored

Examples

• "{{ total }}" - "7"
• "{{ total }} ({{ failed }}!)" - "7 (1!)"

Colors

Field	Type	Default	Description
border-color	ColorValue	"border-accent"	Border color token.
icon-color	ColorValue	"auto"	Icon foreground color. Auto selects based on variant for contrast.
icon-bg-color	ColorValue	"accent"	Icon container background color token.
label-color	ColorValue	"fg-default"	Label text color token.
button-bg-color	ColorValue	"bg-surface-elevated"	Button background color token.

Click actions

Field	Type	Default	Description
left-click	ClickAction	"dropdown:treeman"	Action on left click.
right-click	ClickAction	""	Action on right click.
middle-click	ClickAction	""	Action on middle click.
scroll-up	ClickAction	""	Action on scroll up.
scroll-down	ClickAction	""	Action on scroll down.

Default configuration

modules:
  treeman:
    format: '{{ total }}'
    icon-name: ld-layers-symbolic
    icon-preparing: ld-loader-circle-symbolic
    icon-tearing-down: ld-trash-2-symbolic
    icon-failed: ld-alert-triangle-symbolic
    hide-if-empty: false
    border-show: false
    border-color: border-accent
    icon-show: true
    icon-color: auto
    icon-bg-color: accent
    label-show: true
    label-color: fg-default
    label-max-length: 0
    button-bg-color: bg-surface-elevated
    left-click: dropdown:treeman
    right-click: ""
    middle-click: ""
    scroll-up: ""
    scroll-down: ""