---
title: "ThunderPhone CLI"
description: "ટર્મિનલમાંથી લૉગ ઇન કરો, વૉઇસ એજન્ટ અને કૉલ્સ મેનેજ કરો, MCP ક્લાયન્ટ્સ કૉન્ફિગર કરો અને પ્રોજેક્ટ્સનું સ્કેફોલ્ડિંગ કરો."
---

CLI માટે Node.js 18.18 અથવા પછીનું વર્ઝન જરૂરી છે. તેને `npx` સાથે ચલાવો અથવા વૈશ્વિક રીતે ઇન્સ્ટોલ કરો:

```bash
npm install -g thunderphone
thunderphone --help
```

## લૉગ ઇન કરો

```bash
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` ડિરેક્ટરીને ઓવરરાઇડ કરે છે.
ઍક્સેસ ટોકન આપમેળે રિફ્રેશ થાય છે અને બદલાતા રિફ્રેશ ટોકન પરમાણુરૂપે સંગ્રહિત થાય છે.
લૉગ ઇન ક્યારેય ટોકન પ્રિન્ટ કરતું નથી.

```bash
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 પ્રોટોકોલ માટે આરક્ષિત રાખે છે.

| કમાન્ડ | હેતુ |
| --- | --- |
| `login [--no-browser] [--scope "scopes"]` | ડિવાઇસ કોડ દ્વારા અધિકૃત કરો |
| `logout`, `whoami` | સ્થાનિક ઓળખપત્રો દૂર કરો; ઍક્સેસ કરી શકાય તેવી સંસ્થાઓની સૂચિ બતાવો |
| `agents list`, `agents get ID` | એજન્ટ વાંચો |
| `agents create --file agent.json` | એજન્ટ બનાવો |
| `agents update ID --file agent.json` | એજન્ટ ડ્રાફ્ટ સાચવો |
| `agents deploy ID`, `agents delete ID` | ડ્રાફ્ટ ડિપ્લોય કરો; એજન્ટ કાઢી નાખો |
| `numbers list` | ફોન નંબરો વાંચો |
| `numbers provision --country US --area-code 415` | US ઇનબાઉન્ડ નંબર પ્રોવિઝન કરો |
| `numbers assign NUMBER_ID --agent ID` | ઇનબાઉન્ડ એજન્ટ અસાઇન કરો |
| `call TO --agent ID --from FROM [--wait]` | આઉટબાઉન્ડ કૉલ કરો; વૈકલ્પિક રીતે તેના ટ્રાન્સક્રિપ્ટની રાહ જુઓ |
| `calls list [--limit N] [--agent ID]` | કૉલની સૂચિ બતાવો (મર્યાદા 1–200) |
| `calls get ID`, `calls transcript ID` | એક કૉલ અથવા તેનો ટ્રાન્સક્રિપ્ટ વાંચો |
| `test run AGENT_ID [--scenario ID] --consent-to-charge` | વેબ ચૅનલનો ઉપયોગ કરીને બિલપાત્ર સંગ્રહિત દૃશ્યો ચલાવો |
| `test status RUN_ID [--agent ID]` | બૅચ તપાસો; એજન્ટ આપેલો હોય ત્યારે દૃશ્ય વિગતો સાથે |
| `import VENDOR export.json` | સમીક્ષા માટે વિક્રેતા JSON ઇમ્પોર્ટ તૈયાર કરો |
| `imports get UUID`, `imports commit UUID` | ઇમ્પોર્ટ તપાસો; સમીક્ષા પછી પસંદ કરેલા એજન્ટ કમિટ કરો |
| `mcp setup`, `mcp serve` | ક્લાયન્ટ કન્ફિગર કરો; stdio બ્રિજ શરૂ કરો |
| `init [directory]` | પ્રોજેક્ટનું માળખું બનાવો |

આઉટબાઉન્ડ કૉલ માટે જોડાયેલ કેરિયર નંબર જરૂરી છે. `THUNDERPHONE_FROM_NUMBER`
`--from` આપી શકે છે. ThunderPhone દ્વારા પ્રોવિઝન કરાયેલા નંબરો માત્ર ઇનબાઉન્ડ માટે છે. `--wait` નું ડિફૉલ્ટ
એક કલાકનો ટાઇમઆઉટ છે; તેને બદલવા માટે `--timeout SECONDS` સેટ કરો. ટાઇમઆઉટ કૉલ સમાપ્ત કર્યા વિના
રાહ જોવાનું બંધ કરે છે.

ઇમ્પોર્ટ `vapi`, `retell`, `elevenlabs`, અને `bland` ને સપોર્ટ કરે છે. બીજો આર્ગ્યુમેન્ટ
વિક્રેતા JSON એક્સપોર્ટનો પાથ છે, રિમોટ વિક્રેતા ID નથી. API અસુમેળ રીતે મેપિંગ તૈયાર કરે છે;
`imports get UUID` વડે તેને તપાસો અને તે તૈયાર થાય તથા તમે મેપ કરેલા ફીલ્ડ અને ચેતવણીઓની સમીક્ષા કરો
તે પછી જ કમિટ કરો. [એજન્ટ ઇમ્પોર્ટ્સ](/gu/guides/import-agents) જુઓ.

## MCP સેટઅપ

```bash
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` ક્રેડેન્શિયલ્સનો ફરીથી ઉપયોગ કરવા માટે, આનો ઉપયોગ કરો:

```json
{
  "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` દ્વારા પણ ઉપલબ્ધ છે.

## પ્રોજેક્ટ બનાવો

```bash
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 અથવા તે પછીનું સંસ્કરણ જરૂરી છે.