A maioria das configurações fica na página Configurações do app. Esta página trata das que não estão lá: as chaves que você escreve à mão em um arquivo de configuração e as variáveis de ambiente que o harness lê. As chaves que têm página própria — provedores, memória, sincronização, plugins — aparecem aqui de forma resumida, com um link para essa página.
Onde ficam as configurações
| Arquivo | Escopo |
|---|
~/.oharness/config.json | Você, neste computador. Todas as chaves abaixo podem ficar aqui. |
oharness.config.json (ou .oharness.json) em um projeto | Todos que abrem esse projeto. |
O arquivo do projeto é mesclado por cima do seu, então um projeto pode restringir ou ajustar o que você definiu. Algumas chaves ficam de fora do arquivo de projeto de propósito, porque um repositório que você clona não deve poder decidi-las por você:
team: de quem são os créditos gastossync.url, sync.token, sync.team: para onde vão suas transcriçõesruntimePlugins: código que roda no seu computador- ligar a extração ou a mesclagem automática de memória, que gasta seu crédito de modelo. Um projeto pode desligá-las.
OHARNESS_HOME muda o diretório ~/.oharness inteiro de lugar. Veja Arquivos de configuração para os outros arquivos que ficam nele.
{
"model": "sonnet",
"smallModel": "haiku",
"permissionMode": "auto",
"permissions": { "deny": ["Bash(git push --force*)"] },
"writableRoots": ["~/scratch"],
"maxTurns": 100,
"sessionRetention": { "maxAgeDays": 90 }
}
Modelos
| Chave | O que faz |
|---|
model | O modelo com que as novas conversas começam, por id ou alias. |
smallModel | O modelo para tarefas que não precisam do principal: resumos da compactação de contexto, extração de memória, tarefas em segundo plano como títulos e o revisor do modo auto. Sem ele, essas tarefas usam o modelo da própria conversa, que pode ser bem mais caro do que o necessário. |
thinking | Raciocínio padrão: { "enabled": true, "effort": "high" }. effort é ajustado ao que o modelo suporta. budgetTokens vale para modelos que aceitam um orçamento de tokens. display é "summarized" ou "omitted". |
cache | Cache de prompts quando o provedor suporta. Ligado por padrão. |
models, providers, catalog, openAiCompatible, oauthProviders | Adicionam ou substituem modelos e provedores. Veja Provedores e modelos. |
Defina smallModel. O modo auto o chama antes de cada ação que revisa, e a compactação o chama em conversas longas. Um modelo rápido e barato deixa as duas coisas mais ágeis e mantém o custo baixo. Se o id não puder ser resolvido, o harness registra um aviso e volta para o modelo da conversa.
Permissões
| Chave | O que faz |
|---|
permissionMode | O modo em que as novas conversas começam: default, acceptEdits, plan, auto ou bypassPermissions. |
permissions | Regras allow, ask e deny. Uma regra deny vence todos os modos, inclusive o Bypass. |
workspaceMode | Onde as gravações podem cair: read-only, workspace-write (padrão: o projeto mais writableRoots) ou full-access. Isso verifica os argumentos das ferramentas; não é um sandbox do sistema operacional. |
writableRoots | Mais diretórios em que o agente pode gravar. |
readableRoots | Mais diretórios que o agente pode ler, mas não gravar. |
audit | Mantém um registro de cada decisão de permissão junto com a sessão. Ligado, a menos que seja definido como false. |
auditLog | Também acrescenta cada decisão a este arquivo, para uma execução sem supervisão cujo registro precisa ser coletado. |
Permissões explica os modos, a sintaxe das regras e como o revisor do modo auto decide.
Turnos e instruções
| Chave | O que faz |
|---|
maxTurns | Quantas chamadas ao modelo um prompt pode usar antes que o agente pare e informe. Padrão: 60. |
systemPrompt | Substitui o prompt de sistema embutido. Raramente é o que você quer. |
appendSystemPrompt | Texto adicionado depois do prompt de sistema embutido. |
instructionsFile | Um arquivo de instruções do projeto diferente do padrão, relativo à raiz do projeto. |
| Chave | O que faz |
|---|
tools | { "allow": [...], "deny": [...] } por nome de ferramenta. Globs como mcp__github__* funcionam. deny é aplicado depois de allow. Uma ferramenta deixada de fora aqui nunca é oferecida ao modelo, ao contrário de uma regra de permissão, que recusa a chamada quando ela é feita. |
browser | { "mode": "auto" } (padrão) deixa o agente escolher entre o seu navegador, pela extensão, e um embutido. builtin, extension ou off fixam a escolha. |
claudeAgent | Oferece o seu próprio Claude Code como subagente e como @claude, pago pelo seu plano do Claude. Desligado, a menos que seja definido como true. |
imports | Lê as skills, os agentes e os servidores MCP do Claude Code e do Codex de onde eles ficam. Ambos ligados, a menos que seja definido como false. |
skillDirs, agentDirs | Mais diretórios onde procurar skills e definições de subagentes. |
disabledSkills | Skills desligadas pelo nome. |
mcpServers, hooks, subagents, plugins, runtimePlugins | Veja Plugins. |
schedules | Prompts que rodam em um agendamento cron. |
Sessões e worktrees
| Chave | O que faz |
|---|
sessionDir | Onde as sessões e transcrições são guardadas. O padrão é storage/ em ~/.oharness. Apontar para outro diretório começa do zero: nada do que foi registrado no local padrão é importado. |
sessionRetention | { "maxAgeDays": 90, "keep": 500 } apaga as sessões mais antigas na inicialização. Nada é apagado se você não definir isso. |
worktree | Preparar um novo worktree do git. copy lista caminhos ou globs copiados do projeto quando o worktree não os tem (padrão .env*). setup é um comando de shell executado no novo worktree, como npm ci. |
memory, sync | Veja Memória e sincronização. |
Cobrança e logs
| Chave | O que faz |
|---|
team | Cobra o uso do plano oficial dos créditos de uma equipe em vez dos seus. O serviço confere se você faz parte da equipe. Permitido na sua própria configuração ou em OHARNESS_TEAM, nunca em um arquivo de projeto. |
logLevel | debug, info, warn, error ou silent. |
Variáveis de ambiente
Uma variável de ambiente substitui a chave de configuração correspondente, quando ela existe.
| Variável | O que faz |
|---|
OHARNESS_HOME | Usa outro diretório em vez de ~/.oharness. |
OHARNESS_TEAM | O mesmo que team. |
OHARNESS_SYNC | 0, false, off ou no desliga a sincronização, não importa o que diga a configuração. |
OHARNESS_SYNC_TOKEN | Credencial de sincronização, quando ela não está na configuração. |
OHARNESS_SITE_URL | Um endereço do Cloud auto-hospedado ou de desenvolvimento. |
OHARNESS_CATALOG | Usa este arquivo como seu catálogo de modelos. |
OHARNESS_NO_BUILTIN_MODELS | 1 deixa de fora o catálogo de modelos incluído, para que só restem as suas próprias entradas. |
OHARNESS_NO_CLAUDE_AGENT | 1 nunca oferece o Claude Code como subagente. |
OHARNESS_BROWSER_PATH | O binário do Chrome ou Chromium que o navegador embutido inicia. |
OHARNESS_BROWSER_HEADLESS | 0 dá ao navegador embutido uma janela visível. |
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOME | Onde ler os arquivos do Claude Code e do Codex, quando eles não estão no lugar de sempre. |