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
| Datei | Geltungsbereich |
|---|
~/.oharness/config.json | Sie, auf diesem Rechner. Jeder der folgenden Schlüssel kann hier stehen. |
oharness.config.json (oder .oharness.json) in einem Projekt | Alle, 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 werdensync.url, sync.token, sync.team: wohin Ihre Verläufe gehenruntimePlugins: 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üssel | Wirkung |
|---|
model | Das Modell, mit dem neue Gespräche starten, als ID oder Alias. |
smallModel | Das 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. |
thinking | Standard-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". |
cache | Prompt-Caching, wo der Anbieter es unterstützt. Standardmäßig aktiv. |
models, providers, catalog, openAiCompatible, oauthProviders | Modelle 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üssel | Wirkung |
|---|
permissionMode | Der Modus, in dem neue Gespräche starten: default, acceptEdits, plan, auto oder bypassPermissions. |
permissions | allow-, ask- und deny-Regeln. Eine deny-Regel schlägt jeden Modus, auch Bypass. |
workspaceMode | Wohin 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. |
writableRoots | Weitere Verzeichnisse, in die der Agent schreiben darf. |
readableRoots | Weitere Verzeichnisse, die der Agent lesen, aber nicht beschreiben darf. |
audit | Jede Berechtigungsentscheidung zusammen mit ihrer Sitzung festhalten. Aktiv, solange nicht auf false gesetzt. |
auditLog | Jede 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üssel | Wirkung |
|---|
maxTurns | Wie viele Modellaufrufe ein Prompt höchstens auslösen darf, bevor der Agent anhält und berichtet. Standard 60. |
systemPrompt | Ersetzt den eingebauten System-Prompt. Selten das, was Sie wollen. |
appendSystemPrompt | Text, der an den eingebauten System-Prompt angehängt wird. |
instructionsFile | Eine andere Projekt-Anweisungsdatei als die Standarddatei, relativ zum Projektstamm. |
| Schlüssel | Wirkung |
|---|
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. |
claudeAgent | Bietet Ihr eigenes Claude Code als Subagent und als @claude an, bezahlt über Ihren Claude-Tarif. Aus, solange nicht auf true gesetzt. |
imports | Liest Skills, Agents und MCP-Server von Claude Code und Codex dort, wo sie liegen. Beides aktiv, solange nicht auf false gesetzt. |
skillDirs, agentDirs | Weitere Verzeichnisse, die nach Skills und Subagent-Definitionen durchsucht werden. |
disabledSkills | Per Name abgeschaltete Skills. |
mcpServers, hooks, subagents, plugins, runtimePlugins | Siehe Plugins. |
schedules | Prompts, die nach einem Cron-Zeitplan laufen. |
Sitzungen und Worktrees
| Schlüssel | Wirkung |
|---|
sessionDir | Wo 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. |
worktree | Einen 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, sync | Siehe Memory und Sync. |
Abrechnung und Logs
| Schlüssel | Wirkung |
|---|
team | Die 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. |
logLevel | debug, info, warn, error oder silent. |
Umgebungsvariablen
Eine Umgebungsvariable überschreibt den passenden Konfigurationsschlüssel, sofern es einen gibt.
| Variable | Wirkung |
|---|
OHARNESS_HOME | Ein anderes Verzeichnis statt ~/.oharness verwenden. |
OHARNESS_TEAM | Wie team. |
OHARNESS_SYNC | 0, false, off oder no schaltet Sync ab, unabhängig von der Konfiguration. |
OHARNESS_SYNC_TOKEN | Sync-Anmeldedaten, wenn sie nicht in der Konfiguration stehen. |
OHARNESS_SITE_URL | Eine selbst gehostete oder Entwicklungs-Cloud-Adresse. |
OHARNESS_CATALOG | Diese Datei als Ihren Modellkatalog verwenden. |
OHARNESS_NO_BUILTIN_MODELS | 1 lässt den mitgelieferten Modellkatalog weg, sodass nur Ihre eigenen Einträge übrig bleiben. |
OHARNESS_NO_CLAUDE_AGENT | 1 bietet Claude Code nie als Subagent an. |
OHARNESS_BROWSER_PATH | Die Chrome- oder Chromium-Programmdatei, die der eingebaute Browser startet. |
OHARNESS_BROWSER_HEADLESS | 0 gibt dem eingebauten Browser ein sichtbares Fenster. |
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOME | Wo die Dateien von Claude Code und Codex gelesen werden, wenn sie nicht am üblichen Ort liegen. |