For the complete documentation index, see llms.txt.

CLI

The vennio CLI lets you manage booking links, check bookings, and fire test bookings without leaving your terminal.

Installation

npm install -g vennio

Commands

vennio init

Interactive setup wizard. Prompts you to paste an API key, optionally create a schedule, create your first booking link, and fire a test booking. Stores config at ~/.vennio/config.json.

vennio status

Shows your current config and verifies connectivity to the Vennio API:

vennio status
# API Key: vennio_sk_live_...xxxx
# Business ID: uuid
# API: connected ✓

vennio links list

Lists all your booking links — title, shortcode, duration, active state, and public URL.

vennio links create

Interactive wizard to create a new booking link. Prompts for title, duration (15 / 30 / 45 / 60 min), and an optional description.

vennio bookings list

Lists bookings. Supports filtering flags:

Flag Description
--status confirmed|pending|cancelled Filter by booking status
--limit N Maximum number of results to return

vennio bookings create

Create a booking from the terminal. All flags are optional — the CLI prompts for anything not supplied:

Flag Description
--name Customer name
--email Customer email
--start Start time (ISO 8601)
--end End time (ISO 8601)
--demo Use demo/placeholder values

vennio test

Fires a demo booking for tomorrow at 10:00–10:30 AM and prints the full booking record. Useful for verifying your API key and businessId config are working.

vennio open [shortcode | --docs]

Opens a booking link or the documentation in your browser:

vennio open my-shortcode   # opens https://vennio.app/b/my-shortcode
vennio open --docs         # opens docs.vennio.app

Config file

Stored at ~/.vennio/config.json:

{
  "apiKey": "vennio_sk_live_...",
  "baseUrl": "https://api.vennio.app",
  "businessId": "your-business-id"
}

Gotchas