---
title: "wendy device"
description: "Manage WendyOS devices"
---

## Syntax

```sh
wendy device [flags]
```

## Examples

```sh
wendy device --help
```

## Arguments

Choose a subcommand from See also.

## Flags

Flags below include inherited options. Types and defaults come from the CLI source. An empty default means no value is configured.

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--device` | string | (empty) | Target device hostname; `wendy run` accepts a comma-separated list to deploy one build to several devices (needs a remote build host and --detach). Defaults to $WENDY_DEVICE, then the saved default device |
| `--json` | bool | `false` | Output in JSON format |

## Output

Output depends on the operation and selected target. Use the command help for additional guidance..

## JSON output

The global `--json` option requests machine-readable output. The CLI also selects JSON mode when no interactive terminal is attached. Support and payloads are command-specific; this flag does not guarantee a single JSON document for commands that stream logs or invoke build tools. Consult Details before parsing command output.

## Exit codes

The CLI entry point returns `0` on success and for its user-cancelled or default-cleared results. Other returned errors exit with `1` and print a diagnostic to stderr. Some operations may terminate through subprocess or signal handling; do not infer application health from the CLI exit code alone.

## Common errors

Check argument values and flag combinations against the synopsis above. For discovery, build, port, and readiness failures, see [deployment troubleshooting](../../../errors/). Command-specific constraints are in Details.

## See also

- [wendy](../../../reference/cli/)
- [wendy device audio](../../../reference/cli/device/audio/)
- [wendy device cache](../../../reference/cli/device/cache/)
- [wendy device camera](../../../reference/cli/device/camera/)
- [wendy device dashboard](../../../reference/cli/device/dashboard/)
- [wendy device drivers](../../../reference/cli/device/drivers/)
- [wendy device foxglove](../../../reference/cli/device/foxglove/)
- [wendy device info](../../../reference/cli/device/info/)
- [wendy device logs](../../../reference/cli/device/logs/)
- [wendy device pair](../../../reference/cli/device/pair/)
- [wendy device rename](../../../reference/cli/device/rename/)
- [wendy device ros2](../../../reference/cli/device/ros2/)
- [wendy device top](../../../reference/cli/device/top/)
- [wendy device unenroll](../../../reference/cli/device/unenroll/)
- [wendy device unset-default](../../../reference/cli/device/unset-default/)
- [wendy device update](../../../reference/cli/device/update/)
- [wendy device volumes](../../../reference/cli/device/volumes/)
- [wendy device wifi](../../../reference/cli/device/wifi/)
- [CLI conventions and configuration](../../../reference/)

## Details



Use the command help for additional guidance.