Pine CLI

Unified command-line interface for Pine AI — voice calls and assistant tasks from your terminal.

Install

pip install pineai-cli

Or install from source:

cd pine-cli
pip install -e .

Quick Start

# Authenticate (shared credentials for voice & assistant)
pine auth login

# Make a voice call
pine voice call \
  --to "+14155551234" \
  --name "Dr. Smith Office" \
  --context "I'm a patient needing a follow-up" \
  --objective "Schedule an appointment for next week"

# Check call status
pine voice status <call-id>

# Start an assistant chat (pick or create session interactively)
pine chat

# Resume a specific session
pine chat <session-id>

# Send a message to an existing session (waits for response)
pine send -s <session-id> "Negotiate my Comcast bill down"

# Fire-and-forget (for scripts/agents — returns immediately)
pine send -s <session-id> "Negotiate my Comcast bill down" --no-wait --json

# Create a new session and send in one step
pine send --new "Negotiate my Comcast bill down" --no-wait --json

# List sessions
pine sessions list

# Start a task
pine task start <session-id>

Commands

Authentication

Voice Calls

Voice call options:

--to           Phone number (E.164 format, required)
--name         Callee name (required)
--context      Background context (required)
--objective    Call goal (required)
--instructions Detailed strategy
--caller       negotiator | communicator
--voice        male | female
--max-duration 1-120 minutes
--summary      Enable LLM summary
--wait         Wait for completion (default: yes)
--no-wait      Fire and forget
--json         JSON output

Assistant

Configuration

Credentials are stored at ~/.pine/config.json after pine auth login. Both voice and assistant commands share the same authentication.

Dependencies

• pine-voice — Pine AI Voice SDK
• pine-assistant — Pine AI Assistant SDK
• click — CLI framework
• rich — Terminal formatting

License

MIT — see LICENSE.