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

Command	Description
pine auth login	Log in with email verification
pine auth status	Show current auth status
pine auth logout	Clear saved credentials

Voice Calls

Command	Description
pine voice call	Make a phone call via Pine AI voice agent
pine voice status <id>	Check call status / get result

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

Command	Description
pine chat [session-id]	Interactive REPL chat (picks or creates session)
pine send -s <id> <message>	Send message and wait for response
pine send --new <message>	Create session + send
pine send ... --no-wait	Fire-and-forget (for scripts/agents)
pine sessions list	List sessions
pine sessions get <id>	Get session details + conversation history
pine sessions create	Create new session
pine sessions delete <id>	Delete session
pine task start <id>	Start task execution
pine task stop <id>	Stop a running task

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.