Ustawienia zaawansowane

Większość ustawień znajdziesz na stronie Ustawienia w aplikacji. Ta strona opisuje pozostałe: klucze, które wpisujesz ręcznie w pliku konfiguracyjnym, oraz zmienne środowiskowe, które czyta harness. Klucze, które mają własną stronę — dostawcy, pamięć, synchronizacja, wtyczki — są tu tylko krótko wymienione, z linkiem do tej strony.

Gdzie są ustawienia

PlikZakres
~/.oharness/config.jsonTy, na tym komputerze. Każdy klucz poniżej może się tu znaleźć.
oharness.config.json (lub .oharness.json) w projekcieKażdy, kto otwiera ten projekt.

Plik projektu jest nakładany na twój, więc projekt może zaostrzyć lub dostroić to, co ustawiłeś. Niektóre klucze są celowo pomijane w pliku projektu, bo sklonowane repozytorium nie powinno móc ustawić ich za ciebie:

  • team: czyje punkty są zużywane
  • sync.url, sync.token, sync.team: dokąd trafiają twoje transkrypcje
  • runtimePlugins: kod uruchamiany na twoim komputerze
  • włączenie automatycznej ekstrakcji lub scalania pamięci, które zużywa twoje środki na modele. Projekt może je wyłączyć.

OHARNESS_HOME przenosi cały katalog ~/.oharness. Pozostałe pliki w nim opisuje strona Pliki konfiguracyjne.

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

Modele

KluczCo robi
modelModel, od którego zaczynają się nowe rozmowy, podany przez id lub alias.
smallModelModel do drobnych zadań, które nie wymagają głównego: podsumowań przy kompaktowaniu kontekstu, ekstrakcji pamięci, zadań w tle, takich jak tytuły, oraz recenzenta trybu auto. Bez tego klucza używają one modelu samej rozmowy, który może być znacznie droższy, niż potrzeba.
thinkingDomyślne rozumowanie: { "enabled": true, "effort": "high" }. effort jest dopasowywany do tego, co obsługuje model. budgetTokens dotyczy modeli przyjmujących budżet tokenów. display to "summarized" lub "omitted".
cacheCache'owanie promptów tam, gdzie dostawca je obsługuje. Domyślnie włączone.
models, providers, catalog, openAiCompatible, oauthProvidersDodawanie lub nadpisywanie modeli i dostawców. Zobacz Dostawcy i modele.

Ustaw smallModel. Tryb auto wywołuje go przed każdą sprawdzaną akcją, a kompaktowanie — przy długich rozmowach. Szybki, tani model przyspiesza jedno i drugie i utrzymuje niski koszt. Jeśli id nie da się rozpoznać, harness zapisuje w logu ostrzeżenie i wraca do modelu rozmowy.

Uprawnienia

KluczCo robi
permissionModeTryb, w którym zaczynają się nowe rozmowy: default, acceptEdits, plan, auto lub bypassPermissions.
permissionsReguły allow, ask i deny. Reguła deny wygrywa z każdym trybem, także z Bypass.
workspaceModeGdzie mogą trafiać zapisy: read-only, workspace-write (domyślnie: projekt plus writableRoots) lub full-access. To sprawdza argumenty narzędzi; nie jest piaskownicą systemu operacyjnego.
writableRootsDodatkowe katalogi, w których agent może zapisywać.
readableRootsDodatkowe katalogi, które agent może czytać, ale nie zapisywać.
auditZapisuje każdą decyzję o uprawnieniach razem z jej sesją. Włączone, chyba że ustawisz false.
auditLogDodatkowo dopisuje każdą decyzję do tego pliku — przy uruchomieniu bez nadzoru, którego zapis trzeba zebrać.

Uprawnienia objaśniają tryby, składnię reguł i to, jak decyduje recenzent trybu auto.

Tury i instrukcje

