Metadata-Version: 2.4
Name: kallyai-cli
Version: 1.0.0
Summary: CLI for KallyAI - AI phone assistant that makes calls to businesses
Project-URL: Homepage, https://kallyai.com
Project-URL: Documentation, https://github.com/KallyAI/kallyai-cli
Project-URL: Repository, https://github.com/KallyAI/kallyai-cli
Project-URL: Issues, https://github.com/KallyAI/kallyai-cli/issues
Author-email: KallyAI <support@kallyai.com>
License-Expression: MIT
License-File: LICENSE
Keywords: ai,appointment,assistant,calls,cli,kallyai,phone,reservation
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Telephony
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25.0
Description-Content-Type: text/markdown

# KallyAI CLI

A command-line interface for [KallyAI](https://kallyai.com) - 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

```bash
pip install kallyai-cli
```

Or install from source:

```bash
git clone https://github.com/anthropics/claude-code-skills.git
cd claude-code-skills/kallyai-api
pip install -e .
```

## Quick Start

```bash
# 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.

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

## Commands

### Making Calls

```bash
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

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

### Call History

```bash
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:

```bash
# 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](docs/api-reference.md).

## Requirements

- Python 3.10+
- httpx

## License

MIT License - see [LICENSE](LICENSE)

## Links

- [KallyAI Website](https://kallyai.com)
- [Pricing](https://kallyai.com/pricing)
- [API Documentation](https://api.kallyai.com/docs)
