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
| Bestand | Bereik |
|---|
~/.oharness/config.json | Jij, op deze computer. Elke sleutel hieronder kan hier staan. |
oharness.config.json (of .oharness.json) in een project | Iedereen 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 verbruiktsync.url, sync.token, sync.team: waar je transcripties naartoe gaanruntimePlugins: 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
| Sleutel | Wat het doet |
|---|
model | Het model waarmee nieuwe gesprekken starten, op id of alias. |
smallModel | Het 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. |
thinking | Standaard 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". |
cache | Prompt caching waar de aanbieder dat ondersteunt. Standaard aan. |
models, providers, catalog, openAiCompatible, oauthProviders | Modellen 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
| Sleutel | Wat het doet |
|---|
permissionMode | De modus waarin nieuwe gesprekken starten: default, acceptEdits, plan, auto of bypassPermissions. |
permissions | allow-, ask- en deny-regels. Een deny-regel wint van elke modus, ook van Bypass. |
workspaceMode | Waar 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. |
writableRoots | Extra mappen waarin de agent mag schrijven. |
readableRoots | Extra mappen die de agent mag lezen maar niet beschrijven. |
audit | Houdt bij elke sessie een overzicht bij van alle permissiebeslissingen. Aan, tenzij op false gezet. |
auditLog | Voegt 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
| Sleutel | Wat het doet |
|---|
maxTurns | Hoeveel modelaanroepen één prompt mag kosten voordat de agent stopt en verslag doet. Standaard 60. |
systemPrompt | Vervangt de ingebouwde systeemprompt. Zelden wat je wilt. |
appendSystemPrompt | Tekst die na de ingebouwde systeemprompt wordt toegevoegd. |
instructionsFile | Een ander projectinstructiebestand dan het standaardbestand, relatief aan de projectmap. |
| Sleutel | Wat 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. |
claudeAgent | Biedt je eigen Claude Code aan als subagent en als @claude, betaald uit je Claude-abonnement. Uit, tenzij op true gezet. |
imports | Leest de skills, agents en MCP-servers van Claude Code en Codex op hun eigen plek. Beide aan, tenzij op false gezet. |
skillDirs, agentDirs | Extra mappen om te doorzoeken op skills en subagentdefinities. |
disabledSkills | Skills die op naam zijn uitgezet. |
mcpServers, hooks, subagents, plugins, runtimePlugins | Zie Plugins. |
schedules | Prompts die volgens een cron-planning draaien. |
Sessies en worktrees
| Sleutel | Wat het doet |
|---|
sessionDir | Waar 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. |
worktree | Een 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, sync | Zie Geheugen en synchronisatie. |
Facturering en logs
| Sleutel | Wat het doet |
|---|
team | Brengt 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. |
logLevel | debug, info, warn, error of silent. |
Omgevingsvariabelen
Een omgevingsvariabele overschrijft de bijbehorende configuratiesleutel, als die er is.
| Variabele | Wat het doet |
|---|
OHARNESS_HOME | Gebruikt een andere map in plaats van ~/.oharness. |
OHARNESS_TEAM | Hetzelfde als team. |
OHARNESS_SYNC | 0, false, off of no zet synchronisatie uit, wat de configuratie ook zegt. |
OHARNESS_SYNC_TOKEN | Credential voor synchronisatie, als die niet in de configuratie staat. |
OHARNESS_SITE_URL | Een zelfgehost of ontwikkeladres voor Cloud. |
OHARNESS_CATALOG | Gebruikt dit bestand als je modelcatalogus. |
OHARNESS_NO_BUILTIN_MODELS | 1 laat de meegeleverde modelcatalogus weg, zodat alleen je eigen items overblijven. |
OHARNESS_NO_CLAUDE_AGENT | 1 biedt Claude Code nooit aan als subagent. |
OHARNESS_BROWSER_PATH | Het Chrome- of Chromium-programma dat de ingebouwde browser start. |
OHARNESS_BROWSER_HEADLESS | 0 geeft de ingebouwde browser een zichtbaar venster. |
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOME | Waar de bestanden van Claude Code en Codex gelezen worden, als ze niet op de gebruikelijke plek staan. |