kallyai-cli 1.0.0

CLI for KallyAI - AI phone assistant that makes calls to businesses

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/anthropics/claude-code-skills.git
cd claude-code-skills/kallyai-api
pip install -e .

Quick Start

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

# Make a call
kallyai --phone "[phone]" --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 "[phone]" -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

Claude Code Skill

This CLI can also be used as a Claude Code skill. Add to your skills:

# Copy to Claude Code skills directory
cp -r kallyai-api ~/.claude/skills/

Then invoke with the skill trigger words: "call", "phone", "reservation", "appointment", "KallyAI".

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

MIT License - see LICENSE

Links

• KallyAI Website
• Pricing
• API Documentation