pai

Unix-style CLI for interacting with LLMs. One built-in tool (bash_exec), basic session support, and text embedding.

Note: pai is a thin wrapper around @mariozechner/pi-ai (https://github.com/badlogic/pi-mono/tree/main/packages/ai). Thanks to Mario Zechner for providing this amazing work.

Features

• 20+ providers (OpenAI, Anthropic, Google, GitHub Copilot, Azure, Bedrock, etc.)
• API Key, OAuth, and cloud credential authentication
• Streaming and non-streaming output
• Session files (JSONL) for multi-turn conversations
• bash_exec tool — LLM can run shell commands
• embed command — generate text embeddings
• Human-readable (default) and machine-parseable (--json) output

Install

From npm

npm install -g @theclawlab/pai

From source

npm install
npm run build
npm link

Quick Start

# Configure a provider
pai model config --add --name openai --provider openai --set apiKey=sk-...

# Set as default
pai model default --name openai

# Chat
pai chat "Hello"

# Generate embeddings
pai model default --embed-provider openai --embed-model text-embedding-3-small
pai embed "hello world" --json

Commands

| Command | Description | |---------|-------------| | pai chat [prompt] | Chat with an LLM (supports tool calling, streaming, sessions) | | pai embed [text] | Generate text embeddings (single or batch) | | pai model list | List configured/available providers | | pai model config | Add, update, delete, or show provider configuration | | pai model default | View or set default provider and embedding model | | pai model login | Interactive OAuth login for supported providers |

Documentation

• USAGE.md — Full usage guide with all providers, options, and examples