VSCode Extension

Wendy for VS Code Extension

The Wendy for VS Code extension brings device management, one-click deployment, and remote debugging into your editor. It works for Swift, Python, and any containerized app.

• Device discovery & management — find WendyOS devices on your network or over USB
• One-click deployment — build and run on a device with F5
• Remote debugging — breakpoints, stepping, and variable inspection for Swift (LLDB) and Python (debugpy)
• Agent updates — keep a device's agent current from the editor
• OS installation — flash WendyOS onto a disk
• WiFi configuration — connect a device to a wireless network

Installing the Extension

code --install-extension wendylabsinc.wendy-vscode

Prerequisites

• Wendy CLI installed on your development machine (wendy --version to verify)
• A WendyOS device (NVIDIA Jetson Orin Nano, NVIDIA Jetson Thor, or Raspberry Pi 5)
• For Swift: the WendyOS Swift SDK and the Swift extension
• For Python: the Python extension

The Wendy Sidebar

After installing, click the Wendy icon in the Activity Bar to open the sidebar, which has four panels:

Managing Devices

The Devices panel lists discovered and manually added devices. Click a device to select it as your deployment target — a checkmark marks the current one. Click the info icon (or right-click) on a device to see its hostname, agent version, device ID, interface type (USB / Ethernet / LAN), and running apps.

• Add a device manually (e.g. on a different subnet): click + in the panel header and enter a hostname or IP, optionally with a port — wendyos-humble-pepper.local, 192.168.1.100, or 192.168.1.100:50051.
• Refresh: click the refresh icon, or run Wendy: Refresh Devices from the Command Palette.

If a device doesn't appear, see Discovering Devices.

Updating the WendyOS Agent

The extension shows each device's agent version and prompts you when an update is available. To update, right-click a device and select Update Agent (or run Wendy: Update Agent). The agent downloads, installs, and the device briefly restarts.

Installing WendyOS

The extension can flash WendyOS onto an SD card or NVMe drive — useful for setting up a new device, reinstalling, or upgrading.

You'll need the storage device connected to your machine, ~8GB+ of free space for the image, and admin/sudo access for disk operations.

1. Connect the SD card or NVMe drive and open the Disks panel
2. Right-click the target disk and select Flash WendyOS
3. Choose your device type (e.g. NVIDIA Jetson Orin Nano, Raspberry Pi 5) and confirm
4. Wait for flashing to finish — this can take several minutes

The Operating System Cache panel lets you browse cached images, delete old ones to free space, and reveal the cache directory in your file manager. The cache lives at ~/.wendy/cache (macOS/Linux) or %LOCALAPPDATA%\Wendy\cache (Windows).

Configuring WiFi

Right-click a device, select Connect WiFi, pick a network from the scan results, and enter the password.

Building, Running, and Debugging

With a device selected, open a Swift package or Python project, press F5, and pick a Wendy debug configuration. The extension builds your app, deploys it to the device, starts it with debugging enabled, and attaches the debugger — set breakpoints first and VS Code's debugger works as usual. After editing code mid-session, restart it (Ctrl+Shift+F5) to redeploy.

To run without debugging, use the Command Palette's "Tasks: Run Task" and pick a Wendy task (e.g. "Wendy: Run").

Swift

Uses LLDB (via lldb-dap) over port 4242. The extension generates a Debug [YourAppName] on WendyOS configuration for each executable target in your package. Requires:

• The WendyOS Swift SDK installed at ~/.swiftpm/swift-sdks/
• The Swift extension for VS Code

Python

Uses debugpy over port 5678 with the Debug Python App on WendyOS configuration. Add debugpy to your project's requirements:

debugpy>=1.8.0

Extension Settings

Configure the extension through VS Code settings (Cmd+, / Ctrl+,):

Troubleshooting

Device not discovered — Confirm the device is powered on and running WendyOS, check your USB connection, verify both machines are on the same network, and that mDNS/Bonjour isn't blocked. Otherwise add the device manually. See Discovering Devices.

Agent update fails — Ensure a stable connection (try USB instead of WiFi), confirm the device has enough storage, then restart it and retry.

Debugging won't connect — Verify port 4242 (Swift) or 5678 (Python) is reachable and not firewalled, that the app was started with --debug, then restart VS Code and the device.

Next Steps

• Connect your device to WiFi for wireless development
• Discover devices using the CLI
• Manage applications on your device