virtuai-cli 0.2.2

Run VirtuAI deep agents on your local machine

VirtuAI CLI

Run VirtuAI deep agents on your local machine.

Installation

pip install virtuai-cli

Requires Python 3.11+.

Quick Start

1. Pair your machine

Open the VirtuAI portal, go to Settings → CLI, generate a pairing code, then run:

virtuai pair <CODE>

2. Start the local runner

virtuai run

Keep this terminal open while using VirtuAI. The agent can now execute shell commands on your machine.

3. Stop

Press Ctrl+C to stop the runner. Your workspace pairing persists.

Commands

Command	Description
virtuai pair <code>	Pair this machine with a VirtuAI workspace
virtuai run	Start the local runner
virtuai status	Show pairing and connection status
virtuai logs	Show recent commands executed by the agent
virtuai unpair	Revoke the current pairing
virtuai login	Authenticate with your VirtuAI account (browser flow)

Options

virtuai run --workdir /path/to/dir   # Set a custom working directory
virtuai run --server https://...     # Connect to a custom VirtuAI server

Security

• Commands run under your local user account with your file system permissions.
• All communication is over encrypted WebSocket (WSS).
• The agent can only run when virtuai run is active — no background daemon.
• An audit log of executed commands is written to ~/.virtuai/audit.log.