ThunderPhone CLI

टर्मिनलवरून लॉग इन करा, व्हॉइस एजंट आणि कॉल व्यवस्थापित करा, MCP क्लायंट कॉन्फिगर करा आणि प्रोजेक्टचा आराखडा तयार करा.

CLI साठी Node.js 18.18 किंवा नंतरची आवृत्ती आवश्यक आहे. ते npx सह चालवा किंवा ग्लोबली इंस्टॉल करा:

npm install -g thunderphone
thunderphone --help

लॉग इन करा#

npx thunderphone login
thunderphone whoami --json

लॉग इन केल्यावर पडताळणी कोड प्रदर्शित होतो, ब्राउझर उघडतो आणि अधिकृततेची प्रतीक्षा करतो. हेडलेस मशीनवर --no-browser वापरा आणि प्रदर्शित केलेली URL इतरत्र उघडा. डिव्हाइस लॉग इनसाठी API च्या OAuth डिव्हाइस-फ्लो रोलआउटची आवश्यकता असते. संस्थेची API की THUNDERPHONE_API_KEY मध्ये असल्यास ती कमांडना प्रमाणीकरणासाठी वापरता येते आणि संग्रहित लॉग इन क्रेडेन्शियल्सपेक्षा तिला प्राधान्य दिले जाते.

क्रेडेन्शियल्स प्रोफाइलनुसार ~/.config/thunderphone/credentials.json मध्ये 0600 फाइल मोडसह संग्रहित केली जातात. XDG_CONFIG_HOME आणि THUNDERPHONE_CONFIG_DIR हे डिरेक्टरी ओव्हरराइड करतात. ॲक्सेस टोकन आपोआप रीफ्रेश होतात आणि रोटेट होणारी रीफ्रेश टोकन अण्विक पद्धतीने जतन केली जातात. लॉग इनद्वारे टोकन कधीही प्रदर्शित केली जात नाहीत.

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

THUNDERPHONE_PROFILE डीफॉल्ट प्रोफाइल सेट करते. लॉग आउट केल्याने स्थानिक क्रेडेन्शियल्स काढून टाकली जातात; त्यामुळे सर्व्हर ग्रँट रद्द होत नाही. डीफॉल्ट API https://api.thunderphone.com आहे. इतर API साठी --api-base-url किंवा THUNDERPHONE_API_BASE_URL वापरा. प्रोफाइलचे टोकन वेगळ्या कॉन्फिगर केलेल्या API URL ला पाठवता येत नाही; त्या URL मध्ये स्वतंत्र प्रोफाइलसह लॉग इन करा.

कमांड्स#

प्रत्येक कमांड --json स्वीकारते. यशस्वी डेटा stdout वर जातो; त्रुटी stderr वर शून्येतर एक्झिट कोडसह जातात. --json शिवाय, आउटपुट संक्षिप्त टेबल किंवा फील्ड सूची असते. क्रेडेन्शियल फील्ड्स लपवून JSON API प्रतिसादाची रचना कायम ठेवते. MCP सर्व्हिंगमध्ये stdout MCP प्रोटोकॉलसाठी राखीव असते.

आउटबाउंड कॉलसाठी कनेक्ट केलेला कॅरियर नंबर आवश्यक आहे. THUNDERPHONE_FROM_NUMBER --from पुरवू शकते. ThunderPhone-प्रोव्हिजन केलेले नंबर केवळ इनबाउंडसाठी असतात. --wait ची डीफॉल्ट कालमर्यादा एक तास आहे; ती बदलण्यासाठी --timeout SECONDS सेट करा. कालमर्यादा संपल्यावर प्रतीक्षा थांबते, पण कॉल संपत नाही.

इंपोर्ट vapi, retell, elevenlabs, आणि bland ला समर्थन देतात. दुसरा आर्ग्युमेंट हा विक्रेत्याच्या JSON एक्सपोर्टचा पथ असतो, रिमोट विक्रेता ID नसतो. API मॅपिंग असिंक्रोनस पद्धतीने तयार करते; ते imports get UUID सह तपासा आणि ते तयार झाल्यावरच तसेच मॅप केलेल्या फील्ड्स व चेतावण्यांचे पुनरावलोकन केल्यानंतरच कमिट करा. एजंट इंपोर्ट्स पहा.

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

