freeride-opencode

# Freeride OpenCode

Configure OpenCode Zen free models with intelligent fallbacks to optimize costs while maintaining reliability.

> **⚠️ Important:** To use this skill, you need **two API keys**:
> 1. **OpenCode Zen API key** - For OpenCode free models (MiniMax M2.1, Kimi K2.5, GLM 4.7, GPT 5 Nano)
> 2. **OpenRouter API key** - For OpenRouter free models (Trinity Large and other OpenRouter providers)
>
> Configure both keys in your OpenCode/Zen settings before applying these configurations.

## Quick Start

Apply optimal free model configuration with provider diversification:

```json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "opencode/minimax-m2.1-free",
        "fallbacks": [
          "openrouter/arcee-ai/trinity-large-preview:free",
          "opencode/kimi-k2.5-free"
        ]
      },
      "heartbeat": {
        "model": "opencode/glm-4.7-free"
      },
      "subagents": {
        "model": "opencode/kimi-k2.5-free"
      }
    }
  }
}
```

## 🔑 API Keys Required

This skill uses models from **two different providers**, so you need both API keys configured:

### 1. OpenCode Zen API Key
**Required for:**
- `opencode/minimax-m2.1-free`
- `opencode/kimi-k2.5-free`
- `opencode/glm-4.7-free`
- `opencode/gpt-5-nano`

**Where to get:** Sign up at [OpenCode Zen](https://opencode.ai) and generate an API key.

### 2. OpenRouter API Key
**Required for:**
- `openrouter/arcee-ai/trinity-large-preview:free`
- Any other OpenRouter free models you add

**Where to get:** Sign up at [OpenRouter.ai](https://openrouter.ai) and generate an API key.

### Configuration

Add both keys to your OpenCode configuration:

```json
{
  "providers": {
    "opencode": {
      "api_key": "YOUR_OPENCODE_ZEN_API_KEY"
    },
    "openrouter": {
      "api_key": "YOUR_OPENROUTER_API_KEY"
    }
  }
}
```

### Fallback Behavior by Provider

- If **OpenCode models** fail → tries next OpenCode fallback or OpenRouter model
- If **OpenRouter models** fail → tries next Op...

# Freeride OpenCode Skill

> ⚠️ **Para funcionar, são necessárias duas API keys:**
> - **OpenCode Zen API key** - Para modelos OpenCode (MiniMax M2.1, Kimi K2.5, GLM 4.7, GPT 5 Nano)
> - **OpenRouter API key** - Para modelos OpenRouter (Trinity Large e outros)

## Descrição

Configure modelos free do OpenCode Zen com fallbacks inteligentes para otimizar custos mantendo confiabilidade.

## Quick Start

```json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "opencode/minimax-m2.1-free",
        "fallbacks": [
          "openrouter/arcee-ai/trinity-large-preview:free",
          "opencode/kimi-k2.5-free"
        ]
      }
    }
  }
}
```

## Documentação Completa

Veja [SKILL.md](SKILL.md) para documentação detalhada.

## Modelos Disponíveis

| Modelo | Provider | ID | Posição |
|--------|----------|-----|---------|
| MiniMax M2.1 | OpenCode | `opencode/minimax-m2.1-free` | Primary |
| Trinity Large | OpenRouter | `openrouter/arcee-ai/trinity-large-preview:free` | Fallback 1 |
| Kimi K2.5 | OpenCode | `opencode/kimi-k2.5-free` | Fallback 2 |

## Versão

1.2.0