Desktop App

The desktop app is an optional companion to the web app. It turns your computer into a device that Avi can use for local tools — terminal, filesystem, and anything else that needs to happen on your machine.

You don't need it to use Avi. You do need it for local-mode projects where the agent is working with code or files that live on your laptop.

Install

Download the installer from avi.run and run it. Available for macOS, Windows, and Linux.

Pairing

Open the app and sign in. It walks you through a device-code flow — you'll approve the app from your browser — and then the desktop app registers itself as a device under your org. Once paired it stays connected in the background.

Local tools

When a project is in local mode and bound to your device, the agent can:

• Run terminal commands (you approve what it has access to).
• Start, list, and kill long-running processes.
• Read, write, and list files on your filesystem.

Every tool call the agent makes runs on your machine — the cloud backend dispatches the request through a secure WebSocket, your desktop app executes it, and sends the result back.

Security

• The agent can only touch directories and commands you've approved through the desktop app.
• Your device uses an auth token to connect — if you want to revoke it, remove the device from the org's device settings in the web app.
• You can temporarily disable a device without removing it, if you want the agent to pause local work.

Status

The web app shows whether your device is currently connected, so you can tell at a glance whether local-mode projects are going to work right now.