Getting Started

From zero to your first agent action in under two minutes.

1

Install the Desktop App

Download the desktop app for your platform. Available for macOS, Windows, and Linux.

# Or install via CLI
curl -fsSL https://jovoexchange.com/install.sh | sh
2

Pair Your Phone

Open the desktop app and scan the QR code with the JoVo Android app. Pairing uses a secure key exchange — no account or password needed.

Tip: Both devices must be on the same network for initial pairing. After that, they communicate through the encrypted relay.
3

Create Your First Trust Ring

A Trust Ring is your private group of trusted devices. Create one from the desktop app:

# Using the CLI
jovo trust-ring create --name "My Devices"
# Add your phone
jovo trust-ring add-device --ring "My Devices"

Your phone will receive a pairing request. Accept it to join the Trust Ring.

4

Run Your First Agent Action (Dry Run)

Test the agent loop with a dry-run action. This sends an approval request to your phone without executing anything:

# Dry-run: sends approval request
jovo agent run --dry-run "Share today's build log"

Check your phone — you should see an approval request. Approve it, and a signed receipt is created on both devices. That’s the full loop.

You’re set up!

Your Trust Ring is active, your devices are paired, and your agent can now request approvals, execute tasks, and produce signed receipts. Explore skills, add more devices, or dive into the security architecture.