quebragalho-bridge
by danjour
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| QUEBRAGALHO_API_KEY | Yes | Chave `qg-` do gateway; obrigatória para ferramentas de prompt direto e executor OpenCode, e repassada ao executor nativo como ANTHROPIC_AUTH_TOKEN | |
| QUEBRAGALHO_BASE_URL | No | URL base da API OpenAI-compatible; o executor nativo deriva dela o ANTHROPIC_BASE_URL | https://api.quebragalho.dev/v1 |
| QUEBRAGALHO_CODE_BIN | No | Executável da CLI estilo Claude Code usada pelo executor nativo; pode ser Node quando QUEBRAGALHO_CODE_ENTRYPOINT estiver definido | claude |
| QUEBRAGALHO_ENV_FILE | No | Arquivo opcional lido por bin/quebragalho-mcp para obter QUEBRAGALHO_API_KEY sem source | |
| QUEBRAGALHO_NODE_BIN | No | Binário Node usado por bin/quebragalho-mcp | node |
| QUEBRAGALHO_LOG_LEVEL | No | Nível de log: debug, info, warn, error | info |
| QUEBRAGALHO_USAGE_DIR | No | Diretório do diário JSONL de uso (um arquivo por dia local). Grava somente contadores e identificadores (timestamp, modelo, executor, tokens, requisições) | ~/.local/share/quebragalho-bridge/usage |
| QUEBRAGALHO_JOB_TTL_MS | No | TTL em ms para jobs finalizados sem resultado | 1800000 |
| QUEBRAGALHO_MEMORY_DIR | No | Diretório dos diários JSONL isolados por projeto | ~/.local/share/quebragalho-bridge/memory |
| QUEBRAGALHO_MODEL_SYNC | No | Defina 1 para sincronizar o catálogo com GET {QUEBRAGALHO_BASE_URL}/models logo após o servidor responder. Modelos conhecidos mantêm metadados locais e adotam contexto/output reais; modelos novos entram com classe pro no roteamento automático; modelos locais ausentes do gateway são mantidos | |
| QUEBRAGALHO_API_RETRIES | No | Retries automáticos para 429/5xx (total = N+1 tentativas), com backoff exponencial e respeito ao Retry-After; 4xx nunca é retentado; teto 5 | 2 |
| QUEBRAGALHO_MODEL_TIERS | No | Classes de custo permitidas no roteamento, preview e seleção manual (pro dia a dia, ultra flagship, max premium) | pro,max,ultra |
| QUEBRAGALHO_OPENCODE_BIN | No | Caminho do OpenCode 1.17.9+ | opencode |
| QUEBRAGALHO_JOB_STORE_DIR | No | Diretório para persistência atômica de metadados seguros e recuperação de jobs interrompidos; em macOS/Linux, use diretório privado 0700/0600 | |
| QUEBRAGALHO_MAX_SPEND_USD | No | Teto diário de gasto estimado em US$ (preços por milhão de tokens no catálogo). Estourado ou diário ilegível = BUDGET_EXCEEDED (fail-closed) | |
| QUEBRAGALHO_AGENT_EXECUTOR | No | Padrão administrativo; cada chamada pode substituir por native ou opencode | native |
| QUEBRAGALHO_API_TIMEOUT_MS | No | Timeout de cada tentativa de chamada ao gateway (tools diretas e sync de modelos); valores fora de [1000, 1800000] são ajustados aos limites | 300000 |
| QUEBRAGALHO_JOB_MAX_QUEUED | No | Máximo de jobs aguardando na fila | 50 |
| QUEBRAGALHO_MEMORY_ENABLED | No | Defina 1 para ativar memória técnica persistente dos subagentes | |
| QUEBRAGALHO_MODEL_DENYLIST | No | Modelos bloqueados em todas as frentes; são ocultados dos schemas/recursos e rejeitados antes de rede ou fila | |
| QUEBRAGALHO_CODE_ENTRYPOINT | No | Caminho opcional para o entrypoint da CLI quando ela roda via Node | |
| QUEBRAGALHO_JOB_MAX_RESULTS | No | Máximo de resultados mantidos em memória (até 500) | 100 |
| QUEBRAGALHO_MODEL_ALLOWLIST | No | Modelos permitidos em todas as frentes (tools diretas, schemas, recursos, prompts, preview e agentes), separados por vírgula | todos |
| QUEBRAGALHO_LIST_MODEL_TOOLS | No | Defina 1 para voltar a publicar uma tool por modelo na listagem. Ausente, as chamadas por nome antigo seguem funcionando, mas as tools não aparecem na descoberta | |
| QUEBRAGALHO_MEMORY_MAX_BYTES | No | Tamanho máximo do diário de memória; ao exceder, o arquivo rotaciona para <arquivo>.1 (uma geração apenas) e o corrente recomeça vazio | 1048576 |
| QUEBRAGALHO_JOB_RESULT_TTL_MS | No | TTL em ms para resultados de jobs | 600000 |
| QUEBRAGALHO_AGENT_ALLOWED_ROOTS | Yes | Raízes repo-aware separadas pelo delimitador de paths do SO; sem valor, quebragalho_agent falha fechado | |
| QUEBRAGALHO_AGENT_WRITE_ENABLED | No | Defina 1 para habilitar write; por padrão, somente read_only é aceito | |
| QUEBRAGALHO_JOB_PERSIST_RESULTS | No | Em macOS/Linux, defina 1 com QUEBRAGALHO_JOB_STORE_DIR privado 0700/0600 para persistir e recuperar o resultado público terminal. No Windows falha fechado | |
| QUEBRAGALHO_SHARED_MEMORY_FILES | No | Arquivos de memória curada, somente leitura, separados pelo delimitador de paths do SO | |
| QUEBRAGALHO_AGENT_VERIFY_ENABLED | No | Defina 1 para habilitar quebragalho_validate; por padrão falha fechado | |
| QUEBRAGALHO_AGENT_MAX_CONCURRENCY | No | Execuções simultâneas globais, incluindo jobs assíncronos; inteiro entre 1 e 8, valores inválidos usam 4 | 4 |
| QUEBRAGALHO_MODEL_COOLDOWN_SECONDS | No | Cooldown de um modelo após falha recuperável | 60 |
| QUEBRAGALHO_NATIVE_MODEL_ALLOWLIST | No | Modelos permitidos no executor nativo; impede seleção silenciosa de modelos que a CLI não suporta | todos |
| QUEBRAGALHO_AGENT_MAX_MODEL_ATTEMPTS | No | Tentativas de modelos no modo auto + read_only; inteiro entre 1 e 3 | 2 |
| QUEBRAGALHO_AGENT_VERIFY_NPM_SCRIPTS | No | Scripts separados por vírgula permitidos para npm run; npm test continua sujeito ao segundo opt-in | |
| QUEBRAGALHO_OPENCODE_MODEL_ALLOWLIST | No | Modelos permitidos especificamente no executor OpenCode | todos |
| QUEBRAGALHO_AUTO_INCLUDE_PREMIUM_MODELS | No | Defina exatamente 1 para incluir variantes caras (classe max: Claude Opus 5.5, DeepSeek V4 Pro, GPT 5.6 Sol, Kimi K3) no ranking automático | |
| QUEBRAGALHO_AGENT_VERIFY_PROJECT_CODE_ENABLED | No | Segundo opt-in obrigatório para npm test/npm run; não é sandbox: executa código confiável com o usuário do bridge |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |