@skillhq/concierge

Concierge

Personal AI concierge for contact lookup, availability checks, and autonomous phone calls.

Installation

skill install @skillhq/concierge

Features

• Contact Extraction: Find phone, email, WhatsApp, and social media contacts from listings and businesses (Airbnb, Booking.com, VRBO, Expedia)
• AI Phone Calls: Place autonomous phone calls with a goal-driven AI agent that handles the conversation until the goal is achieved

System Dependencies (AI Calls)

AI calls require local binaries in addition to API keys:

• ffmpeg (must include MP3 decode support)
• ngrok (used when call auto-starts infrastructure)

Install examples:

# macOS
brew install ffmpeg ngrok

# Ubuntu/Debian (including ARM VPS)
sudo apt-get update
sudo apt-get install -y ffmpeg
# install ngrok from ngrok docs, then verify `ngrok version`

Verify locally:

ffmpeg -version
ffmpeg -decoders | rg -i mp3
ngrok version

The call preflight now fails fast with a clear error if these dependencies are missing or if ffmpeg cannot decode MP3.

Quick Start

Find contacts for a listing

concierge find-contact "https://www.airbnb.com/rooms/12345"

Place an AI booking call

concierge call "[phone]" \
  --goal "Book a room for March 12-14" \
  --name "John Smith" \
  --email "[e-mail]" \
  --customer-phone "[phone]"

Configuration

Configuration is stored in ~/.config/concierge/config.json5.

For contact lookup (optional)

concierge config set googlePlacesApiKey "your-key"

For AI phone calls (required)

concierge config set twilioAccountSid "<sid>"
concierge config set twilioAuthToken "<token>"
concierge config set twilioPhoneNumber "[phone]"
concierge config set deepgramApiKey "<key>"
concierge config set elevenLabsApiKey "<key>"
concierge config set elevenLabsVoiceId "EXAVITQu4vr4xnSDxMaL"
concierge config set anthropicApiKey "<key>"

Documentation

See SKILL.md and CALL-SETUP.md for full setup and troubleshooting.

License

MIT