Avancerade inställningar

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

FilOmfattning
~/.oharness/config.jsonDu, på den här datorn. Alla nycklar nedan kan ligga här.
oharness.config.json (eller .oharness.json) i ett projektAlla 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örbrukas
  • sync.url, sync.token, sync.team: vart dina transkript skickas
  • runtimePlugins: 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

NyckelVad den gör
modelModellen som nya konversationer startar med, via id eller alias.
smallModelModellen 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.
thinkingStandard 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".
cachePromptcachning där leverantören stöder det. På som standard.
models, providers, catalog, openAiCompatible, oauthProvidersLä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

NyckelVad den gör
permissionModeLäget som nya konversationer startar i: default, acceptEdits, plan, auto eller bypassPermissions.
permissionsallow-, ask- och deny-regler. En deny-regel vinner över alla lägen, även Bypass.
workspaceModeVar 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.
writableRootsFler kataloger som agenten får skriva i.
readableRootsFler kataloger som agenten får läsa men inte skriva i.
auditSparar varje behörighetsbeslut tillsammans med dess session. På om den inte är satt till false.
auditLogLä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

NyckelVad den gör
maxTurnsHur många modellanrop en prompt får ta innan agenten stannar och rapporterar. Standard 60.
systemPromptErsätter den inbyggda systemprompten. Sällan det du vill.
appendSystemPromptText som läggs till efter den inbyggda systemprompten.
instructionsFileEn annan instruktionsfil för projektet än standardfilen, relativt projektets rot.

Verktyg och tillägg

NyckelVad 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.
claudeAgentErbjud din egen Claude Code som subagent och som @claude, betald av din Claude-plan. Av om den inte är satt till true.
importsLä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, agentDirsFler kataloger att söka igenom efter skills och subagentdefinitioner.
disabledSkillsSkills som stängts av via namn.
mcpServers, hooks, subagents, plugins, runtimePluginsSe Plugins.
schedulesPrompter som körs enligt ett cron-schema.

Sessioner och worktrees

NyckelVad den gör
sessionDirVar 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.
worktreeFö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, syncSe Minne och synkronisering.

Fakturering och loggar

NyckelVad den gör
teamDebiterar 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.
logLeveldebug, info, warn, error eller silent.

Miljövariabler

En miljövariabel åsidosätter motsvarande konfigurationsnyckel, där en sådan finns.

VariabelVad den gör
OHARNESS_HOMEAnvänd en annan katalog i stället för ~/.oharness.
OHARNESS_TEAMSamma som team.
OHARNESS_SYNC0, false, off eller no stänger av synkroniseringen oavsett vad konfigurationen säger.
OHARNESS_SYNC_TOKENInloggningsuppgift för synkronisering, när den inte finns i konfigurationen.
OHARNESS_SITE_URLEn egenhostad Cloud-adress eller en för utveckling.
OHARNESS_CATALOGAnvänd den här filen som din modellkatalog.
OHARNESS_NO_BUILTIN_MODELS1 utelämnar den medföljande modellkatalogen, så att bara dina egna poster finns kvar.
OHARNESS_NO_CLAUDE_AGENT1 erbjuder aldrig Claude Code som subagent.
OHARNESS_BROWSER_PATHDen Chrome- eller Chromium-binär som den inbyggda webbläsaren startar.
OHARNESS_BROWSER_HEADLESS0 ger den inbyggda webbläsaren ett synligt fönster.
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOMEVar filerna för Claude Code och Codex ska läsas, när de inte ligger på den vanliga platsen.