Erweiterte Einstellungen

Die meisten Einstellungen finden Sie auf der Einstellungsseite der App. Diese Seite behandelt die übrigen: die Schlüssel, die Sie von Hand in eine Konfigurationsdatei schreiben, und die Umgebungsvariablen, die das Harness liest. Schlüssel mit einer eigenen Seite – Anbieter, Memory, Sync, Plugins – werden hier nur kurz aufgeführt, mit einem Link auf die jeweilige Seite.

Wo Einstellungen liegen

DateiGeltungsbereich
~/.oharness/config.jsonSie, auf diesem Rechner. Jeder der folgenden Schlüssel kann hier stehen.
oharness.config.json (oder .oharness.json) in einem ProjektAlle, die dieses Projekt öffnen.

Die Projektdatei wird über Ihre Konfiguration gelegt, sodass ein Projekt Ihre Einstellungen verschärfen oder feinjustieren kann. Einige Schlüssel sind in einer Projektdatei bewusst nicht erlaubt, weil ein geklontes Repository sie nicht für Sie festlegen können soll:

  • team: wessen Credits verbraucht werden
  • sync.url, sync.token, sync.team: wohin Ihre Verläufe gehen
  • runtimePlugins: Code, der auf Ihrem Rechner läuft
  • das Einschalten der automatischen Extraktion oder Zusammenführung von Memory, die Ihre Modell-Credits verbraucht. Ein Projekt darf sie abschalten.

OHARNESS_HOME verlegt das gesamte Verzeichnis ~/.oharness. Die übrigen Dateien darin beschreibt Konfigurationsdateien.

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

Modelle

SchlüsselWirkung
modelDas Modell, mit dem neue Gespräche starten, als ID oder Alias.
smallModelDas Modell für Nebenaufgaben, die das Hauptmodell nicht brauchen: Zusammenfassungen bei der Kontextverdichtung, Memory-Extraktion, Hintergrundaufgaben wie Titel und der Prüfer des Auto-Modus. Ohne diesen Schlüssel nutzen sie das Modell des Gesprächs, das deutlich teurer sein kann als nötig.
thinkingStandard-Reasoning: { "enabled": true, "effort": "high" }. effort wird an das angepasst, was das Modell unterstützt. budgetTokens gilt für Modelle, die ein Token-Budget annehmen. display ist "summarized" oder "omitted".
cachePrompt-Caching, wo der Anbieter es unterstützt. Standardmäßig aktiv.
models, providers, catalog, openAiCompatible, oauthProvidersModelle und Anbieter hinzufügen oder überschreiben. Siehe Anbieter und Modelle.

Setzen Sie smallModel. Der Auto-Modus ruft es vor jeder Aktion auf, die er prüft, und die Verdichtung ruft es bei langen Gesprächen auf. Ein schnelles, günstiges Modell macht beides schneller und hält die Kosten niedrig. Lässt sich die ID nicht auflösen, protokolliert das Harness eine Warnung und greift auf das Modell des Gesprächs zurück.

Berechtigungen

SchlüsselWirkung
permissionModeDer Modus, in dem neue Gespräche starten: default, acceptEdits, plan, auto oder bypassPermissions.
permissionsallow-, ask- und deny-Regeln. Eine deny-Regel schlägt jeden Modus, auch Bypass.
workspaceModeWohin geschrieben werden darf: read-only, workspace-write (Standard: das Projekt plus writableRoots) oder full-access. Geprüft werden Tool-Argumente; das ist keine Sandbox des Betriebssystems.
writableRootsWeitere Verzeichnisse, in die der Agent schreiben darf.
readableRootsWeitere Verzeichnisse, die der Agent lesen, aber nicht beschreiben darf.
auditJede Berechtigungsentscheidung zusammen mit ihrer Sitzung festhalten. Aktiv, solange nicht auf false gesetzt.
auditLogJede Entscheidung zusätzlich an diese Datei anhängen – für einen unbeaufsichtigten Lauf, dessen Protokoll eingesammelt werden soll.

Berechtigungen erklärt die Modi, die Regelsyntax und wie der Prüfer des Auto-Modus entscheidet.

Züge und Anweisungen