क्लायंट: claude-code, codex, cursor, vscode, gemini, claude-desktop, आणि windsurf. प्रोजेक्ट स्कोप हा डीफॉल्ट आहे. Desktop आणि Windsurf साठी युजर स्कोप आवश्यक आहे. प्रोजेक्टमधून एकच क्लायंट शोधण्यासाठी --client वगळा; संदिग्ध शोध असल्यास परस्परसंवादीपणे विचारले जाते किंवा गैर-परस्परसंवादी सत्रात सूचनांसह अयशस्वी होते. सेटअपने लिहिलेली फाइल दर्शवते आणि असंबंधित सर्व्हर जतन करते. विद्यमान JSON वैध कठोर JSON असणे आवश्यक आहे; Codex TOML मूल्ये जतन केली जातात, परंतु टिप्पण्या पुन्हा स्वरूपित होऊ शकतात.

सेटअप थेट रिमोट HTTP ला प्राधान्य देते. --api-key-env सह, ते की कधीही न लिहिता व्हेरिएबल संदर्भ लिहिते. त्या पर्यायाशिवाय, थेट HTTP क्लायंटच्या OAuth समर्थनावर अवलंबून असते; ते CLI क्रेडेन्शियल फाइल वापरत नाही. कोणत्याही stdio-सक्षम क्लायंटमध्ये thunderphone login क्रेडेन्शियल्स पुन्हा वापरण्यासाठी, हे वापरा:

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

रॅपर आधी THUNDERPHONE_API_KEY, नंतर सध्याची CLI प्रोफाइल तपासतो (आवश्यकतेनुसार रिफ्रेश करून), आणि नंतर OAuth mcp-remote कडे सोपवतो. THUNDERPHONE_MCP_URL एंडपॉइंट ओव्हरराइड करते. ते कोणतेही टेलिमेट्री पाठवत नाही. स्वतंत्र सेटअप npx -y @thunderphone/mcp setup --client cursor किंवा जागतिक स्तरावर @thunderphone/mcp स्थापित केल्यानंतर thunderphone-mcp setup द्वारेही उपलब्ध आहे.

प्रोजेक्ट तयार करा#

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

टेम्पलेट्स node आणि python आहेत; एजंट प्रकार receptionist, outbound, आणि custom आहेत. डीफॉल्ट एजंट हा स्पष्ट डेमो माहितीसह इंग्रजी/स्पॅनिश दंत रिसेप्शनिस्ट आहे. प्रोजेक्टमध्ये agent.json, डिप्लॉय स्क्रिप्ट्स, Claude Code, Cursor आणि VS Code साठी MCP कॉन्फिगरेशन्स, एजंट सूचना, .env.example, आणि README समाविष्ट असते. स्कॅफोल्डिंग ऑफलाइन आहे आणि रिकामे नसलेले डायरेक्टरी ओव्हरराइट करण्यास नकार देते.

डिप्लॉय करण्यापूर्वी व्यवसायाची माहिती संपादित करा. जनरेट केलेल्या README मध्ये दस्तऐवजीकरण केल्याप्रमाणे API की, जोडलेला कॉलर नंबर आणि तुमचा चाचणी प्राप्तकर्ता एक्सपोर्ट करा. npm run deploy किंवा python deploy.py एजंट तयार किंवा अपडेट करते, त्याचा ड्राफ्ट डिप्लॉय करते, आणि शुल्क आकारला जाणारा चाचणी कॉल करते. स्क्रिप्ट्स API-की प्रमाणीकरण वापरतात; CLI आणि stdio MCP रॅपर डिव्हाइस लॉगिनलाही समर्थन देतात. Python स्क्रिप्ट्ससाठी Python 3.9 किंवा त्यानंतरची आवृत्ती आवश्यक आहे.