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 ડિવાઇસ-ફ્લો રોલઆઉટ જરૂરી છે. THUNDERPHONE_API_KEY માંની સંસ્થા API કી પણ કમાન્ડ્સને પ્રમાણિત કરી શકે છે અને સંગ્રહિત લૉગ ઇન ઓળખપત્રો કરતાં અગ્રતા ધરાવે છે.

ઓળખપત્રો પ્રોફાઇલ અનુસાર ~/.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. પ્રોજેક્ટ સ્કોપ ડિફૉલ્ટ છે. ડેસ્કટોપ અને 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 અથવા તે પછીનું સંસ્કરણ જરૂરી છે.