rivale

---

O que é

Rivale é um agente de programação que vive no seu terminal (e no VS Code). Ele lê, escreve e refatora código, roda comandos, pesquisa na web, dirige um browser, versiona com git e coordena vários subagentes especializados — tudo com controle de custo, aprovação humana e proteções de segurança embutidas.

Funciona com múltiplos provedores de LLM: Groq, OpenAI, Gemini e DeepSeek.

Destaques

• Multi-agente real — modo Coordenador que delega para subagentes especializados (coder, security, tester, reviewer, researcher), execução em paralelo e swarm debate pra decisões difíceis.
• MCP local e remoto — conecta qualquer servidor Model Context Protocol via stdio (npx/uvx/python) ou HTTP streamable / SSE (endpoints remotos com auth por header).
• Ferramentas de código sérias — ler/editar/criar arquivos, grep/glob, busca por AST, integração LSP, git nativo (status/diff/log/commit), tarefas em background, run_command, browser (Playwright), SQLite e mais.
• Memória de verdade — janela de contexto por tokens com auto-compactação, indexação do codebase e busca semântica de código.
• Teto de custo por run — corta o loop antes de queimar dinheiro (AGENT_MAX_USD_PER_RUN).
• Segurança em primeiro lugar — cofre de chaves criptografado, guard de comandos, modo plan, hooks PreToolUse, proteção contra SSRF e auto-proteção do próprio código.
• UX de terminal moderna — streaming, menção de arquivos com @, telas de /config, /mcp, /compact, atalhos configuráveis.
• Extensão para VS Code — chat no editor, aprovação in-chat, drag-and-drop de arquivos, timeline de atividade.

Instalação

npm install -g rivale

Requer Node.js ≥ 18. (Git é necessário para as ferramentas de versionamento.)

Começando

rivale                        # abre o chat interativo
rivale "crie um scraper em python para a home do HN"   # modo one-shot
rivale --stream "explique este repositório"

Dentro do chat:

Comando	O quê
@arquivo	menciona um arquivo/pasta pro contexto
/config	provider, modelo, API key (vai pro cofre criptografado)
/mcp	conecta/gerencia servidores MCP
/compact	resume a conversa pra liberar contexto
/help	lista tudo

Chaves de API (cofre criptografado )

Suas chaves ficam cifradas em ~/.rivale/secrets.json (AES-256-GCM) — nunca em texto puro.

rivale keys set GROQ_API_KEY        # digita escondido (não vaza no histórico do shell)
rivale keys list                    # mostra mascarado
rivale keys import-env              # migra chaves do seu .env atual pro cofre

Você também pode usar variáveis de ambiente ou ~/.rivale/.env (as chaves reais do ambiente sempre têm prioridade):

GROQ_API_KEY=...
OPENAI_API_KEY=...
GEMINI_API_KEY=...
DEEPSEEK_API_KEY=...

MCP (Model Context Protocol)

Declare servidores em .rivale/mcp.json — stdio (local) ou remoto (URL):

{
  "mcpServers": {
    "playwright": { "command": "npx", "args": ["-y", "@playwright/mcp@latest"] },
    "context7":   { "command": "npx", "args": ["-y", "@upstash/context7-mcp"] },
    "remoto": {
      "url": "https://seu-endpoint.exemplo.com/mcp",
      "type": "http",
      "headers": { "Authorization": "Bearer SEU_TOKEN" }
    }
  }
}

Controle de custo

AGENT_MAX_USD_PER_RUN=0.50      # aborta a run ao atingir US$ 0,50 (0 = ilimitado)
AGENT_MAX_TOKENS_PER_RUN=200000 # teto por tokens

Segurança

• Cofre de chaves criptografado (AES-256-GCM), fora do .env.
• Guard de comandos — bloqueia egress de rede suspeito, escalada de privilégio e execução dinâmica, mesmo com aprovação desligada.
• Modo Plan — bloqueia escrita/comandos perigosos até você aprovar o plano.
• Hooks PreToolUse — intercepte/valide qualquer chamada de ferramenta.
• SSRF guard — nega requisições a IPs privados/metadata de cloud.
• Aprovação humana por ferramenta, com níveis configuráveis.

Requisitos

• Node.js ≥ 18
• Git (para as ferramentas de versionamento)
• Chave de API de pelo menos um provedor

---