integrating-providers

Adding AI Providers to Claude Council

Provider Script Interface

Each provider is a shell script in scripts/providers/ that:

1. Accepts a prompt as the first argument
2. Outputs the AI response to stdout
3. Exits 0 on success, non-zero on failure

Quick Start

1. Create scripts/providers/{name}.sh (see api-patterns.md for templates)
2. chmod +x scripts/providers/{name}.sh
3. Set {NAME}_API_KEY environment variable
4. Test: ./scripts/providers/{name}.sh "Hello"

Current Providers

Provider	API Key Variable	Default Model
Gemini	GEMINI_API_KEY	gemini-3.1-pro-preview
OpenAI	OPENAI_API_KEY	gpt-5.5-pro
Grok	XAI_API_KEY (or GROK_API_KEY)	grok-4.20-reasoning
Perplexity	PERPLEXITY_API_KEY	sonar-reasoning-pro

Troubleshooting

• Not discovered: Check API key is set and script is executable
• API errors: Verify key, check rate limits, confirm model name
• Parse fails: Add echo "$RESPONSE" to debug, check response format

Reference

For API patterns and code templates, see api-patterns.md in this directory.