Geavanceerde instellingen

De meeste instellingen staan op de pagina Instellingen van de app. Deze pagina gaat over de rest: de sleutels die je met de hand in een configuratiebestand schrijft, en de omgevingsvariabelen die het harness leest. Sleutels met een eigen pagina — aanbieders, geheugen, synchronisatie, plugins — staan hier kort vermeld, met een link naar die pagina.

Waar instellingen staan

BestandBereik
~/.oharness/config.jsonJij, op deze computer. Elke sleutel hieronder kan hier staan.
oharness.config.json (of .oharness.json) in een projectIedereen die dat project opent.

Het projectbestand wordt over het jouwe heen samengevoegd, zodat een project strenger kan maken of kan bijstellen wat jij hebt ingesteld. Sommige sleutels worden bewust niet uit een projectbestand gelezen, omdat een repository die je kloont ze niet voor jou mag kunnen instellen:

  • team: wiens credits worden verbruikt
  • sync.url, sync.token, sync.team: waar je transcripties naartoe gaan
  • runtimePlugins: code die op je computer draait
  • automatische extractie of samenvoeging van geheugen aanzetten, wat je modeltegoed verbruikt. Een project mag ze wel uitzetten.

OHARNESS_HOME verplaatst de hele map ~/.oharness. Zie Configuratiebestanden voor de andere bestanden daarin.

{
  "model": "sonnet",
  "smallModel": "haiku",
  "permissionMode": "auto",
  "permissions": { "deny": ["Bash(git push --force*)"] },
  "writableRoots": ["~/scratch"],
  "maxTurns": 100,
  "sessionRetention": { "maxAgeDays": 90 }
}

Modellen

SleutelWat het doet
modelHet model waarmee nieuwe gesprekken starten, op id of alias.
smallModelHet model voor klusjes die het hoofdmodel niet nodig hebben: samenvattingen bij contextcompactie, geheugenextractie, achtergrondtaken zoals titels, en de beoordelaar van de automodus. Zonder deze sleutel gebruiken ze het model van het gesprek zelf, dat veel duurder kan zijn dan nodig.
thinkingStandaard redeneren: { "enabled": true, "effort": "high" }. effort wordt aangepast aan wat het model ondersteunt. budgetTokens geldt voor modellen die een tokenbudget accepteren. display is "summarized" of "omitted".
cachePrompt caching waar de aanbieder dat ondersteunt. Standaard aan.
models, providers, catalog, openAiCompatible, oauthProvidersModellen en aanbieders toevoegen of overschrijven. Zie Aanbieders en modellen.

Stel smallModel in. De automodus roept het aan vóór elke actie die hij beoordeelt, en compactie roept het aan bij lange gesprekken. Een snel, goedkoop model maakt beide sneller en houdt de kosten laag. Kan de id niet worden gevonden, dan logt het harness een waarschuwing en valt het terug op het model van het gesprek.

Permissies

SleutelWat het doet
permissionModeDe modus waarin nieuwe gesprekken starten: default, acceptEdits, plan, auto of bypassPermissions.
permissionsallow-, ask- en deny-regels. Een deny-regel wint van elke modus, ook van Bypass.
workspaceModeWaar schrijfacties terecht mogen komen: read-only, workspace-write (standaard: het project plus writableRoots) of full-access. Dit controleert de argumenten van tools; het is geen sandbox van het besturingssysteem.
writableRootsExtra mappen waarin de agent mag schrijven.
readableRootsExtra mappen die de agent mag lezen maar niet beschrijven.
auditHoudt bij elke sessie een overzicht bij van alle permissiebeslissingen. Aan, tenzij op false gezet.
auditLogVoegt elke beslissing ook toe aan dit bestand, voor een onbewaakte run waarvan het overzicht verzameld moet worden.

Permissies legt de modi uit, de regelsyntaxis en hoe de beoordelaar van de automodus beslist.

Beurten en instructies

