The consuelo CLI provides complete control over your sales infrastructure from the command line.The
consuelo command-line interface lets you manage contacts, make calls, handle transfers, upload files, search your knowledge base, and deploy your infrastructure—all without leaving your terminal.
What You Can Do
Contact Management
Create, search, import, and manage your CRM contacts from the terminal.
Call Operations
Make calls, handle transfers, and manage active call sessions.
Queue Management
Create dialing queues for parallel dialing with first-to-answer wins.
Knowledge Base
Upload files, index documents, and run semantic searches.
File Management
Upload, download, and manage files linked to contacts and calls.
Analytics & History
View call history, statistics, and run coaching analysis.
Configuration
Manage settings, credentials, and workspace configuration.
Deployment
Deploy to Railway, Vercel, Docker, or AWS SAM.
Key Features
| Feature | Description |
|---|---|
| Interactive Setup | Guided wizard for first-time configuration with hosted or self-hosted options |
| Multiple Auth Methods | Consuelo SDK OAuth or API key authentication |
| E.164 Phone Handling | Strict phone number validation for reliable dialing |
| Parallel Dialing | Queue system with 3 concurrent outbound, first-to-answer wins |
| Local Presence | Auto-select caller ID based on recipient area code |
| Semantic Search | pgvector-powered knowledge base with 384-dim embeddings |
| Multiple Output Formats | Human-readable tables, JSON for scripts, or quiet mode |
| Error Telemetry | Optional Sentry integration for debugging |
Quick Start
- Install the CLI with
npm install -g @consuelo/cli - Run setup with
consuelo init - Make your first call with
consuelo calls start +15551234567
Available Commands
| Command | Description |
|---|---|
consuelo init | Interactive setup wizard |
consuelo status | Show configuration status |
consuelo contacts list | List contacts |
consuelo contacts search <query> | Search contacts |
consuelo calls start <target> | Make an outbound call |
consuelo calls transfer <id> --to <target> | Transfer an active call |
consuelo queue start <id> | Start a dialing queue |
consuelo files upload <path> | Upload a file |
consuelo kb search <query> | Search knowledge base |
consuelo history list | View call history |
consuelo config list | Show configuration |
consuelo deploy | Deploy infrastructure |
The CLI requires Node.js 18 or later. For call operations, you’ll need a
Twilio account with a configured phone number.