Skip to content

feat(hephaestus): support custom OpenAI-compatible providers#2128

Closed
imwxc wants to merge 2 commits intocode-yeongyu:devfrom
imwxc:feat/hephaestus-custom-provider-support
Closed

feat(hephaestus): support custom OpenAI-compatible providers#2128
imwxc wants to merge 2 commits intocode-yeongyu:devfrom
imwxc:feat/hephaestus-custom-provider-support

Conversation

@imwxc
Copy link

@imwxc imwxc commented Feb 26, 2026

Summary

  • Remove requiresProvider restriction from Hephaestus to support custom OpenAI-compatible providers
  • Allow users to configure Hephaestus with any model via oh-my-opencode.json
  • When allow_non_gpt_model: true is set, a warning toast is shown but the agent is not blocked

Changes

1. Remove Provider Restriction (src/shared/model-requirements.ts)

  • Removed requiresProvider: ["openai", "opencode"] from Hephaestus
  • Users can now configure any OpenAI-compatible provider (OpenRouter, LiteLLM, custom proxies)
  • GPT remains the default via existing fallbackChain

2. Hook Behavior (src/hooks/no-hephaestus-non-gpt/hook.ts)

  • Default behavior: Block non-GPT models with error toast, switch to Sisyphus
  • With allow_non_gpt_model: true: Show warning toast but allow the model to proceed

Usage Example

Users can now configure Hephaestus with custom thinking-capable models:

{
  "agents": {
    "hephaestus": {
      "model": "custom-provider/thinking-model-id",
      "reasoningEffort": "high",
      "allow_non_gpt_model": true
    }
  }
}

Testing

  • All existing tests pass
  • Tests verify warning toast is shown when allow_non_gpt_model: true

Related Issues


Ultraworked with Sisyphus

Allow users to configure Hephaestus with any OpenAI-compatible provider
via oh-my-opencode.json. The requiresProvider restriction is removed to
enable custom model configurations while maintaining GPT as the default.

Users can now use models like DeepSeek R1 or other thinking-capable models
by setting agents.hephaestus.model and allow_non_gpt_model: true.

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)
Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
@github-actions
Copy link
Contributor

github-actions bot commented Feb 26, 2026

All contributors have signed the CLA. Thank you! ✅
Posted by the CLA Assistant Lite bot.

Copy link

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 4 files

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Auto-approved: The changes safely relax provider restrictions for Hephaestus and implement silent opt-in for non-GPT models as requested, with appropriate test updates and no detected side effects.

…odel

When allow_non_gpt_model is set to true, non-GPT models are allowed
but a warning toast is still shown to remind users that Hephaestus
is optimized for GPT models.

The hook only blocks and switches to Sisyphus when allow_non_gpt_model
is not configured.

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)
Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
@imwxc imwxc force-pushed the feat/hephaestus-custom-provider-support branch from d0cd311 to 06e846a Compare February 26, 2026 06:27
@imwxc
Copy link
Author

imwxc commented Feb 26, 2026

Closing this PR. Will create an issue to request this feature instead, as it needs more discussion and potentially different implementation approach.

@imwxc imwxc closed this Feb 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant