[opencode-agent]

Perfect! I've successfully enhanced the providers documentation based on the GitHub issue feedback. Here's what I've added:

✅ Completed Improvements

1. Added Popular OpenAI-Compatible Providers:

• Cerebras - with correct @ai-sdk/cerebras package and API setup
• DeepSeek - for reasoning models
• Moonshot AI (Kimi) - for long context capabilities

2. Created Step-by-Step Setup Instructions:

• Each provider now has detailed setup instructions
• Clear terminal examples showing the auth flow
• Complete configuration examples with proper JSON formatting

3. Added Comprehensive Troubleshooting Section:

• Credential Loop Issue - addresses the exact problem mentioned in the GitHub issue
• Global vs Local Configuration - explains the config hierarchy and best practices
• Common Configuration Mistakes - covers wrong npm packages, missing baseURL, etc.

4. Enhanced Custom Provider Section:

• Restructured with clear step-by-step process
• Added configuration options table
• Multiple real-world examples (Together AI, Fireworks AI, Local API)
• Better tips and best practices

The documentation now addresses all the pain points mentioned in the GitHub issue:

• ✅ Fixes the Cerebras setup loop issue
• ✅ Clarifies global vs local config confusion
• ✅ Provides clear examples for popular providers
• ✅ Improves the custom provider setup process

The enhanced documentation should make it much easier for users to set up any OpenAI-compatible provider with opencode!

Closes #976

opencode session  |  github run