WendyOS Docs
AdvancedClientsWendy cli

Global Flags

These flags are available on every wendy command.

Global Flags

These flags are available on every wendy command.

--json

Outputs command results as JSON instead of the default interactive TUI or table format.

wendy device list --json

When stdout is not a TTY (for example, when piping output, running in CI, or executing from a script), --json is automatically enabled. An explicit --json or --json=false always takes precedence over the automatic detection.

# JSON output without passing --json explicitly
wendy device list | cat

# Suppress JSON even in a non-TTY context
wendy device list --json=false | cat

--device

Specifies a target device by IP address or hostname, bypassing device selection.

wendy --device 192.168.1.42 device apps list

Environment variables

VariableDescription
GITHUB_TOKENWhen set, the CLI uses it as a bearer token for GitHub API release checks and agent update lookups. When absent, those requests are made unauthenticated.
WENDY_ANALYTICSSet to false to disable analytics.

Device Selection

Many CLI operations run on the remote device. When a connection is to be established, the CLI goes down a list in order to connect to this device.

Build

Builds your WendyOS app. Leverages wendy.json for metadata. If wendy.json is missing, it prompts you to generate one.

On this page

Global Flags--json--deviceEnvironment variables