pine-voice

# Pine Voice

Make real phone calls via Pine AI's voice agent. The agent calls the specified number, navigates IVR systems, handles verification, conducts negotiations, and returns a full transcript.

## Authentication

Credentials persist in `~/.pine-voice/credentials.json` — users only need to authenticate once.

Before making calls, check if already authenticated:

```bash
node {baseDir}/scripts/auth-check.mjs
```

If `authenticated` is `true`, skip straight to **How to make a call**. If `false`, run the auth flow below. **Ask the user for their Pine AI account email** (sign up at https://19pine.ai).

### Step 1: Request verification code

```bash
node {baseDir}/scripts/auth-request.mjs "user@example.com"
```

Returns `{"request_token": "...", "email": "..."}`. Save the `request_token`.

Tell the user: *"A verification code has been sent to your email. Check your inbox (and spam) and give me the code."*

### Step 2: Verify and save credentials

```bash
node {baseDir}/scripts/auth-verify.mjs "user@example.com" "REQUEST_TOKEN" "CODE"
```

Returns `{"status": "authenticated", "credentials_path": "..."}`. Credentials are saved automatically.

## When to use

Use this skill when the user wants you to **make a phone call** on their behalf.

**Important:** The voice agent can only speak English. Supported countries: US/CA/PR (+1), UK (+44), AU (+61), NZ (+64), SG (+65), IE (+353), HK (+852).

## Best for

- Calling customer service to negotiate bills, request credits, or resolve issues
- Scheduling meetings or appointments by phone
- Making restaurant reservations
- Calling businesses to inquire about services or availability
- Following up with contacts on behalf of the user

## How to make a call

### Step 1: Gather all required information

Before calling, you **must** collect every piece of information the callee might need. The voice agent **cannot ask a human for missing information during the call**. Anticipate what will be required: authentication details, payme...