pig - AI coding assistant with read, bash, edit, write tools Usage: pig [options] [--] [@files...] [messages...] Commands: pig install [-l] Install extension source and add to settings pig remove [-l] Remove extension source from settings pig uninstall [-l] Alias for remove pig update [source|self] Update pig, extensions, or model catalogs pig list List installed extensions from settings pig config [-l] Open TUI to enable/disable package resources (Tab switches scope) pig auth Print credentials or check provider readiness pig mcp Check MCP servers, sign in to or out of OAuth servers pig --help Show help for install/remove/uninstall/update/list/config/auth/mcp Options: --provider Provider to search for --model (requires --model) --model Model pattern or ID (supports "provider/id" and optional ":") --api-key API key (defaults to env vars) --system-prompt System prompt (default: coding assistant prompt) --append-system-prompt Append text or file contents to the system prompt (can be used multiple times) --mode Output mode: text (default), json, or rpc --print, -p Non-interactive mode: process prompt and exit --continue, -c Continue previous session --resume, -r Select a session to resume --session Use specific session file or partial UUID --session-id Use exact project session ID, creating it if missing --fork Fork specific session file or partial UUID into a new session --session-dir Directory for session storage and lookup --no-session Don't save session (ephemeral) --name, -n Set session display name --models Comma-separated model patterns for Ctrl+P cycling Supports globs (anthropic/*, *sonnet*) and fuzzy matching --no-tools, -nt Disable all tools by default (built-in and extension) --no-builtin-tools, -nbt Disable built-in tools by default but keep extension/custom tools enabled --tools, -t Comma-separated allowlist of tool names to enable Applies to built-in, extension, and custom tools --exclude-tools, -xt Comma-separated denylist of tool names to disable Applies to built-in, extension, and custom tools --thinking Set thinking level: off, minimal, low, medium, high, xhigh, max --extension, -e Load an extension file or builtin: (can be used multiple times) --no-extensions, -ne Disable extension discovery and built-in extensions (explicit -e paths still work) --skill Load a skill file or directory (can be used multiple times) --no-skills, -ns Disable skills discovery and loading --prompt-template Load a prompt template file or directory (can be used multiple times) --no-prompt-templates, -np Disable prompt template discovery and loading --theme Load a theme file or directory (can be used multiple times) --use-theme Set the initial interactive theme for this run --no-themes Disable theme discovery and loading --no-context-files, -nc Disable AGENTS.md and CLAUDE.md discovery and loading --export Export session file to HTML and exit --list-models [search] List available models (with optional fuzzy search) --verbose Force verbose startup (overrides quietStartup setting) --tui-mode TUI mode: fullscreen (default) or regular --approve, -a Trust project-local files for this run --no-approve, -na Ignore project-local files for this run --offline Disable startup network operations (same as PI_OFFLINE=1) -- End option parsing; treat remaining arguments as messages/files --help, -h Show this help --version, -v Show version number Extensions can register additional flags (e.g., --plan from plan-mode extension). Examples: # Print a provider API key for an external client pig auth print-api-key --provider openai # Print an OAuth bearer token for an external client (refreshes if expired) pig auth print-bearer-token --provider openai-codex # Interactive mode pig # Interactive mode with initial prompt pig "List all .ts files in src/" # Include files in initial message pig @prompt.md @image.png "What color is the sky?" # Non-interactive mode (process and exit) pig -p "List all .ts files in src/" # Prompt beginning with a dash pig -p -- "- Summarize these points" # Multiple messages (interactive) pig "Read package.json" "What dependencies do we have?" # Continue previous session pig --continue "What did we discuss?" # Start a named session pig --name "Refactor auth module" # Use different model pig --provider openai --model gpt-4o-mini "Help me refactor this code" # Use model with provider prefix (no --provider needed) pig --model openai/gpt-4o "Help me refactor this code" # Use model with thinking level shorthand pig --model sonnet:high "Solve this complex problem" # Limit model cycling to specific models pig --models claude-sonnet,claude-haiku,gpt-4o # Limit to a specific provider with glob pattern pig --models "github-copilot/*" # Cycle models with fixed thinking levels pig --models sonnet:high,haiku:low # Start with a specific thinking level pig --thinking high "Solve this complex problem" # Read-only mode (no file modifications possible) pig --tools read,grep,find,ls -p "Review the code in src/" # Disable one tool while keeping the rest available pig --exclude-tools ask_question # Export a session file to HTML pig --export ~/.pig/agent/sessions/--path--/session.jsonl pig --export session.jsonl output.html Environment Variables: ANTHROPIC_AUTH_TOKEN - Anthropic bearer auth token ANTHROPIC_API_KEY - Anthropic Claude API key ANTHROPIC_OAUTH_TOKEN - Anthropic OAuth token (alternative to API key) ANT_LING_API_KEY - Ant Ling API key OPENAI_API_KEY - OpenAI GPT API key AZURE_OPENAI_API_KEY - Azure OpenAI API key AZURE_OPENAI_BASE_URL - Azure OpenAI/Cognitive Services base URL (e.g. https://{resource}.openai.azure.com) AZURE_OPENAI_RESOURCE_NAME - Azure OpenAI resource name (alternative to base URL) AZURE_OPENAI_API_VERSION - Azure OpenAI API version (default: v1) AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated) DEEPSEEK_API_KEY - DeepSeek API key NVIDIA_API_KEY - NVIDIA NIM API key GEMINI_API_KEY - Google Gemini API key GROQ_API_KEY - Groq API key CEREBRAS_API_KEY - Cerebras API key XAI_API_KEY - xAI Grok API key FIREWORKS_API_KEY - Fireworks API key TOGETHER_API_KEY - Together AI API key BASETEN_API_KEY - Baseten API key OPENROUTER_API_KEY - OpenRouter API key AI_GATEWAY_API_KEY - Vercel AI Gateway API key ZAI_API_KEY - ZAI Coding Plan API key (Global) ZAI_CODING_CN_API_KEY - ZAI Coding Plan API key (China) MISTRAL_API_KEY - Mistral API key MINIMAX_API_KEY - MiniMax API key MOONSHOT_API_KEY - Moonshot AI API key OPENCODE_API_KEY - OpenCode Zen/OpenCode Go API key KIMI_API_KEY - Kimi For Coding API key META_API_KEY - Meta Model API key CLOUDFLARE_API_KEY - Cloudflare API token (Workers AI and AI Gateway) CLOUDFLARE_ACCOUNT_ID - Cloudflare account id (required for both) CLOUDFLARE_GATEWAY_ID - Cloudflare AI Gateway slug (required for AI Gateway) QWEN_TOKEN_PLAN_API_KEY - Qwen Token Plan API key (international region) QWEN_TOKEN_PLAN_CN_API_KEY - Qwen Token Plan API key (China region) XIAOMI_API_KEY - Xiaomi MiMo API key (api.xiaomimimo.com billing) XIAOMI_TOKEN_PLAN_CN_API_KEY - Xiaomi MiMo Token Plan API key (China region) XIAOMI_TOKEN_PLAN_AMS_API_KEY - Xiaomi MiMo Token Plan API key (Amsterdam region) XIAOMI_TOKEN_PLAN_SGP_API_KEY - Xiaomi MiMo Token Plan API key (Singapore region) AWS_PROFILE - AWS profile for Amazon Bedrock AWS_ACCESS_KEY_ID - AWS access key for Amazon Bedrock AWS_SECRET_ACCESS_KEY - AWS secret key for Amazon Bedrock AWS_BEARER_TOKEN_BEDROCK - Bedrock API key (bearer token) AWS_REGION - AWS region for Amazon Bedrock (e.g., us-east-1) PIG_CODING_AGENT_DIR - Config directory (default: ~/.pig/agent) PIG_CODING_AGENT_SESSION_DIR - Session storage directory (overridden by --session-dir) PI_OFFLINE - Disable startup network operations when set to 1/true/yes PI_TELEMETRY - Override install telemetry when set to 1/true/yes or 0/false/no Built-in Tool Names: read - Read file contents bash - Execute bash commands powershell - Execute PowerShell commands on Windows edit - Edit files with find/replace write - Write files (creates/overwrites) grep - Search file contents (read-only, off by default) find - Find files by glob pattern (read-only, off by default) ls - List directory contents (read-only, off by default)