How can we help you?

Velaro CLI Guide

Last updated August 22, 2026 · 154 views · 2 min read

Velaro CLI Guide

Velaro CLI

The Velaro CLI (@velaro/cli) is a free command-line tool available to all Velaro subscribers. It lets you manage your Velaro account from a terminal — set up bots, trigger knowledge base indexing, and manage API keys without opening a browser.

Install (requires Node.js 18+):

npm install -g @velaro/cli

Login:

velaro login

This opens your browser to a short-code page. Sign in with your Velaro account. Session is saved automatically — you won't need to log in again for months.

Commands

Bot management:

velaro bot list
velaro bot setup --name "Support Bot" --prompt "..." --urls "https://help.example.com"

Knowledge base ingestion:

velaro ingest --job-id <id>

Triggers reindexing after a scraper job completes. Requires Knowledge Base feature on your plan.

MCP API keys:

velaro mcp-key list
velaro mcp-key create --label "Claude Code"
velaro mcp-key revoke <id>

Account:

velaro whoami
velaro logout
velaro status

Who can use it

The CLI is available to all Velaro subscribers at no extra cost. Some commands are gated by subscription feature:

  • bot setup — requires AI feature
  • ingest — requires Knowledge Base feature
  • mcp-key — requires MCP API Access feature

CLI vs MCP — what's the difference

CLI MCP
What it is You run commands manually or in scripts Claude (AI) calls Velaro tools automatically
Best for Setup, automation, CI/CD pipelines AI-driven workflows inside Claude Code
Requires Terminal + Node.js Claude Code or MCP-compatible client
Who controls it You type the commands The AI decides when to call it

Use the CLI when you want to script something, automate a deployment step, or manage your account without touching the admin UI.

Use MCP when you want Claude to query or update Velaro data automatically during a conversation — e.g. "pull up last week's conversations for site 42" and Claude does it.

They share the same underlying API but serve different use cases. Most power users will use both.

npm package

Published at: https://www.npmjs.com/package/@velaro/cli

Source: velaro-admin/cli/

Share: Email

Was this article helpful?

Related articles