Metadata-Version: 2.4
Name: virtuai-cli
Version: 0.1.0
Summary: Run VirtuAI deep agents on your local machine
Author-email: uCloudStore <lmoreno@ucloudstore.com>
License: Proprietary
Project-URL: Homepage, https://imvituai.com
Keywords: virtuai,ai,agents,cli
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: websockets>=12.0
Requires-Dist: httpx[http2]>=0.27
Requires-Dist: certifi>=2024.0
Requires-Dist: keyring>=25.0
Requires-Dist: typer>=0.12
Requires-Dist: rich>=13.0

# VirtuAI CLI

Run VirtuAI deep agents on your local machine.

## Installation

```bash
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:

```bash
virtuai pair <CODE>
```

### 2. Start the local runner

```bash
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`.
