KallyAI Executive Assistant

KallyAI is an AI executive assistant that handles outbound + inbound calls, email, bookings, research, bills, rides, food orders, errands, multi-channel messaging, and phone number management.

Quick Start

# Natural language — routes automatically (80% of usage)
kallyai ask "Book a table at Nobu for 4 tonight"
kallyai ask "Email Dr. Smith to reschedule my Thursday appointment"
kallyai ask "Find the best plumber near me and negotiate a quote"

# Check credits (NOT minutes — credits are the sole billing unit)
kallyai credits balance

# Check inbox
kallyai messages inbox

# View incoming calls handled by AI receptionist
kallyai inbound calls

Complete Workflow

Step 1: Gather Intent

KallyAI covers 14 domains:

For most requests, use ask — it routes through the coordination AI automatically.

Step 2: Authenticate

For OAuth integration, redirect user to:

https://api.kallyai.com/v1/auth/authorize?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&scope=calls.write

User signs in with Google or Apple → receives access token.

For CLI, authentication is automatic (first API call opens browser).

kallyai login         # Force re-auth
kallyai logout        # Clear credentials
kallyai auth-status   # Check login

Step 3: Execute

Natural language (preferred):

kallyai ask "Reserve a table for 4 at 8pm at Nobu"

Direct commands (when you know the domain):

kallyai calls make -p "+15551234567" -t "Reserve table for 4 at 8pm"
kallyai actions calendar create --title "Dinner" --start "2026-02-14T20:00"
kallyai search run "best Italian restaurant downtown"
kallyai inbound calls --status completed
kallyai phone list

Step 4: Monitor & Follow Up

# Check goal status
kallyai coord goals --status active
kallyai coord goal \x3CGOAL_ID>

# Review outbound call results
kallyai calls history
kallyai calls info \x3CCALL_ID>
kallyai calls transcript \x3CCALL_ID>

# Review inbound calls handled by AI receptionist
kallyai inbound calls
kallyai inbound call \x3CCALL_ID>
kallyai inbound transcript \x3CCALL_ID>

# Check inbox for responses
kallyai messages inbox --unread

API Reference

Base URL: https://api.kallyai.com

Authentication: Authorization: Bearer \x3Caccess_token>

Making Calls (API)

POST https://api.kallyai.com/v1/calls
Authorization: Bearer \x3Caccess_token>
Content-Type: application/json

{
  "submission": {
    "task_category": "general",
    "task_description": "Ask about store hours and availability",
    "respondent_phone": "+15551234567",
    "language": "en",
    "call_language": "en"
  },
  "timezone": "America/New_York"
}

Response:

{
  "call_id": "uuid",
  "status": "success",
  "highlights": "They have availability at 8pm",
  "next_steps": "Reservation confirmed"
}

Status values: success, no_answer, busy, failed, voicemail, cancelled

Required fields:

Optional fields:

Domain Command Reference

ask — Natural Language (80% of usage)

kallyai ask "Your request in plain English"

coord — Coordination & Goals

coord message "text"           # Chat with coordination AI
coord goals [--status X]       # List goals
coord goal \x3Cid>                # Goal details
coord goal-tree \x3Cid>           # Goal + sub-goals
coord cancel-goal \x3Cid>         # Cancel goal
coord cascade-cancel \x3Cid>      # Cancel goal + sub-goals
coord escalate \x3Cid>            # Escalate for attention
coord approve-step \x3Cid>        # Approve next step
coord accept \x3Cid>              # Accept outcome
coord continue \x3Cid>            # Continue negotiating
coord archive \x3Cid>             # Archive goal
coord batch-archive \x3Cid>...    # Archive multiple
coord budget \x3Cid>              # Goal budget details
coord history                  # Conversation history
coord conversations            # List conversations
coord new                      # New conversation

calls — Outbound Phone Calls

calls make -p "+1..." -t "task"  # Make a call
calls history                     # List calls
calls info \x3Cid>                   # Call details
calls transcript \x3Cid>             # Transcript
calls recording \x3Cid>              # Recording URL
calls calendar \x3Cid>               # Calendar .ics
calls cancel \x3Cid>                 # Cancel call
calls reschedule \x3Cid>             # Reschedule
calls stop \x3Cid>                   # Stop active call

inbound — AI Receptionist (Incoming Calls)

