OpenCode Free Rotation

Keep Hermes on the current OpenCode Zen free catalog and rotate through free models when usage or token limits are hit.

When to Use

• OpenCode free models change and you want the live list refreshed
• A free model returns Free usage exceeded or similar limit errors
• You need to verify the primary + fallback chain before a long session
• You want a scheduled catalog refresh (cron) to stay current

Prerequisites

• OPENCODE_ZEN_API_KEY in ~/.hermes/.env (from https://opencode.ai/auth)
• Primary provider set to opencode-zen with model.default: auto-free
• Optional local rollback: llama-cpp on http://127.0.0.1:8080/v1

Example config: docs/migration/opencode_free_webui_config.example.yaml