[Question] How to use Gitlab/Github runners with custom providers

[co-esquie]

After looking at the documentation to Integrate with Github workflow, the documentation is quite clear about the usage with Anthropic

- name: Run opencode
  uses: sst/opencode/github@latest
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
  with:
    model: anthropic/claude-sonnet-4-20250514

but what about custom open AI providers? Locally you have to create an opencode configuration file inside the project folder, but i'm not sure what is the process and what environment variables should be used. I think we can create opencode.json at the project root location and use the env syntax in the json file?

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "My AI ProviderDisplay Name",
      "options": {
        "baseURL": "https://api.myprovider.com/v1",
        "apiKey": "{env:MY_SECRET_VARFIABLE_NAME}"
      },
      "models": {
        "my-model-name": {
          "name": "My Model Display Name"
        }
      }
    }
  }

and use the provider/my-model-name in the github workflow? Let me know if I'm right and also if you are interested that I improve documentation on this part in a pull request.

Also, are we able to use custom modes like plan then build in the workflow?

[github-actions]

This issue might be a duplicate of existing issues. Please check:

• Feat: Allow github actions to use custom configuration #1489: Feat: Allow github actions to use custom configuration - specifically addresses using custom configurations and environment variables in GitHub Actions, with an associated PR
• LM Studio Missing as Provider, custom provider for LM Studio non-functional. #1555: LM Studio Missing as Provider, custom provider for LM Studio non-functional - shows examples of configuring custom providers with environment variable syntax {env:VARIABLE_NAME}
• Make using any model with any provider easier #930: Make using any model with any provider easier - discusses difficulties with custom provider documentation and configuration
• [Request] Add Ollama setup info in Readme.md #187: Add Ollama setup info in Readme.md - requests better documentation for setting up custom providers globally

The configuration approach you've outlined appears to be correct based on issue #1555, and there's already an active PR (#1488) that addresses GitHub Actions with custom configurations as mentioned in issue #1489.

Feel free to ignore if none of these address your specific case.

[nagyv]

@co-esquie I released a GitLab + OpenCode CI component that works great with GitLab runners a few days ago: https://gitlab.com/explore/catalog/nagyv/gitlab-opencode