KallyAI CLI

A command-line interface for KallyAI - an AI phone assistant that makes calls to businesses on your behalf.

Features

• Make AI phone calls - Reserve tables, schedule appointments, inquire about services
• Check usage - Monitor your minutes and calls remaining
• View call history - List and inspect past calls
• Get transcripts - Read full conversation transcripts
• Manage billing - Access Stripe billing portal

Installation

pip install kallyai-cli

Or install from source:

git clone https://github.com/Kally-Intelligence-Inc/kallyai-cli.git
cd kallyai-cli
pip install -e .

Quick Start

# Check your usage (will prompt for login on first use)
kallyai --usage

# Make a call
kallyai --phone "+15551234567" --task "Ask about store hours"

# View call history
kallyai --history

Authentication

Authentication is automatic. On first use, a browser window opens for Google/Apple sign-in. Tokens are securely stored locally.

kallyai --login      # Force re-authentication
kallyai --logout     # Clear saved credentials
kallyai --auth-status # Check if logged in

Commands

Making Calls

kallyai -p "+15551234567" -t "Reserve a table for 4 at 8pm" \
  --category restaurant \
  --name "John Smith" \
  --party-size 4 \
  --date "2026-01-28" \
  --time "20:00"

Option	Short	Description
--phone	-p	Phone number (E.164 format)
--task	-t	What the AI should accomplish
--category	-c	restaurant, clinic, hotel, general
--language	-l	en or es
--name		Your name (for reservations)
--business		Business name
--party-size		Party size (restaurants)
--date		YYYY-MM-DD
--time		HH:MM (24-hour)

Account & Usage

kallyai --usage        # Show minutes/calls remaining
kallyai --subscription # Show subscription status
kallyai --billing      # Open Stripe billing portal

Call History

kallyai --history              # List recent calls
kallyai --call-info <ID>       # Get call details
kallyai --transcript <ID>      # Get conversation transcript

AI Assistant Integration

This CLI integrates with AI assistants, allowing Claude to make phone calls on your behalf.

Clawdbot (Recommended for Desktop)

Clawdbot is a native macOS app for Claude. Install the KallyAI skill:

# Install CLI
pip install kallyai-cli

# Create skill directory and download skill
mkdir -p ~/.clawdbot/skills/kallyai
curl -o ~/.clawdbot/skills/kallyai/SKILL.md \
  https://raw.githubusercontent.com/Kally-Intelligence-Inc/kallyai-cli/main/clawdbot-skill/SKILL.md

Or install from source:

git clone https://github.com/Kally-Intelligence-Inc/kallyai-cli.git
mkdir -p ~/.clawdbot/skills/kallyai
cp kallyai-cli/clawdbot-skill/SKILL.md ~/.clawdbot/skills/kallyai/

Claude Code (Terminal)

Claude Code is Anthropic's official CLI for Claude.

Method 1: One-Line Install (Recommended)

# Install CLI globally
pip install kallyai-cli

# Create skills directory and download skill file
mkdir -p ~/.claude/skills/kallyai-api
curl -o ~/.claude/skills/kallyai-api/SKILL.md \
  https://raw.githubusercontent.com/Kally-Intelligence-Inc/kallyai-cli/main/skill/SKILL.md

Method 2: Install from Source

# Clone repository
git clone https://github.com/Kally-Intelligence-Inc/kallyai-cli.git
cd kallyai-cli

# Install CLI
pip install -e .

# Copy skill to Claude Code
mkdir -p ~/.claude/skills/kallyai-api
cp skill/SKILL.md ~/.claude/skills/kallyai-api/

Method 3: User Settings (Alternative)

Add to your Claude Code settings file (~/.claude/settings.json):

{
  "skills": {
    "kallyai-api": {
      "path": "/path/to/kallyai-cli/skill"
    }
  }
}

Usage with AI Assistants

Once installed, Claude will automatically use the skill when you mention:

• "call", "phone call", "make a call"
• "reservation", "book a table"
• "appointment", "schedule"
• "KallyAI"

Example prompts:

• "Call +15551234567 and ask about their store hours"
• "Make a reservation at Italian Bistro for 4 people at 8pm"
• "Check my KallyAI usage"
• "Show my recent calls"

Security

• Token storage: ~/.kallyai_token.json with 0600 permissions
• CSRF protection: State parameter validation
• Localhost only: OAuth redirects only to localhost/127.0.0.1
• Auto-refresh: Tokens refresh automatically when expired

API Documentation

For direct API usage, see the API Reference.

Requirements

• Python 3.10+
• httpx

License

Proprietary License - see LICENSE

This software is provided under a proprietary license. You may use it solely for personal or internal business purposes in connection with KallyAI services. Reverse engineering, decompilation, and security testing are prohibited without prior written consent.

Links

• KallyAI Website
• Pricing
• API Documentation