De flesta inställningar finns på appens sida Inställningar. Den här sidan tar upp resten: nycklarna du skriver för hand i en konfigurationsfil, och miljövariablerna som harnessen läser. Nycklar som har en egen sida — leverantörer, minne, synkronisering, plugins — nämns här bara kort, med en länk till den sidan.
Var inställningarna finns
| Fil | Omfattning |
|---|
~/.oharness/config.json | Du, på den här datorn. Alla nycklar nedan kan ligga här. |
oharness.config.json (eller .oharness.json) i ett projekt | Alla som öppnar det projektet. |
Projektfilen slås ihop ovanpå din, så ett projekt kan skärpa eller justera det du har ställt in. Vissa nycklar läses medvetet inte från en projektfil, eftersom ett repository du klonar inte ska kunna ställa in dem åt dig:
team: vems krediter som förbrukassync.url, sync.token, sync.team: vart dina transkript skickasruntimePlugins: kod som körs på din dator- att slå på automatisk extrahering eller sammanslagning av minne, som förbrukar dina modellkrediter. Ett projekt får stänga av dem.
OHARNESS_HOME flyttar hela katalogen ~/.oharness. Se Konfigurationsfiler för de andra filerna i den.
{
"model": "sonnet",
"smallModel": "haiku",
"permissionMode": "auto",
"permissions": { "deny": ["Bash(git push --force*)"] },
"writableRoots": ["~/scratch"],
"maxTurns": 100,
"sessionRetention": { "maxAgeDays": 90 }
}
Modeller
| Nyckel | Vad den gör |
|---|
model | Modellen som nya konversationer startar med, via id eller alias. |
smallModel | Modellen för småjobb som inte behöver huvudmodellen: sammanfattningar vid kontextkomprimering, minnesextrahering, bakgrundsuppgifter som titlar, och granskaren i auto-läget. Utan den här nyckeln används konversationens egen modell, som kan vara betydligt dyrare än vad som behövs. |
thinking | Standard för resonemang: { "enabled": true, "effort": "high" }. effort anpassas efter vad modellen stöder. budgetTokens gäller modeller som tar en tokenbudget. display är "summarized" eller "omitted". |
cache | Promptcachning där leverantören stöder det. På som standard. |
models, providers, catalog, openAiCompatible, oauthProviders | Lägg till eller åsidosätt modeller och leverantörer. Se Leverantörer och modeller. |
Ställ in smallModel. Auto-läget anropar den före varje åtgärd det granskar, och komprimeringen anropar den i långa konversationer. En snabb, billig modell gör båda snabbare och håller nere kostnaden. Om id:t inte kan hittas loggar harnessen en varning och faller tillbaka på konversationens modell.
Behörigheter
| Nyckel | Vad den gör |
|---|
permissionMode | Läget som nya konversationer startar i: default, acceptEdits, plan, auto eller bypassPermissions. |
permissions | allow-, ask- och deny-regler. En deny-regel vinner över alla lägen, även Bypass. |
workspaceMode | Var skrivningar får hamna: read-only, workspace-write (standard: projektet plus writableRoots) eller full-access. Det här kontrollerar verktygens argument; det är ingen sandlåda i operativsystemet. |
writableRoots | Fler kataloger som agenten får skriva i. |
readableRoots | Fler kataloger som agenten får läsa men inte skriva i. |
audit | Sparar varje behörighetsbeslut tillsammans med dess session. På om den inte är satt till false. |
auditLog | Lägger också till varje beslut i den här filen, för en obevakad körning vars logg ska samlas in. |
Behörigheter förklarar lägena, regelsyntaxen och hur granskaren i auto-läget fattar beslut.
Turer och instruktioner
| Nyckel | Vad den gör |
|---|
maxTurns | Hur många modellanrop en prompt får ta innan agenten stannar och rapporterar. Standard 60. |
systemPrompt | Ersätter den inbyggda systemprompten. Sällan det du vill. |
appendSystemPrompt | Text som läggs till efter den inbyggda systemprompten. |
instructionsFile | En annan instruktionsfil för projektet än standardfilen, relativt projektets rot. |
| Nyckel | Vad den gör |
|---|
tools | { "allow": [...], "deny": [...] } efter verktygsnamn. Globmönster som mcp__github__* fungerar. deny tillämpas efter allow. Ett verktyg som utesluts här erbjuds aldrig modellen, till skillnad från en behörighetsregel, som nekar anropet först när det görs. |
browser | { "mode": "auto" } (standard) låter agenten välja mellan din webbläsare, via tillägget, och en inbyggd. builtin, extension eller off låser valet. |
claudeAgent | Erbjud din egen Claude Code som subagent och som @claude, betald av din Claude-plan. Av om den inte är satt till true. |
imports | Läs skills, agenter och MCP-servrar från Claude Code och Codex där de ligger. Båda på om den inte är satt till false. |
skillDirs, agentDirs | Fler kataloger att söka igenom efter skills och subagentdefinitioner. |
disabledSkills | Skills som stängts av via namn. |
mcpServers, hooks, subagents, plugins, runtimePlugins | Se Plugins. |
schedules | Prompter som körs enligt ett cron-schema. |
Sessioner och worktrees
| Nyckel | Vad den gör |
|---|
sessionDir | Var sessioner och transkript sparas. Standard är storage/ i ~/.oharness. Anger du en annan katalog börjar du från noll: inget som sparats på standardplatsen importeras. |
sessionRetention | { "maxAgeDays": 90, "keep": 500 } tar bort äldre sessioner vid start. Inget tas bort om du inte ställer in detta. |
worktree | Förbereder en ny git-worktree. copy listar sökvägar eller globmönster som kopieras från projektet när de saknas i worktreen (standard .env*). setup är ett skalkommando som körs i den nya worktreen, till exempel npm ci. |
memory, sync | Se Minne och synkronisering. |
Fakturering och loggar
| Nyckel | Vad den gör |
|---|
team | Debiterar användning på den officiella planen från ett teams krediter i stället för dina. Tjänsten kontrollerar att du är med i teamet. Tillåts i din egen konfiguration eller i OHARNESS_TEAM, aldrig i en projektfil. |
logLevel | debug, info, warn, error eller silent. |
Miljövariabler
En miljövariabel åsidosätter motsvarande konfigurationsnyckel, där en sådan finns.
| Variabel | Vad den gör |
|---|
OHARNESS_HOME | Använd en annan katalog i stället för ~/.oharness. |
OHARNESS_TEAM | Samma som team. |
OHARNESS_SYNC | 0, false, off eller no stänger av synkroniseringen oavsett vad konfigurationen säger. |
OHARNESS_SYNC_TOKEN | Inloggningsuppgift för synkronisering, när den inte finns i konfigurationen. |
OHARNESS_SITE_URL | En egenhostad Cloud-adress eller en för utveckling. |
OHARNESS_CATALOG | Använd den här filen som din modellkatalog. |
OHARNESS_NO_BUILTIN_MODELS | 1 utelämnar den medföljande modellkatalogen, så att bara dina egna poster finns kvar. |
OHARNESS_NO_CLAUDE_AGENT | 1 erbjuder aldrig Claude Code som subagent. |
OHARNESS_BROWSER_PATH | Den Chrome- eller Chromium-binär som den inbyggda webbläsaren startar. |
OHARNESS_BROWSER_HEADLESS | 0 ger den inbyggda webbläsaren ett synligt fönster. |
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOME | Var filerna för Claude Code och Codex ska läsas, när de inte ligger på den vanliga platsen. |