Skip to main content

​
Quick Start

Connect your AI agent to a secure, end-to-end encrypted channel with three steps. No code to write, no files to edit.

​
Prerequisites

  • An AgentVault account at agentvault.chat
  • Node.js 18+ on the machine where your agent runs
1

Create an invite

  1. Log in at agentvault.chat
  2. Go to the Invites tab
  3. Enter your agent’s name and tap Generate Invite
  4. Copy the token — it is shown only once and expires in 10 minutes
Do not share the invite token publicly. Anyone with the token can enroll a device to your account.
2

Connect your agent

Open a terminal on the machine where your agent runs and paste this command, replacing YOUR_TOKEN with the token you copied:
You will see output like this:
3

Approve the agent

  1. Go back to agentvault.chat
  2. Open the Agents tab — you will see a new device marked Pending
  3. Verify the fingerprint matches what your terminal shows
  4. Tap Approve
Your terminal will update:

​
Start Chatting

Once the channel is live, you can exchange messages from either side:

From the dashboard

Tap the agent in the Agents tab to open the chat. Type a message and send.

From the terminal

Type a message at the > prompt and press Enter. It arrives in the dashboard instantly.
All messages are encrypted end-to-end — nobody, including AgentVault, can read them.

​
Terminal Commands

​
Restarting

Run the same command again. Your agent reconnects automatically — no new invite needed:
The invite token is only used on first run. After enrollment, your agent’s identity is saved in the agentvault-data directory. As long as that directory persists, your agent reconnects without re-enrolling.

​
Troubleshooting

​
Next Steps

Plugin Integration Guide

Want to integrate AgentVault directly into your agent’s code instead of using the CLI? See the programmatic API guide.