Configurações avançadas

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

ArquivoEscopo
~/.oharness/config.jsonVocê, neste computador. Todas as chaves abaixo podem ficar aqui.
oharness.config.json (ou .oharness.json) em um projetoTodos 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 gastos
  • sync.url, sync.token, sync.team: para onde vão suas transcrições
  • runtimePlugins: 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

ChaveO que faz
modelO modelo com que as novas conversas começam, por id ou alias.
smallModelO 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.
thinkingRaciocí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".
cacheCache de prompts quando o provedor suporta. Ligado por padrão.
models, providers, catalog, openAiCompatible, oauthProvidersAdicionam 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

ChaveO que faz
permissionModeO modo em que as novas conversas começam: default, acceptEdits, plan, auto ou bypassPermissions.
permissionsRegras allow, ask e deny. Uma regra deny vence todos os modos, inclusive o Bypass.
workspaceModeOnde 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.
writableRootsMais diretórios em que o agente pode gravar.
readableRootsMais diretórios que o agente pode ler, mas não gravar.
auditMantém um registro de cada decisão de permissão junto com a sessão. Ligado, a menos que seja definido como false.
auditLogTambé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

ChaveO que faz
maxTurnsQuantas chamadas ao modelo um prompt pode usar antes que o agente pare e informe. Padrão: 60.
systemPromptSubstitui o prompt de sistema embutido. Raramente é o que você quer.
appendSystemPromptTexto adicionado depois do prompt de sistema embutido.
instructionsFileUm arquivo de instruções do projeto diferente do padrão, relativo à raiz do projeto.

Ferramentas e extensões

ChaveO 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.
claudeAgentOferece 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.
importsLê 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, agentDirsMais diretórios onde procurar skills e definições de subagentes.
disabledSkillsSkills desligadas pelo nome.
mcpServers, hooks, subagents, plugins, runtimePluginsVeja Plugins.
schedulesPrompts que rodam em um agendamento cron.

Sessões e worktrees

ChaveO que faz
sessionDirOnde 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.
worktreePreparar 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, syncVeja Memória e sincronização.

Cobrança e logs

ChaveO que faz
teamCobra 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.
logLeveldebug, 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ávelO que faz
OHARNESS_HOMEUsa outro diretório em vez de ~/.oharness.
OHARNESS_TEAMO mesmo que team.
OHARNESS_SYNC0, false, off ou no desliga a sincronização, não importa o que diga a configuração.
OHARNESS_SYNC_TOKENCredencial de sincronização, quando ela não está na configuração.
OHARNESS_SITE_URLUm endereço do Cloud auto-hospedado ou de desenvolvimento.
OHARNESS_CATALOGUsa este arquivo como seu catálogo de modelos.
OHARNESS_NO_BUILTIN_MODELS1 deixa de fora o catálogo de modelos incluído, para que só restem as suas próprias entradas.
OHARNESS_NO_CLAUDE_AGENT1 nunca oferece o Claude Code como subagente.
OHARNESS_BROWSER_PATHO binário do Chrome ou Chromium que o navegador embutido inicia.
OHARNESS_BROWSER_HEADLESS0 dá ao navegador embutido uma janela visível.
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOMEOnde ler os arquivos do Claude Code e do Codex, quando eles não estão no lugar de sempre.