ThunderPhone CLI

Prihláste sa, spravujte hlasových agentov a hovory, konfigurujte klientov MCP a vytvárajte kostry projektov z terminálu.

CLI vyžaduje Node.js 18.18 alebo novší. Spustite ho pomocou npx alebo ho nainštalujte globálne:

npm install -g thunderphone
thunderphone --help

Prihlásenie#

npx thunderphone login
thunderphone whoami --json

Prihlásenie vytlačí overovací kód, otvorí prehliadač a čaká na autorizáciu. Na zariadení bez grafického rozhrania použite --no-browser a vytlačenú URL otvorte inde. Prihlásenie zariadenia vyžaduje nasadenie OAuth toku zariadenia API. Príkazy môže autentifikovať aj kľúč API organizácie v THUNDERPHONE_API_KEY, ktorý má prednosť pred uloženými prihlasovacími údajmi.

Prihlasovacie údaje sa ukladajú podľa profilov do ~/.config/thunderphone/credentials.json s režimom súboru 0600. Premenné XDG_CONFIG_HOME a THUNDERPHONE_CONFIG_DIR nahrádzajú adresár. Prístupové tokeny sa obnovujú automaticky a rotujúce obnovovacie tokeny sa ukladajú atómovo. Prihlásenie nikdy nevytlačí tokeny.

thunderphone login --profile work
thunderphone agents list --profile work --json
thunderphone logout --profile work

THUNDERPHONE_PROFILE nastavuje predvolený profil. Odhlásenie odstráni miestne prihlasovacie údaje; nezruší oprávnenie na serveri. Predvolené API je https://api.thunderphone.com. Pre iné API použite --api-base-url alebo THUNDERPHONE_API_BASE_URL. Token profilu nemožno odoslať na inú nakonfigurovanú URL API; do tejto URL sa prihláste pomocou samostatného profilu.

Príkazy#

Každý príkaz prijíma --json. Úspešné údaje sa odosielajú na stdout; chyby na stderr s nenulovým návratovým kódom. Bez --json je výstup kompaktná tabuľka alebo zoznam polí. JSON zachováva štruktúru odpovede API s redigovanými poľami prihlasovacích údajov. Obsluha MCP vyhradzuje stdout pre protokol MCP.

Odchádzajúce hovory vyžadujú číslo pripojeného poskytovateľa. THUNDERPHONE_FROM_NUMBER môže poskytnúť --from. Čísla zriadené službou ThunderPhone sú len pre prichádzajúce hovory. Predvolená hodnota --wait je časový limit jedna hodina; na jeho zmenu nastavte --timeout SECONDS. Časový limit prestane čakať bez ukončenia hovoru.

Importy podporujú vapi, retell, elevenlabs a bland. Druhý argument je cesta k exportu JSON dodávateľa, nie vzdialené ID dodávateľa. API pripravuje mapovanie asynchrónne; skontrolujte ho pomocou imports get UUID a potvrďte ho až po jeho pripravení a po kontrole namapovaných polí a upozornení. Pozrite si importy agentov.

Nastavenie MCP#

thunderphone mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
thunderphone mcp setup --client codex --scope user --api-key-env THUNDERPHONE_API_KEY
thunderphone mcp setup --client claude-desktop --scope user

Klienti: claude-code, codex, cursor, vscode, gemini, claude-desktop a windsurf. Predvolené je nastavenie na úrovni projektu. Desktop a Windsurf vyžadujú rozsah používateľa. Vynechajte --client, ak chcete z projektu zistiť jedného klienta; pri nejednoznačnej detekcii sa zobrazí interaktívna výzva alebo relácia bez interakcie zlyhá s pokynmi. Nastavenie vypíše súbor, ktorý zapísalo, a zachová nesúvisiace servery. Existujúci JSON musí byť platný striktne podľa JSON; hodnoty TOML pre Codex sa zachovajú, ale komentáre môžu byť preformátované.

Nastavenie uprednostňuje priame vzdialené HTTP. S --api-key-env zapíše odkaz na premennú, nikdy nie kľúč. Bez tejto možnosti sa priame HTTP spolieha na podporu OAuth klienta; nepoužíva súbor poverení CLI. Ak chcete znova použiť poverenia z thunderphone login v ľubovoľnom klientovi podporujúcom stdio, použite:

{
  "mcpServers": {
    "thunderphone": {
      "command": "npx",
      "args": ["-y", "@thunderphone/mcp"]
    }
  }
}

Obálka kontroluje THUNDERPHONE_API_KEY, potom aktuálny profil CLI (v prípade potreby ho obnoví) a následne deleguje OAuth na mcp-remote. THUNDERPHONE_MCP_URL prepíše koncový bod. Neodosiela žiadnu telemetriu. Samostatné nastavenie je dostupné aj cez npx -y @thunderphone/mcp setup --client cursor alebo thunderphone-mcp setup po globálnej inštalácii @thunderphone/mcp.

Vytvorenie projektu#

npx create-thunderphone-agent my-receptionist
npx create-thunderphone-agent my-outbound --template python --agent-type outbound
# Equivalent:
thunderphone init my-receptionist --template node --agent-type receptionist

Šablóny sú node a python; typy agentov sú receptionist, outbound a custom. Predvolený agent je anglicko-španielsky zubný recepčný s explicitnými ukážkovými údajmi. Projekty obsahujú agent.json, skripty na nasadenie, konfigurácie MCP pre Claude Code, Cursor a VS Code, pokyny pre agenta, .env.example a README. Generovanie kostry funguje offline a odmietne prepísať neprázdny adresár.

Pred nasadením upravte obchodné údaje. Exportujte kľúč API, pripojené číslo volajúceho a príjemcu testu podľa pokynov vo vygenerovanom README. npm run deploy alebo python deploy.py vytvorí alebo aktualizuje agenta, nasadí jeho koncept a uskutoční spoplatnený testovací hovor. Skripty používajú autentifikáciu pomocou kľúča API; CLI a stdio MCP obálka podporujú aj prihlásenie zariadenia. Skripty v Pythone vyžadujú Python 3.9 alebo novší.