anomalyco/opencode
1
0
Fork 0
mirror of https://github.com/anomalyco/opencode.git synced 2026-07-22 10:15:31 -04:00
Code Issues 5.9k Packages Projects Releases 19 Wiki Activity

[PR #1441] [MERGED] Enhanced providers docs with troubleshooting #9936

New Issue
Closed
opened 2026-02-16 18:14:25 -05:00 by yindo · 0 comments
yindo commented 2026-02-16 18:14:25 -05:00
Owner
Copy Link
Copy Source

📋 Pull Request Information

Original PR: https://github.com/anomalyco/opencode/pull/1441
Author: @opencode-agent[bot]
Created: 7/30/2025
Status: ✅ Merged
Merged: 7/31/2025
Merged by: @jayair

Base: dev ← Head: opencode/issue976-20250730234107

📝 Commits (1)

  • a0eb53f Enhanced providers docs with troubleshooting

📊 Changes

1 file changed (+399 additions, -27 deletions)

View changed files

📝 packages/web/src/content/docs/docs/providers.mdx (+399 -27)

📄 Description

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

Adding%20providers%20documentation%20for%20OpenCode
opencode session  |  github run

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/anomalyco/opencode/pull/1441 **Author:** [@opencode-agent[bot]](https://github.com/apps/opencode-agent) **Created:** 7/30/2025 **Status:** ✅ Merged **Merged:** 7/31/2025 **Merged by:** [@jayair](https://github.com/jayair) **Base:** `dev` ← **Head:** `opencode/issue976-20250730234107` --- ### 📝 Commits (1) - [`a0eb53f`](https://github.com/anomalyco/opencode/commit/a0eb53fca37edee83b02d4117b674d85afe2756e) Enhanced providers docs with troubleshooting ### 📊 Changes **1 file changed** (+399 additions, -27 deletions) <details> <summary>View changed files</summary> 📝 `packages/web/src/content/docs/docs/providers.mdx` (+399 -27) </details> ### 📄 Description 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 <a href="https://opencode.ai/s/zHSn6S6t"><img width="200" alt="Adding%20providers%20documentation%20for%20OpenCode" src="https://social-cards.sst.dev/opencode-share/QWRkaW5nIHByb3ZpZGVycyBkb2N1bWVudGF0aW9uIGZvciBPcGVuQ29kZQ==.png?model=anthropic/claude-sonnet-4-20250514&version=0.3.86&id=zHSn6S6t" /></a> [opencode session](https://opencode.ai/s/zHSn6S6t)&nbsp;&nbsp;|&nbsp;&nbsp;[github run](/sst/opencode/actions/runs/16636133490) --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
yindo added the pull-request label 2026-02-16 18:14:25 -05:00
yindo closed this issue 2026-02-16 18:14:25 -05:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
acp
bad
bug
discussion
docs
documentation
enhancement
extension
good first issue
growth
help-wanted
mcp
model-problem
needs:compliance
nix
opentui
perf
pull-request
Mirrored from GitHub Pull Request
 tui
web
windows
zen
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#9936
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?