Wendy LogoWendy
Guides & TutorialsDevice Management

Managing Apps

Manage apps on your WendyOS device using the Wendy CLI

Managing Apps on WendyOS Devices

The Wendy CLI can help you manage apps on your WendyOS device. This works over USB connections and over your Local Area Network (LAN).

Prerequisites

  • Wendy CLI installed on your development machine
  • A WendyOS device (NVIDIA Jetson or Raspberry Pi 5) either:
    • Connected via USB cable, or
    • Connected to the same network as your development machine

Listing Apps

To discover all available WendyOS devices, run:

wendy device apps list

An example output is:

wendy device apps list
✔︎ Searching for WendyOS devices [5.1s]
✔︎ Listing applications: True Probe [USB, Ethernet, LAN] 
╭───────────────┬─────────┬─────────┬──────────╮
 App Version State Failures
├───────────────┼─────────┼─────────┼──────────┤
 hello-world 0.0.1 Stopped 0
 simple-server 0.0.0 Running 0
╰───────────────┴─────────┴─────────┴──────────╯
  • Stopped means that the app is on the WendyOS device, but not running. This is common where the app runs once and exits. This doesn't necessarily mean that the state of the app is bad, especially if the Failures column is 0. Commonly long running applications like web servers will not be in this state.
  • Running means that the app is running on the WendyOS device.
  • Failures means that the app has failed to start. This is common if the app is not properly configured.

Stopping an App

To stop an app, run:

wendy device apps stop <app-name>

An example output is:

✔︎ Searching for WendyOS devices [5.2s]
✔︎ Stopping application: True Probe [USB, Ethernet, LAN] 
i Info 
  Stop request sent 

And then you can verify the app is stopped by listing the apps again:

wendy device apps list
✔︎ Searching for WendyOS devices [5.1s]
✔︎ Listing applications: True Probe [USB, Ethernet, LAN] 
╭───────────────┬─────────┬─────────┬──────────╮
 App Version State Failures
├───────────────┼─────────┼─────────┼──────────┤
 hello-world 0.0.1 Stopped 0
 simple-server 0.0.0 Stopped 0
╰───────────────┴─────────┴─────────┴──────────╯

Starting an App

To start an app, run:

wendy device apps start <app-name>

An example output is:

wendy device apps start simple-server 
✔︎ Searching for WendyOS devices [5.2s]
✔︎ Starting application: True Probe [USB, Ethernet, LAN] 
i Info 
  Start request sent 

And then you can verify the app is started by listing the apps again:

wendy device apps list
✔︎ Searching for WendyOS devices [5.0s]
✔︎ Listing applications: True Probe [USB, Ethernet, LAN] 
╭───────────────┬─────────┬─────────┬──────────╮
 App Version State Failures
├───────────────┼─────────┼─────────┼──────────┤
 hello-world 0.0.1 Stopped 0
 simple-server 0.0.0 Running 0
╰───────────────┴─────────┴─────────┴──────────╯

Removing (or Deleting) an App

To delete an app, run:

wendy device apps delete <app-name>

An example output is:

wendy device apps delete simple-server