How can we help you?

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/

Was this article helpful?