--- name: kallyai description: "KallyAI Executive Assistant — AI that handles phone calls (outbound + inbound), email, bookings, research, errands, multi-channel messaging, and phone number management on your behalf. Use when users want to: make/receive calls, manage inbound rules, handle voicemails, provision phone numbers, send email, book restaurants/hotels, search for services, manage calendar, check inbox/messages, handle bills, order food/rides, run errands, check credits/budget, coordinate goals, manage channels (WhatsApp/Telegram/social), run outreach campaigns, referrals, or any delegation task." metadata: {"clawdbot":{"emoji":"📞","requires":{"bins":["kallyai"]},"install":[{"id":"pip","kind":"pip","package":"kallyai-cli","bins":["kallyai"],"label":"Install via pip"}]}} ---

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:

| Domain | Examples | |--------|----------| | Coordination | "Book a table", "Handle this for me", any multi-step request | | Calls | Call a business, check on a reservation, negotiate | | Inbound | View incoming calls, manage routing rules, voicemails, contacts | | Phone | Provision numbers, set up forwarding, manage caller ID | | Actions | Calendar events, bookings, bill analysis, rides, food, errands | | Messages | Check inbox, read messages, view threads | | Search | Find businesses, research options, compare prices | | Email | Send emails, manage accounts, train voice profile | | Channels | Manage WhatsApp, Telegram, email contacts, channel status | | Outreach | Multi-channel outreach tasks (call + email + messaging) | | Budget | Estimate costs, approve budgets, view breakdowns | | Credits | Check balance, view history, spending breakdown, plans | | Subscription | Change plan, view status, cancel pending changes | | Referrals | Get referral code, view stats, track referrals |

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 <GOAL_ID>

# Review outbound call results
kallyai calls history
kallyai calls info <CALL_ID>
kallyai calls transcript <CALL_ID>

# Review inbound calls handled by AI receptionist
kallyai inbound calls
kallyai inbound call <CALL_ID>
kallyai inbound transcript <CALL_ID>

# Check inbox for responses
kallyai messages inbox --unread

---

API Reference

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

Authentication: Authorization: Bearer

Making Calls (API)

POST https://api.kallyai.com/v1/calls
Authorization: Bearer <access_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:

| Field | Description | |-------|-------------| | task_category | restaurant, clinic, hotel, general | | task_description | What AI should accomplish | | respondent_phone | Phone number in E.164 format (+1234567890) |

Optional fields:

| Field | Description | |-------|-------------| | business_name | Name of business | | user_name | Name for reservation | | appointment_date | YYYY-MM-DD | | appointment_time | HH:MM (24-hour) | | party_size | Number of people (1-50) | | language | en or es |

---

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 <id>                # Goal details
coord goal-tree <id>           # Goal + sub-goals
coord cancel-goal <id>         # Cancel goal
coord cascade-cancel <id>      # Cancel goal + sub-goals
coord escalate <id>            # Escalate for attention
coord approve-step <id>        # Approve next step
coord accept <id>              # Accept outcome
coord continue <id>            # Continue negotiating
coord archive <id>             # Archive goal
coord batch-archive <id>...    # Archive multiple
coord budget <id>              # 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 <id>                   # Call details
calls transcript <id>             # Transcript
calls recording <id>              # Recording URL
calls calendar <id>               # Calendar .ics
calls cancel <id>                 # Cancel call
calls reschedule <id>             # Reschedule
calls stop <id>                   # Stop active call

inbound — AI Receptionist (Incoming Calls)

...