La mayoría de los ajustes están en la página de ajustes de la aplicación. Esta página trata los que no están ahí: las claves que escribes a mano en un archivo de configuración y las variables de entorno que lee el harness. Las claves que tienen su propia página —proveedores, memoria, sincronización, plugins— se mencionan aquí brevemente, con un enlace a esa página.
Dónde se guardan los ajustes
| Archivo | Alcance |
|---|
~/.oharness/config.json | Tú, en este equipo. Todas las claves de abajo pueden ir aquí. |
oharness.config.json (o .oharness.json) en un proyecto | Todos los que abren ese proyecto. |
El archivo del proyecto se combina por encima del tuyo, así que un proyecto puede endurecer o ajustar lo que tú defines. Algunas claves se excluyen a propósito del archivo de proyecto, porque un repositorio que clonas no debería poder decidirlas por ti:
team: qué créditos se gastansync.url, sync.token, sync.team: adónde van tus transcripcionesruntimePlugins: código que se ejecuta en tu equipo- activar la extracción o la fusión automática de memoria, que gasta tu crédito de modelo. Un proyecto sí puede desactivarlas.
OHARNESS_HOME traslada todo el directorio ~/.oharness. Consulta Archivos de configuración para los demás archivos que contiene.
{
"model": "sonnet",
"smallModel": "haiku",
"permissionMode": "auto",
"permissions": { "deny": ["Bash(git push --force*)"] },
"writableRoots": ["~/scratch"],
"maxTurns": 100,
"sessionRetention": { "maxAgeDays": 90 }
}
Modelos
| Clave | Qué hace |
|---|
model | El modelo con el que empiezan las conversaciones nuevas, por id o alias. |
smallModel | El modelo para las tareas que no necesitan el principal: resúmenes de compactación del contexto, extracción de memoria, tareas en segundo plano como los títulos y el revisor del modo auto. Si no se define, usan el modelo de la propia conversación, que puede ser mucho más caro de lo necesario. |
thinking | Razonamiento predeterminado: { "enabled": true, "effort": "high" }. effort se ajusta a lo que admite el modelo. budgetTokens se aplica a los modelos que aceptan un presupuesto de tokens. display es "summarized" u "omitted". |
cache | Caché de prompts cuando el proveedor la admite. Activada por defecto. |
models, providers, catalog, openAiCompatible, oauthProviders | Añaden o sustituyen modelos y proveedores. Consulta Proveedores y modelos. |
Define smallModel. El modo auto lo llama antes de cada acción que revisa, y la compactación lo llama en las conversaciones largas. Un modelo rápido y barato hace ambas cosas más ágiles y mantiene bajo su coste. Si el id no se puede resolver, el harness registra una advertencia y vuelve al modelo de la conversación.
Permisos
| Clave | Qué hace |
|---|
permissionMode | El modo en que empiezan las conversaciones nuevas: default, acceptEdits, plan, auto o bypassPermissions. |
permissions | Reglas allow, ask y deny. Una regla deny gana a todos los modos, incluido Bypass. |
workspaceMode | Dónde pueden caer las escrituras: read-only, workspace-write (predeterminado: el proyecto más writableRoots) o full-access. Comprueba los argumentos de las herramientas; no es un sandbox del sistema operativo. |
writableRoots | Más directorios en los que el agente puede escribir. |
readableRoots | Más directorios que el agente puede leer pero no escribir. |
audit | Guarda un registro de cada decisión de permisos junto con su sesión. Activado salvo que se defina como false. |
auditLog | Además, añade cada decisión a este archivo, para una ejecución desatendida cuyo registro haya que recopilar. |
Permisos explica los modos, la sintaxis de las reglas y cómo decide el revisor del modo auto.
Turnos e instrucciones
| Clave | Qué hace |
|---|
maxTurns | Cuántas llamadas al modelo puede consumir un prompt antes de que el agente se detenga e informe. Por defecto, 60. |
systemPrompt | Sustituye el prompt de sistema integrado. Rara vez es lo que quieres. |
appendSystemPrompt | Texto que se añade después del prompt de sistema integrado. |
instructionsFile | Un archivo de instrucciones del proyecto distinto del predeterminado, relativo a la raíz del proyecto. |
| Clave | Qué hace |
|---|
tools | { "allow": [...], "deny": [...] } por nombre de herramienta. Funcionan patrones como mcp__github__*. deny se aplica después de allow. Una herramienta que se excluye aquí nunca se ofrece al modelo, a diferencia de una regla de permisos, que rechaza la llamada cuando se hace. |
browser | { "mode": "auto" } (predeterminado) deja que el agente elija entre tu navegador, a través de la extensión, y uno integrado. builtin, extension u off lo fijan. |
claudeAgent | Ofrece tu propio Claude Code como subagente y como @claude, pagado con tu plan de Claude. Desactivado salvo que se defina como true. |
imports | Lee las skills, los agentes y los servidores MCP de Claude Code y de Codex desde donde están. Ambos activados salvo que se defina como false. |
skillDirs, agentDirs | Más directorios en los que buscar skills y definiciones de subagentes. |
disabledSkills | Skills desactivadas por nombre. |
mcpServers, hooks, subagents, plugins, runtimePlugins | Consulta Plugins. |
schedules | Prompts que se ejecutan según una programación cron. |
Sesiones y worktrees
| Clave | Qué hace |
|---|
sessionDir | Dónde se guardan las sesiones y las transcripciones. Por defecto, storage/ en ~/.oharness. Indicar otro directorio empieza de cero: no se importa nada de lo registrado en la ubicación predeterminada. |
sessionRetention | { "maxAgeDays": 90, "keep": 500 } elimina las sesiones más antiguas al arrancar. No se elimina nada a menos que lo definas. |
worktree | Preparar un worktree de git nuevo. copy enumera rutas o patrones que se copian del proyecto cuando el worktree no los tiene (por defecto .env*). setup es un comando de shell que se ejecuta en el worktree nuevo, como npm ci. |
memory, sync | Consulta Memoria y sincronización. |
Facturación y registros
| Clave | Qué hace |
|---|
team | Carga el uso del plan oficial a los créditos de un equipo en lugar de a los tuyos. El servicio comprueba que perteneces al equipo. Se admite en tu propia configuración o en OHARNESS_TEAM, nunca en un archivo de proyecto. |
logLevel | debug, info, warn, error o silent. |
Variables de entorno
Una variable de entorno sustituye a la clave de configuración correspondiente, cuando la hay.
| Variable | Qué hace |
|---|
OHARNESS_HOME | Usa otro directorio en lugar de ~/.oharness. |
OHARNESS_TEAM | Igual que team. |
OHARNESS_SYNC | 0, false, off o no desactiva la sincronización diga lo que diga la configuración. |
OHARNESS_SYNC_TOKEN | Credencial de sincronización, cuando no está en la configuración. |
OHARNESS_SITE_URL | Una dirección de Cloud autoalojada o de desarrollo. |
OHARNESS_CATALOG | Usa este archivo como tu catálogo de modelos. |
OHARNESS_NO_BUILTIN_MODELS | 1 excluye el catálogo de modelos incluido, de modo que solo quedan tus propias entradas. |
OHARNESS_NO_CLAUDE_AGENT | 1 nunca ofrece Claude Code como subagente. |
OHARNESS_BROWSER_PATH | El binario de Chrome o Chromium que inicia el navegador integrado. |
OHARNESS_BROWSER_HEADLESS | 0 da al navegador integrado una ventana visible. |
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOME | Dónde leer los archivos de Claude Code y de Codex, cuando no están en el lugar habitual. |