SleutelWat het doet
maxTurnsHoeveel modelaanroepen één prompt mag kosten voordat de agent stopt en verslag doet. Standaard 60.
systemPromptVervangt de ingebouwde systeemprompt. Zelden wat je wilt.
appendSystemPromptTekst die na de ingebouwde systeemprompt wordt toegevoegd.
instructionsFileEen ander projectinstructiebestand dan het standaardbestand, relatief aan de projectmap.

Tools en uitbreidingen

SleutelWat het doet
tools{ "allow": [...], "deny": [...] } op toolnaam. Globs zoals mcp__github__* werken. deny geldt na allow. Een tool die hier wegvalt, wordt nooit aan het model aangeboden — anders dan bij een permissieregel, die de aanroep pas weigert als die wordt gedaan.
browser{ "mode": "auto" } (standaard) laat de agent kiezen tussen je eigen browser, via de extensie, en een ingebouwde. builtin, extension of off legt de keuze vast.
claudeAgentBiedt je eigen Claude Code aan als subagent en als @claude, betaald uit je Claude-abonnement. Uit, tenzij op true gezet.
importsLeest de skills, agents en MCP-servers van Claude Code en Codex op hun eigen plek. Beide aan, tenzij op false gezet.
skillDirs, agentDirsExtra mappen om te doorzoeken op skills en subagentdefinities.
disabledSkillsSkills die op naam zijn uitgezet.
mcpServers, hooks, subagents, plugins, runtimePluginsZie Plugins.
schedulesPrompts die volgens een cron-planning draaien.

Sessies en worktrees

SleutelWat het doet
sessionDirWaar sessies en transcripties worden bewaard. Standaard storage/ in ~/.oharness. Kies je een andere map, dan begin je leeg: niets uit de standaardlocatie wordt geïmporteerd.
sessionRetention{ "maxAgeDays": 90, "keep": 500 } verwijdert oudere sessies bij het opstarten. Zonder deze instelling wordt niets verwijderd.
worktreeEen nieuwe git-worktree klaarzetten. copy noemt paden of globs die uit het project worden gekopieerd als ze in de worktree ontbreken (standaard .env*). setup is een shellcommando dat in de nieuwe worktree draait, zoals npm ci.
memory, syncZie Geheugen en synchronisatie.

Facturering en logs

SleutelWat het doet
teamBrengt gebruik op het officiële abonnement in rekening bij de credits van een team in plaats van de jouwe. De dienst controleert of je lid bent van het team. Toegestaan in je eigen configuratie of OHARNESS_TEAM, nooit in een projectbestand.
logLeveldebug, info, warn, error of silent.

Omgevingsvariabelen

Een omgevingsvariabele overschrijft de bijbehorende configuratiesleutel, als die er is.

VariabeleWat het doet
OHARNESS_HOMEGebruikt een andere map in plaats van ~/.oharness.
OHARNESS_TEAMHetzelfde als team.
OHARNESS_SYNC0, false, off of no zet synchronisatie uit, wat de configuratie ook zegt.
OHARNESS_SYNC_TOKENCredential voor synchronisatie, als die niet in de configuratie staat.
OHARNESS_SITE_URLEen zelfgehost of ontwikkeladres voor Cloud.
OHARNESS_CATALOGGebruikt dit bestand als je modelcatalogus.
OHARNESS_NO_BUILTIN_MODELS1 laat de meegeleverde modelcatalogus weg, zodat alleen je eigen items overblijven.
OHARNESS_NO_CLAUDE_AGENT1 biedt Claude Code nooit aan als subagent.
OHARNESS_BROWSER_PATHHet Chrome- of Chromium-programma dat de ingebouwde browser start.
OHARNESS_BROWSER_HEADLESS0 geeft de ingebouwde browser een zichtbaar venster.
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOMEWaar de bestanden van Claude Code en Codex gelezen worden, als ze niet op de gebruikelijke plek staan.