KluczCo robi
maxTurnsIle wywołań modelu może zająć jeden prompt, zanim agent się zatrzyma i zda raport. Domyślnie 60.
systemPromptZastępuje wbudowany prompt systemowy. Rzadko o to chodzi.
appendSystemPromptTekst dodawany po wbudowanym prompcie systemowym.
instructionsFilePlik instrukcji projektu inny niż domyślny, względem katalogu głównego projektu.

Narzędzia i rozszerzenia

KluczCo robi
tools{ "allow": [...], "deny": [...] } według nazwy narzędzia. Działają wzorce glob, takie jak mcp__github__*. deny jest stosowane po allow. Narzędzie pominięte tutaj nigdy nie jest oferowane modelowi — inaczej niż przy regule uprawnień, która odrzuca wywołanie dopiero w chwili jego wykonania.
browser{ "mode": "auto" } (domyślnie) pozwala agentowi wybrać między twoją przeglądarką, przez rozszerzenie, a wbudowaną. builtin, extension lub off ustala wybór na stałe.
claudeAgentUdostępnia twój własny Claude Code jako subagenta i jako @claude, opłacanego z twojego planu Claude. Wyłączone, chyba że ustawisz true.
importsCzyta skille, agentów i serwery MCP Claude Code i Codex z miejsc, w których się znajdują. Oba włączone, chyba że ustawisz false.
skillDirs, agentDirsDodatkowe katalogi przeszukiwane pod kątem skilli i definicji subagentów.
disabledSkillsSkille wyłączone po nazwie.
mcpServers, hooks, subagents, plugins, runtimePluginsZobacz Wtyczki.
schedulesPrompty uruchamiane według harmonogramu cron.

Sesje i worktree

KluczCo robi
sessionDirGdzie przechowywane są sesje i transkrypcje. Domyślnie storage/ w ~/.oharness. Wskazanie innego katalogu oznacza start od zera: nic z domyślnej lokalizacji nie jest importowane.
sessionRetention{ "maxAgeDays": 90, "keep": 500 } usuwa starsze sesje przy uruchomieniu. Bez tego ustawienia nic nie jest usuwane.
worktreePrzygotowanie nowego worktree git. copy wymienia ścieżki lub wzorce glob kopiowane z projektu, gdy brakuje ich w worktree (domyślnie .env*). setup to polecenie powłoki uruchamiane w nowym worktree, np. npm ci.
memory, syncZobacz Pamięć i synchronizacja.

Rozliczenia i logi

KluczCo robi
teamObciąża punktami zespołu zamiast twoimi za użycie w oficjalnym planie. Usługa sprawdza, czy należysz do zespołu. Dozwolone we własnej konfiguracji lub w OHARNESS_TEAM, nigdy w pliku projektu.
logLeveldebug, info, warn, error lub silent.

Zmienne środowiskowe

Zmienna środowiskowa nadpisuje odpowiadający jej klucz konfiguracji, jeśli taki istnieje.

ZmiennaCo robi
OHARNESS_HOMEUżywa innego katalogu zamiast ~/.oharness.
OHARNESS_TEAMTo samo co team.
OHARNESS_SYNC0, false, off lub no wyłącza synchronizację niezależnie od konfiguracji.
OHARNESS_SYNC_TOKENDane uwierzytelniające synchronizacji, jeśli nie ma ich w konfiguracji.
OHARNESS_SITE_URLAdres Cloud hostowanego samodzielnie lub deweloperskiego.
OHARNESS_CATALOGUżywa tego pliku jako katalogu modeli.
OHARNESS_NO_BUILTIN_MODELS1 pomija dołączony katalog modeli, więc zostają tylko twoje własne wpisy.
OHARNESS_NO_CLAUDE_AGENT1 nigdy nie udostępnia Claude Code jako subagenta.
OHARNESS_BROWSER_PATHPlik wykonywalny Chrome lub Chromium, który uruchamia wbudowana przeglądarka.
OHARNESS_BROWSER_HEADLESS0 daje wbudowanej przeglądarce widoczne okno.
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOMESkąd czytać pliki Claude Code i Codex, gdy nie leżą w zwykłym miejscu.