La maggior parte delle impostazioni si trova nella pagina Impostazioni dell'app. Questa pagina copre quelle che non ci sono: le chiavi che scrivi a mano in un file di configurazione e le variabili d'ambiente che l'harness legge. Le chiavi che hanno una pagina propria — provider, memoria, sincronizzazione, plugin — sono elencate qui in breve, con un link a quella pagina.
Dove stanno le impostazioni
| File | Ambito |
|---|
~/.oharness/config.json | Tu, su questo computer. Tutte le chiavi qui sotto possono stare qui. |
oharness.config.json (o .oharness.json) in un progetto | Chiunque apra quel progetto. |
Il file del progetto viene unito sopra il tuo, quindi un progetto può restringere o regolare ciò che hai impostato. Alcune chiavi sono escluse di proposito dal file di progetto, perché un repository che cloni non dovrebbe poterle decidere al posto tuo:
team: quali crediti vengono spesisync.url, sync.token, sync.team: dove finiscono le tue trascrizioniruntimePlugins: codice che gira sul tuo computer- l'attivazione dell'estrazione o dell'unione automatica della memoria, che consuma il tuo credito del modello. Un progetto può invece disattivarle.
OHARNESS_HOME sposta l'intera directory ~/.oharness. Vedi File di configurazione per gli altri file che contiene.
{
"model": "sonnet",
"smallModel": "haiku",
"permissionMode": "auto",
"permissions": { "deny": ["Bash(git push --force*)"] },
"writableRoots": ["~/scratch"],
"maxTurns": 100,
"sessionRetention": { "maxAgeDays": 90 }
}
Modelli
| Chiave | Cosa fa |
|---|
model | Il modello con cui partono le nuove conversazioni, per id o alias. |
smallModel | Il modello per i lavori che non richiedono quello principale: i riepiloghi della compattazione del contesto, l'estrazione della memoria, le attività in background come i titoli e il revisore della modalità auto. Se non è impostato, questi usano il modello della conversazione stessa, che può costare molto più del necessario. |
thinking | Ragionamento predefinito: { "enabled": true, "effort": "high" }. effort viene adattato a ciò che il modello supporta. budgetTokens vale per i modelli che accettano un budget di token. display è "summarized" o "omitted". |
cache | Caching dei prompt dove il provider lo supporta. Attivo per impostazione predefinita. |
models, providers, catalog, openAiCompatible, oauthProviders | Aggiungono o sostituiscono modelli e provider. Vedi Provider e modelli. |
Imposta smallModel. La modalità auto lo chiama prima di ogni azione che esamina, e la compattazione lo chiama nelle conversazioni lunghe. Un modello veloce ed economico rende entrambe più rapide e ne tiene basso il costo. Se l'id non può essere risolto, l'harness registra un avviso e ripiega sul modello della conversazione.
Permessi
| Chiave | Cosa fa |
|---|
permissionMode | La modalità con cui partono le nuove conversazioni: default, acceptEdits, plan, auto o bypassPermissions. |
permissions | Regole allow, ask e deny. Una regola deny batte ogni modalità, Bypass compresa. |
workspaceMode | Dove possono finire le scritture: read-only, workspace-write (predefinito: il progetto più writableRoots) o full-access. Controlla gli argomenti degli strumenti; non è una sandbox del sistema operativo. |
writableRoots | Altre directory in cui l'agente può scrivere. |
readableRoots | Altre directory che l'agente può leggere ma non scrivere. |
audit | Conserva un registro di ogni decisione sui permessi insieme alla sua sessione. Attivo a meno che non sia impostato a false. |
auditLog | Aggiunge anche ogni decisione a questo file, per un'esecuzione non presidiata il cui registro va raccolto. |
Permessi spiega le modalità, la sintassi delle regole e come decide il revisore della modalità auto.
Turni e istruzioni
| Chiave | Cosa fa |
|---|
maxTurns | Quante chiamate al modello può richiedere un prompt prima che l'agente si fermi e riferisca. Predefinito 60. |
systemPrompt | Sostituisce il prompt di sistema integrato. Raramente è ciò che vuoi. |
appendSystemPrompt | Testo aggiunto dopo il prompt di sistema integrato. |
instructionsFile | Un file di istruzioni del progetto diverso da quello predefinito, relativo alla radice del progetto. |
| Chiave | Cosa fa |
|---|
tools | { "allow": [...], "deny": [...] } per nome dello strumento. Funzionano i glob come mcp__github__*. deny si applica dopo allow. Uno strumento escluso qui non viene mai offerto al modello, a differenza di una regola di permesso, che rifiuta la chiamata quando viene fatta. |
browser | { "mode": "auto" } (predefinito) lascia scegliere all'agente tra il tuo browser, tramite l'estensione, e uno integrato. builtin, extension o off lo fissano. |
claudeAgent | Offre il tuo Claude Code come sub-agente e come @claude, pagato dal tuo piano Claude. Disattivato a meno che non sia impostato a true. |
imports | Legge le skill, gli agenti e i server MCP di Claude Code e di Codex da dove si trovano. Entrambi attivi a meno che non sia impostato a false. |
skillDirs, agentDirs | Altre directory in cui cercare skill e definizioni di sub-agenti. |
disabledSkills | Skill disattivate per nome. |
mcpServers, hooks, subagents, plugins, runtimePlugins | Vedi Plugin. |
schedules | Prompt eseguiti secondo una pianificazione cron. |
Sessioni e worktree
| Chiave | Cosa fa |
|---|
sessionDir | Dove vengono conservate sessioni e trascrizioni. Il predefinito è storage/ in ~/.oharness. Indicare un'altra directory parte da zero: nulla di ciò che è registrato nella posizione predefinita viene importato. |
sessionRetention | { "maxAgeDays": 90, "keep": 500 } elimina le sessioni più vecchie all'avvio. Non viene eliminato nulla se non lo imposti. |
worktree | Preparare un nuovo worktree git. copy elenca percorsi o glob copiati dal progetto quando il worktree ne è privo (predefinito .env*). setup è un comando shell eseguito nel nuovo worktree, come npm ci. |
memory, sync | Vedi Memoria e sincronizzazione. |
Fatturazione e log
| Chiave | Cosa fa |
|---|
team | Addebita l'utilizzo del piano ufficiale ai crediti di un team invece che ai tuoi. Il servizio verifica che tu faccia parte del team. Ammesso nella tua configurazione o in OHARNESS_TEAM, mai in un file di progetto. |
logLevel | debug, info, warn, error o silent. |
Variabili d'ambiente
Una variabile d'ambiente sostituisce la chiave di configurazione corrispondente, dove esiste.
| Variabile | Cosa fa |
|---|
OHARNESS_HOME | Usa un'altra directory al posto di ~/.oharness. |
OHARNESS_TEAM | Come team. |
OHARNESS_SYNC | 0, false, off o no disattiva la sincronizzazione qualunque cosa dica la configurazione. |
OHARNESS_SYNC_TOKEN | Credenziale di sincronizzazione, quando non è nella configurazione. |
OHARNESS_SITE_URL | Un indirizzo Cloud self-hosted o di sviluppo. |
OHARNESS_CATALOG | Usa questo file come catalogo dei modelli. |
OHARNESS_NO_BUILTIN_MODELS | 1 esclude il catalogo dei modelli incluso, così restano solo le tue voci. |
OHARNESS_NO_CLAUDE_AGENT | 1 non offre mai Claude Code come sub-agente. |
OHARNESS_BROWSER_PATH | Il binario di Chrome o Chromium che il browser integrato avvia. |
OHARNESS_BROWSER_HEADLESS | 0 dà al browser integrato una finestra visibile. |
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOME | Dove leggere i file di Claude Code e di Codex, quando non sono nella posizione abituale. |