> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nixflex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI quickstart

> An agent, a call and a caller record in two minutes

You need an API key from the dashboard, a phone number already imported, and Node.js 18+.

<Steps>
  <Step title="Log in">
    ```bash theme={null}
    npx nixflex login
    ```

    Paste the full key (`nxf_xxx:nxfs_xxx`). The CLI verifies it against the API before saving.
  </Step>

  <Step title="See what you have">
    ```bash theme={null}
    nixflex agents list
    nixflex numbers list
    ```
  </Step>

  <Step title="Create an agent">
    Write the prompt in a file - it is easier to edit and to keep in git.

    ```bash theme={null}
    nixflex agents create --name "Reception" --prompt @reception-prompt.txt --voice Ashley
    ```

    The response includes the new `agent_id`.
  </Step>

  <Step title="Tell the agent who is calling">
    Load what you already know about a customer, so the agent uses it instead of asking. See [Caller context](/concepts/caller-context).

    ```bash theme={null}
    nixflex callers set +447450307843 +447453573770 --name "Sam Carter" --email sam.carter@example.com
    ```

    The first number is yours, the second is the customer's.
  </Step>

  <Step title="Place a call">
    ```bash theme={null}
    nixflex calls create --agent agent_15d1a9ee16294087 --to +447453573770 --prompt "Call Sam to confirm his appointment on Tuesday at 11."
    ```

    Then follow it:

    ```bash theme={null}
    nixflex calls get call_xxx
    ```
  </Step>
</Steps>

## Everything as JSON

Add `--json` to any command for scripting:

```bash theme={null}
nixflex calls list --limit 5 --json
```

## Load a customer list

One CSV, one number, up to 1,000 rows per request (the CLI splits larger files for you):

```csv theme={null}
caller_number,name,email,location,reference_id,preference
+447453573770,Sam Carter,sam.carter@example.com,London SW1A 1AA,4827,prefers morning appointments
+447700900002,Priya Shah,priya.shah@example.com,,,prefers afternoon appointments
```

```bash theme={null}
nixflex callers import +447450307843 ./customers.csv
```

Next: the full [command reference](/cli/commands).