> ## Documentation Index
> Fetch the complete documentation index at: https://docs.callkaro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Started with CallKaro CLI

> Install the CLI and manage CallKaro from your terminal

CallKaro CLI lets you manage voice AI agents, calls, phone numbers, simulations, and analytics from your terminal.

## Prerequisites

Install [Node.js 18 or newer](https://nodejs.org/) before installing the CLI.

## Install the CLI

### macOS or Linux

```bash theme={null}
curl -fsSL https://cli.callkaro.ai/install.sh | bash
```

### Windows

Run in PowerShell:

```powershell theme={null}
irm https://cli.callkaro.ai/install.ps1 | iex
```

### npm

```bash theme={null}
npm install --global @callkaro-official/cli
```

### Manual installation

```bash theme={null}
curl -fsSL -o callkaro-cli.tgz https://cli.callkaro.ai/downloads/callkaro-cli-latest.tgz
npm install --global callkaro-cli.tgz
```

The package installs two equivalent commands: `ck` and `callkaro`. The examples below use `ck`.

## Sign in and verify your account

<Steps>
  <Step title="Sign in">
    Run the interactive login flow and enter your CallKaro account credentials when prompted.

    ```bash theme={null}
    ck login
    ```
  </Step>

  <Step title="Verify the active account">
    ```bash theme={null}
    ck whoami
    ```
  </Step>

  <Step title="List your voice agents">
    ```bash theme={null}
    ck agents list
    ```
  </Step>

  <Step title="Explore available commands">
    ```bash theme={null}
    ck --help
    ```
  </Step>
</Steps>

<Tip>
  Don't have a CallKaro account yet? Run `ck register` to create one from the terminal.
</Tip>

## Common commands

<CardGroup cols={2}>
  <Card title="Agents" icon="robot">
    ```bash theme={null}
    ck agents --help
    ```
  </Card>

  <Card title="Calls" icon="phone">
    ```bash theme={null}
    ck calls --help
    ```
  </Card>

  <Card title="Phone numbers" icon="hashtag">
    ```bash theme={null}
    ck numbers --help
    ```
  </Card>

  <Card title="Simulations" icon="vial">
    ```bash theme={null}
    ck simulations --help
    ```
  </Card>
</CardGroup>

Run `ck <command> --help` to see the options and subcommands available for any command.

## Install skills for your coding agent

### Claude Code

Install the CallKaro skill pack:

```bash theme={null}
ck skills install
```

You can also install it from the Claude Code plugin marketplace:

```text theme={null}
/plugin marketplace add Mail-Daddy-AI/callkaro-skills
/plugin install callkaro@callkaro
```

### OpenAI Codex

Copy the skills to `~/.codex/skills` and add them to `~/.codex/AGENTS.md`:

```bash theme={null}
ck skills install --codex
```

## Use the CLI in automation

Set `CK_TOKEN` when a script or CI job cannot use the interactive login flow.

```bash theme={null}
CK_TOKEN=your_token ck whoami
```

<Warning>
  Keep tokens private. Do not commit tokens or configuration files containing credentials.
</Warning>

Interactive login stores your session in `~/.config/callkaro/config.json` with restricted file permissions. Run `ck logout` to revoke the session.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.