inbound calls [--status X]          # List incoming calls
inbound call \x3Cid>                    # Call details
inbound transcript \x3Cid>              # Call transcript
inbound recording \x3Cid>               # Call recording
inbound summary                      # Incoming call summary/stats
inbound analytics [--from X --to X]  # Call analytics
inbound transfer \x3Cid> --to "+1..."   # Transfer call
inbound takeover \x3Cid>                # Take over live call
inbound reject \x3Cid> [--reason X]     # Reject call
inbound rules                        # List routing rules
inbound add-rule --name "..." --action "..."  # Create rule
inbound update-rule \x3Cid> ...         # Update rule
inbound delete-rule \x3Cid>             # Delete rule
inbound voicemails                   # List voicemails
inbound voicemail \x3Cid>               # Voicemail details
inbound voicemail-playback \x3Cid>      # Voicemail audio
inbound contacts                     # List contacts
inbound add-contact --name "..." --phone "+1..."  # Add contact
inbound update-contact \x3Cid> ...      # Update contact
inbound delete-contact \x3Cid>          # Delete contact
inbound import-contacts \x3Cfile>       # Import contacts
inbound events [--from X --to X]     # Event log

phone — Phone Number Management

phone list                           # List your numbers
phone info \x3Cid>                      # Number details
phone countries                      # Supported countries
phone available --country US         # Search available numbers
phone provision --country US         # Provision new number
phone forwarding \x3Cid> --target "+1..." # Set call forwarding
phone remove-forwarding \x3Cid>         # Remove forwarding
phone verify-start \x3Cnumber>          # Start verification
phone verify-check \x3Cnumber> --code X # Check verification code
phone caller-id \x3Cid> --name "..."    # Set caller ID
phone release \x3Cid>                   # Release number

actions — Autonomous Actions

actions calendar create --title "..." --start "..."
actions calendar slots [--date X]
actions calendar sync
actions calendar delete \x3Cid>
actions restaurant search "query" [--location X]
actions booking create --type restaurant [--date X]
actions booking cancel \x3Cid>
actions bill analyze "description" [--amount X]
actions bill dispute "description" [--reason X]
actions ride --pickup "..." --destination "..."
actions food "order description" [--address X]
actions errand "errand description"
actions email send --to "..." --subject "..." "body"
actions email approve \x3Cid>
actions email cancel \x3Cid>
actions email outbox
actions email replies \x3Cid>
actions log [--type X]
actions undo \x3Cid>

messages — Unified Inbox

messages inbox [--channel email|sms|call|chat] [--unread]
messages read \x3Cid>
messages thread \x3Cconversation_id>
messages mark-read \x3Cid> [\x3Cid>...]

search — Research

search run "query" [--location X]
search quick "query"
search history
search sources

email — Email Account Management

email accounts                          # List connected
email connect gmail|outlook             # Connect provider
email disconnect \x3Cid>                   # Disconnect
email list [--classification important] # List messages
email read \x3Cid>                         # Read email
email respond \x3Cid> [instructions]       # Respond
email voice-profile                     # Get voice profile
email train-voice                       # Train from samples

channels — Multi-Channel Management

channels status                  # All channel statuses
channels email-add \x3Caddress>     # Add email contact
channels email-list              # List email contacts
channels email-update \x3Cid> ...   # Update email contact
channels email-delete \x3Cid>       # Delete email contact
channels email-verify \x3Ctoken>    # Verify email
channels mailbox                 # Get KallyAI mailbox address
channels connect \x3Cchannel>       # Connect WhatsApp/Telegram
channels test \x3Cchannel>          # Test channel connection
channels disconnect \x3Cchannel>    # Disconnect channel

outreach — Multi-Channel Outreach

outreach tasks [--status X]      # List outreach tasks
outreach task \x3Cid>               # Task details
outreach create --channel call --target "+1..." "description"
outreach retry \x3Cid>              # Retry failed task
outreach cancel \x3Cid>             # Cancel task

budget — Cost Management

budget estimate --type call "description"
budget approve \x3Cgoal_id>
budget breakdown \x3Cgoal_id>
budget ack-cap \x3Cgoal_id>

credits — Balance & Usage

credits balance     # Current balance (credits, NOT minutes)
credits history     # Usage history
credits breakdown   # Spending breakdown by action type
credits costs       # Credit cost reference
credits plans       # Available credit plans

subscription — Plan Management

subscription status               # Current plan status
subscription change-plan \x3Cplan>   # Change to new plan
subscription cancel-change        # Cancel pending plan change

referrals — Referral Program

referrals code        # Get your referral code
referrals stats       # Referral statistics
referrals history     # Referral history

notifications — Notifications

notifications pending   # Check pending notification counts

Common Errors

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