TerminalWidget Command Line Options

Complete reference for Terminal Widget CLI flags.

Command Line Options

--help

-h

Help

Show help

--verbose

-v

Verbose

Print diagnostics

--version

Version

Print version

--target

Target

Widget target name (text)

--text

Text

Text line or - for stdin (stdin or text)

--no-wrap

No Wrap

Truncate instead of wrap

--ansi-mode

Ansi Mode

ANSI rendering mode (enum: auto|on|off)

--strip-colors

Strip Colors

Strip ANSI colors

--icon

Icon

SF Symbol name (text)

--image

Image

Image path or URL (file)

--filter

Filter

Image filter (enum: grayscale|gray|mono|sepia|negative|invert|inverted|pixelate|pixellate|blur|alpha)

--full-width

Full Width

Alias for --padding fill

--fit-text

Fit Text

Fit text to widget

--font

Font

Font name (text)

--font-size

Font Size

Font size points (text)

--foreground

--fg

Foreground

Foreground color (text)

--text-color

Text Color

Text color (text)

--caption-color

Caption Color

Caption color (text)

--title-color

Title Color

Title color (text)

--background

--bg

Background

Background color or bare mode (text)

--background-mode

Background Mode

No LaunchServices handoff

--alpha

Alpha

Color alpha 0..1 (text)

--progress

Progress

Progress 0-100 (text)

--progress-format

Progress Format

Progress style (enum: bar|matrix|dots|stack|circle|watch|gradient|gradient-horizontal|gradient-vertical)

--gradient-from

Gradient From

Progress gradient start (text)

--gradient-to

Gradient To

Progress gradient end (text)

--gradient-width

Gradient Width

Gradient thickness (text)

--bg-gradient-from

Bg Gradient From

Background gradient start (text)

--bg-gradient-to

--bg-gradent-to

Bg Gradient To

Background gradient end (text)

--bg-gradient-start

Bg Gradient Start

Background gradient direction (enum: n|s|e|w|nw|ne|sw|se|top|right|bottom|left|topleft|topright|bottomleft|bottomright)

--chart

Chart

Chart values or - for stdin (stdin or text)

--chart-format

Chart Format

Chart style (enum: sparkline|spark|bar|graph|line|waveform|wave|area|lollipop|strip|dot|radial|delta|threshold|smooth|sine|peak|neo|matrix|rangebar)

--chart-height

Chart Height

Chart height points or % (text)

--neo-characters

Neo Characters

Neo character set (enum: katakana|ascii|binary)

--base-zero

Base Zero

Chart baseline 0

--base

Base

Chart baseline N (text)

--bar-radius

Bar Radius

Bar corner radius 0-100 (text)

--chart-bar-style

Chart Bar Style

Bar fill style (enum: solid|glass)

--sparkline

--spark

Sparkline

Legacy sparkline values (stdin or text)

--graph

Graph

Legacy graph values (stdin or text)

--waveform

Waveform

Legacy waveform values (stdin or text)

--matrix

Matrix

Legacy matrix values (stdin or text)

--table

Table

Table file or - for stdin (stdin or file)

--no-header

No Header

Table without header styling

--grid

Grid

Table grid mode (enum: none|row|horizontal|column|vertical|both|zebra|zebra-row|zebra-column)

--no-grid

No Grid

Alias for --grid none

--table-layout

Table Layout

Table column layout (enum: auto|equal)

--zebra-opacity

Zebra Opacity

Zebra opacity (text)

--caption

Caption

Show auto caption

--caption-text

Caption Text

Custom caption text (text)

--caption-left

Caption Left

Left footer caption (text)

--caption-right

Caption Right

Right footer caption (text)

--annotate

Annotate

Annotate chart values

--label-y

Label Y

Show Y axis labels

--timestamp

Timestamp

Show last-update time

--title

Title

Widget title (text)

--title-alignment

Title Alignment

Title alignment (enum: left|center|right)

--padding

Padding

Padding points or fill (text)

--fullsize

Fullsize

Shortcut for --padding 0

--command

Command

Shell command for text (text)

--theme

--mode

Theme

Color theme (enum: system|light|dark)

--notify

Notify

Persist notify-on-change

--no-notify

No Notify

Disable notify-on-change

--notify-once

Notify Once

Notify once if changed

--json

Json

JSON source file, URL, or - (stdin or file)

--action-kind

--tap-action

Action Kind

Tap action kind (enum: open-url|open-app|run-shortcut|run-command|refresh)

--action-value

--tap-action-value

Action Value

Tap action value (text)

--clear-action

Clear Action

Clear tap action

--strict-local-open

Strict Local Open

Fail on open handoff errors

--shell

Shell

Target shell (enum: fish|bash|zsh|all)

--name

Name

Command name used in generated scripts (text)

--install

Install

Install into the user completion directory

--stdout

Stdout

Print one script to stdout

--help

-h

Help

Show help