vessels

CLI for Vessels — let your agent reach you.

Vessels is the communication layer between AI agents and their human operators. This CLI handles account setup, API key management, and webhook configuration.

Installation

npm install -g vessels

Setup (Claude Code and AI assistants — fully non-interactive)

Two commands. One human step (the OTP from your inbox).

# Step 1 — send OTP to your email
vessels init --email [email protected]

# Step 2 — verify and complete setup (run with the code from your inbox)
vessels init --email [email protected] --otp 847293

# Output:
# VESSELS_API_KEY=vsl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# npm install vessels-sdk

# With webhook (optional — add once your server is deployed):
vessels init --email [email protected] --otp 847293 --webhook-url https://myapp.com/hooks/vessels
# Also prints: VESSELS_WEBHOOK_SECRET=whsec_xxx

vessels init creates an account if you don't have one, then creates an API key (and optional webhook endpoint), and prints copy-ready .env entries. It's designed for Claude Code or any AI assistant to drive autonomously — the only human touch point is entering the 6-digit OTP.

All commands

vessels init --email <email> [--otp <code>] [--name <key-name>] [--webhook-url <url>]
    First-time setup. Run once to send OTP, re-run with --otp to complete.

vessels login [--email <email>] [--otp <code>]
vessels logout
vessels whoami

vessels keys list
vessels keys create [--name <name>]
vessels keys revoke <id>

vessels webhooks list
vessels webhooks create --url <https://...> [--events interaction.response,message.user]
vessels webhooks delete <id>
vessels webhooks enable <id>
vessels webhooks disable <id>

vessels push --vessel <id> --message <text> --key <vsl_xxx>
vessels message --vessel <id> --message <text>

Full reference

• SDK: vessels-sdk on npm
• Docs: vessels.app/docs
• AI-readable reference: vessels.app/llms-full.txt