SchlüsselWirkung
maxTurnsWie viele Modellaufrufe ein Prompt höchstens auslösen darf, bevor der Agent anhält und berichtet. Standard 60.
systemPromptErsetzt den eingebauten System-Prompt. Selten das, was Sie wollen.
appendSystemPromptText, der an den eingebauten System-Prompt angehängt wird.
instructionsFileEine andere Projekt-Anweisungsdatei als die Standarddatei, relativ zum Projektstamm.

Tools und Erweiterungen

SchlüsselWirkung
tools{ "allow": [...], "deny": [...] } nach Tool-Name. Globs wie mcp__github__* funktionieren. deny wird nach allow angewendet. Ein hier ausgeschlossenes Tool wird dem Modell gar nicht erst angeboten – anders als bei einer Berechtigungsregel, die den Aufruf erst ablehnt, wenn er erfolgt.
browser{ "mode": "auto" } (Standard) lässt den Agenten wählen zwischen Ihrem Browser, über die Erweiterung, und einem eingebauten. builtin, extension oder off legt ihn fest.
claudeAgentBietet Ihr eigenes Claude Code als Subagent und als @claude an, bezahlt über Ihren Claude-Tarif. Aus, solange nicht auf true gesetzt.
importsLiest Skills, Agents und MCP-Server von Claude Code und Codex dort, wo sie liegen. Beides aktiv, solange nicht auf false gesetzt.
skillDirs, agentDirsWeitere Verzeichnisse, die nach Skills und Subagent-Definitionen durchsucht werden.
disabledSkillsPer Name abgeschaltete Skills.
mcpServers, hooks, subagents, plugins, runtimePluginsSiehe Plugins.
schedulesPrompts, die nach einem Cron-Zeitplan laufen.

Sitzungen und Worktrees

SchlüsselWirkung
sessionDirWo Sitzungen und Verläufe gespeichert werden. Standard ist storage/ in ~/.oharness. Ein anderes Verzeichnis beginnt leer: Nichts aus dem Standardort wird übernommen.
sessionRetention{ "maxAgeDays": 90, "keep": 500 } löscht ältere Sitzungen beim Start. Ohne diese Einstellung wird nichts gelöscht.
worktreeEinen neuen Git-Worktree vorbereiten. copy listet Pfade oder Globs, die aus dem Projekt kopiert werden, wenn sie im Worktree fehlen (Standard .env*). setup ist ein Shell-Befehl, der im neuen Worktree läuft, etwa npm ci.
memory, syncSiehe Memory und Sync.

Abrechnung und Logs

SchlüsselWirkung
teamDie Nutzung des offiziellen Tarifs den Credits eines Teams statt Ihren eigenen belasten. Der Dienst prüft, dass Sie Mitglied des Teams sind. Erlaubt in Ihrer eigenen Konfiguration oder über OHARNESS_TEAM, nie in einer Projektdatei.
logLeveldebug, info, warn, error oder silent.

Umgebungsvariablen

Eine Umgebungsvariable überschreibt den passenden Konfigurationsschlüssel, sofern es einen gibt.

VariableWirkung
OHARNESS_HOMEEin anderes Verzeichnis statt ~/.oharness verwenden.
OHARNESS_TEAMWie team.
OHARNESS_SYNC0, false, off oder no schaltet Sync ab, unabhängig von der Konfiguration.
OHARNESS_SYNC_TOKENSync-Anmeldedaten, wenn sie nicht in der Konfiguration stehen.
OHARNESS_SITE_URLEine selbst gehostete oder Entwicklungs-Cloud-Adresse.
OHARNESS_CATALOGDiese Datei als Ihren Modellkatalog verwenden.
OHARNESS_NO_BUILTIN_MODELS1 lässt den mitgelieferten Modellkatalog weg, sodass nur Ihre eigenen Einträge übrig bleiben.
OHARNESS_NO_CLAUDE_AGENT1 bietet Claude Code nie als Subagent an.
OHARNESS_BROWSER_PATHDie Chrome- oder Chromium-Programmdatei, die der eingebaute Browser startet.
OHARNESS_BROWSER_HEADLESS0 gibt dem eingebauten Browser ein sichtbares Fenster.
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOMEWo die Dateien von Claude Code und Codex gelesen werden, wenn sie nicht am üblichen Ort liegen.