Command Line Flags
Complete reference for Terminal Widget CLI flags.
| Flag | Description | Value |
|---|---|---|
| –help, -h | Show help | none |
| –verbose, -v | Print diagnostics | none |
| –version | Print version | none |
| –target | Widget target name | text |
| –text | Text line or - for stdin | stdin or text |
| –no-wrap | Truncate instead of wrap | none |
| –ansi-mode | ANSI rendering mode | enum: auto |
| –strip-colors | Strip ANSI colors | none |
| –icon | SF Symbol name | text |
| –image | Image path or URL | file |
| –background-image | Full-bleed background image path or URL | file |
| –filter | Image filter | enum: grayscale |
| –full-width | Alias for –padding fill | none |
| –fit-text | Fit text to widget | none |
| –font | Font name | text |
| –font-size | Font size points | text |
| –foreground, –fg | Foreground color | text |
| –text-color | Text color | text |
| –caption-color | Caption color | text |
| –title-color | Title color | text |
| –background, –bg | Background color or bare mode | text |
| –background-mode | No LaunchServices handoff | none |
| –alpha | Color alpha 0..1 | text |
| –progress | Progress 0-100 | text |
| –progress-format | Progress style | enum: bar |
| –gradient-from | Progress gradient start | text |
| –gradient-to | Progress gradient end | text |
| –gradient-width | Gradient thickness | text |
| –bg-gradient-from | Background gradient start | text |
| –bg-gradient-to, –bg-gradent-to | Background gradient end | text |
| –bg-gradient-start | Background gradient direction | enum: n |
| –chart | Chart values or - for stdin | stdin or text |
| –append | Append chart columns or text lines | stdin or text |
| –limit | Keep last N chart columns or text lines | text |
| –chart-format | Chart style | enum: sparkline |
| –chart-key | Legend placement | enum: auto |
| –chart-series-labels | Series chart legend labels | text |
| –key-target | External legend widget target | text |
| –chart-height | Chart height points or % | text |
| –neo-characters | Neo character set | enum: katakana |
| –base-zero | Chart baseline 0 | none |
| –base | Chart baseline N | text |
| –bar-radius | Bar corner radius 0-100 | text |
| –chart-bar-style | Bar fill style | enum: solid |
| –sparkline, –spark | Legacy sparkline values | stdin or text |
| –graph | Legacy graph values | stdin or text |
| –waveform | Legacy waveform values | stdin or text |
| –matrix | Legacy matrix values | stdin or text |
| –table | Table file or - for stdin | stdin or file |
| –no-header | Table without header styling | none |
| –grid | Table grid mode | enum: none |
| –no-grid | Alias for –grid none | none |
| –table-layout | Table column layout | enum: auto |
| –table-align | Per-column table text alignment | text |
| –center-table | Center auto-sized table in the widget | none |
| –zebra-opacity | Zebra opacity | text |
| –caption | Show auto caption | none |
| –caption-text | Custom caption text | text |
| –caption-left | Left footer caption | text |
| –caption-right | Right footer caption | text |
| –annotate | Annotate chart values | none |
| –label-y | Show Y axis labels | none |
| –timestamp | Show last-update time | none |
| –title | Widget title | text |
| –title-alignment | Title alignment | enum: left |
| –padding | Padding points or fill | text |
| –fullsize | Shortcut for –padding 0 | none |
| –command | Shell command for text | text |
| –theme, –mode | Color theme | enum: system |
| –notify | Persist notify-on-change | none |
| –no-notify | Disable notify-on-change | none |
| –notify-once | Notify once if changed | none |
| –json | JSON source file, URL, or - | stdin or file |
| –action-kind, –tap-action | Tap action kind | enum: open-url |
| –action-value, –tap-action-value | Tap action value | text |
| –clear-action | Clear tap action | none |
| –auto-update | Auto-update kind | enum: shortcut |
| –auto-update-value | Auto-update Shortcut name or image URL | text |
| –auto-update-interval | Auto-update interval seconds | text |
| –clear-auto-update | Clear auto-update recipe | none |
| –clear | Delete target payload and local data | none |
| –clear-buttons | Remove launcher buttons only | none |
| –strict-local-open | Fail on open handoff errors | none |
| –shell | Target shell | enum: fish |
| –name | Command name used in generated scripts | text |
| –install | Install into the user completion directory | none |
| –stdout | Print one script to stdout | none |
| –help, -h | Show help | none |