// widgets

Widgets Reference

All 18 built-in widgets and their configuration options.

WidgetDescriptionExample

Info Widgets

modelCurrent AI model nameOpus 4.6

os-infoPlatform & architecturedarwin arm64

vim-modeCurrent vim mode indicator[NORMAL]

timestampSession start time14:32

Git Widgets

git-branchCurrent branch namefeature/auth

git-statusWorking tree status icon✗ dirty

nested-reposDetect nested git repos2 repos

lines-changedAdded/removed line count+42 -7

Token Widgets

token-barVisual progress bar━━━━━━━━────

token-countUsed/total tokens116k/200k

context-percentContext window usage %58%

total-tokensCumulative token total1.2M

cache-ratioCache hit percentage87%

Layout Widgets

separatorVisual divider between widgets│

spacerFlexible space filler← space →

Cost Widget

costSession cost in 20 currencies$1.23

Time Widget

durationElapsed session time12m34s

Add widgets to your lines in config.yml:

lines:
  - widgets: [model, separator, directory, separator, git-branch]
  - widgets: [token-bar, context-percent, cost]
  - widgets: []