CallKaro CLI

Voice AI agents,
straight from your terminal.

Build, test and run CallKaro voice and chat agents with ck. Place calls, launch campaigns and read analytics without leaving your shell or your coding agent.

$npm install --global @callkaro-official/cli
Node.js 18+Browser sign-inJSON output
ck — zsh
$ ck login
Opening browser to sign in…
✓ Signed in to CallKaro

$ ck agents list
ID          NAME                 TYPE    STATUS
ag_8f2k1    Loan Reminder        voice   live
ag_3d9q7    Appointment Booker   voice   live
ag_1m4x0    WhatsApp Support     chat    draft

$ 
STEP 1

Install

One npm command, or a one-line script that sets up Node, the CLI and Skills.

STEP 2

Sign in

Run ck login and approve access in your browser.

STEP 3

Start building

Create agents, place calls and run campaigns from the command line.

Install

Pick your setup path

Install the CLI on its own, or let the automatic script handle Node.js, the CLI and CallKaro Skills together.

Manual install

Install with npm

Installs the ck command globally. Requires Node.js 18+.

npm install --global @callkaro-official/cli
npmNode 18+Global
  1. 1
    Install the packageRun the command on the left in any terminal.
  2. 2
    Sign inRun ck login. Your browser opens to approve access.
  3. 3
    Check it worksRun ck agents list to see your voice agents.
Automatic setup

macOS or Linux

Installs Node.js when needed, then installs both the CLI and Skills.

curl -fsSL https://cli.callkaro.ai/install.sh | bash
BashCLI + SkillsInstalls Node
  1. 1
    Open a terminalTerminal, iTerm, or any Linux shell.
  2. 2
    Paste and runThe script detects what is missing and installs it.
  3. 3
    Run ck loginApprove access in the browser and you are ready.
Automatic setup

Windows

Installs Node.js when needed, then installs both the CLI and Skills.

irm https://cli.callkaro.ai/install.ps1 | iex
PowerShellCLI + SkillsInstalls Node
  1. 1
    Open PowerShellWindows Terminal or PowerShell both work.
  2. 2
    Paste and runThe script installs Node.js, the CLI and Skills.
  3. 3
    Run ck loginApprove access in the browser and you are ready.
For AI coding agents

Install CallKaro Skills

Adds CallKaro Skills globally to your detected AI coding agents, so they know how to drive ck.

npx --yes skills add mail-daddy-ai/callkaro-skills --global --yes
npxGlobalAuto-detects agents
  1. 1
    Install the CLI firstSkills teach your agent to call ck, so install it above.
  2. 2
    Run the skills commandIt finds your coding agents and adds the skill graph.
  3. 3
    Just askTell your agent to build or test a CallKaro agent.
What you can do

Run voice operations
from the command line

Everything in the dashboard, scriptable. Read commands return JSON so they are easy to pipe, automate and hand to an AI agent.

01

Build voice agents

Create, update, version and publish agents.

ck agents list
02

Place calls

Start single calls, test while iterating, review history.

ck calls list
03

Run campaigns

Launch, schedule, monitor and retry batch calls from a CSV.

ck batches
04

Test conversations

Simulate agent behavior with test cases before going live.

ck sim
05

Manage numbers

Browse, buy, assign and release phone numbers.

ck numbers list
06

Understand performance

Agent health, A/B winners, cost and why calls fail.

ck analytics overview
Developer setup

Works with your AI agent too

Prefer conversation to commands? Install Skills and your coding agent drives ck for you, or connect the remote MCP server.

First run
$ ck login        # sign in through your browser
$ ck whoami       # confirm account and credits
$ ck agents list  # see your voice agents
$ ck --help       # explore every command
Prefer MCP?
$ claude mcp add --transport http \
    --scope user callkaro \
    https://mcp.callkaro.ai/api/mcp
$ claude mcp login callkaro
Package@callkaro-official/cli
RequiresNode.js 18+
AuthorizationBrowser sign-in
Copied to clipboard