VesselsLet your agent
reach you.
The communication layer between your AI agents and you. Send structured messages, request approvals, and act on decisions — without building your own app.
import { Vessels } from 'vessels-sdk';
const vessels = new Vessels({ apiKey: process.env.VESSELS_API_KEY });
await vessels.push({
vessel: "booking-123",
vesselTitle: "Sarah Martinez — Saturday",
message: "New booking — needs your approval.",
interaction: vessels.approval({
prompt: "Confirm Sarah's Saturday session?",
approveLabel: "Confirm booking",
}),
vesselStatus: "waiting",
});See it in action
From trigger to decision.
Your agent fires once. A card appears on your phone. You respond. Your agent acts.
New enquiry received
Vessels · just now
New booking needs your approval
Confirm Sarah's Saturday session?
If you're already using a Telegram bot
You're doing this. Just with more code.
Count the steps.
Vessels
One feed per entity — booking, lead, incident. Messages stay contextual and scannable.
Interactions
5 card types: approval, choice, checklist, text input, confirm preview. Your agent asks, you answer.
Webhooks & Polling
Responses delivered via signed webhook or cursor-based poll. Your agent acts immediately.
Claude Code & AI assistants
Tell Claude Code to set it up.
The CLI is designed for AI agents to drive. You enter one confirmation code from your inbox. Everything else is automated.
$ vessels init --email you@example.com OTP sent. Run: vessels init --email you@example.com --otp <code> $ vessels init --email you@example.com --otp 847293 Setup complete. VESSELS_API_KEY=vsl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx npm install vessels-sdk
Run vessels init
Claude Code sends a one-time code to your inbox. Nothing else is interactive.
Enter your OTP
The only human step. Copy the 6-digit code from your email and give it to Claude Code.
Your key is ready
Claude Code pastes VESSELS_API_KEY into your .env and installs the SDK. Done.