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
| Plik | Zakres |
|---|
~/.oharness/config.json | Ty, na tym komputerze. Każdy klucz poniżej może się tu znaleźć. |
oharness.config.json (lub .oharness.json) w projekcie | Każ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żywanesync.url, sync.token, sync.team: dokąd trafiają twoje transkrypcjeruntimePlugins: 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
| Klucz | Co robi |
|---|
model | Model, od którego zaczynają się nowe rozmowy, podany przez id lub alias. |
smallModel | Model 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. |
thinking | Domyś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". |
cache | Cache'owanie promptów tam, gdzie dostawca je obsługuje. Domyślnie włączone. |
models, providers, catalog, openAiCompatible, oauthProviders | Dodawanie 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
| Klucz | Co robi |
|---|
permissionMode | Tryb, w którym zaczynają się nowe rozmowy: default, acceptEdits, plan, auto lub bypassPermissions. |
permissions | Reguły allow, ask i deny. Reguła deny wygrywa z każdym trybem, także z Bypass. |
workspaceMode | Gdzie 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. |
writableRoots | Dodatkowe katalogi, w których agent może zapisywać. |
readableRoots | Dodatkowe katalogi, które agent może czytać, ale nie zapisywać. |
audit | Zapisuje każdą decyzję o uprawnieniach razem z jej sesją. Włączone, chyba że ustawisz false. |
auditLog | Dodatkowo 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
| Klucz | Co robi |
|---|
maxTurns | Ile wywołań modelu może zająć jeden prompt, zanim agent się zatrzyma i zda raport. Domyślnie 60. |
systemPrompt | Zastępuje wbudowany prompt systemowy. Rzadko o to chodzi. |
appendSystemPrompt | Tekst dodawany po wbudowanym prompcie systemowym. |
instructionsFile | Plik instrukcji projektu inny niż domyślny, względem katalogu głównego projektu. |
| Klucz | Co 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. |
claudeAgent | Udostępnia twój własny Claude Code jako subagenta i jako @claude, opłacanego z twojego planu Claude. Wyłączone, chyba że ustawisz true. |
imports | Czyta 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, agentDirs | Dodatkowe katalogi przeszukiwane pod kątem skilli i definicji subagentów. |
disabledSkills | Skille wyłączone po nazwie. |
mcpServers, hooks, subagents, plugins, runtimePlugins | Zobacz Wtyczki. |
schedules | Prompty uruchamiane według harmonogramu cron. |
Sesje i worktree
| Klucz | Co robi |
|---|
sessionDir | Gdzie 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. |
worktree | Przygotowanie 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, sync | Zobacz Pamięć i synchronizacja. |
Rozliczenia i logi
| Klucz | Co robi |
|---|
team | Obciąż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. |
logLevel | debug, info, warn, error lub silent. |
Zmienne środowiskowe
Zmienna środowiskowa nadpisuje odpowiadający jej klucz konfiguracji, jeśli taki istnieje.
| Zmienna | Co robi |
|---|
OHARNESS_HOME | Używa innego katalogu zamiast ~/.oharness. |
OHARNESS_TEAM | To samo co team. |
OHARNESS_SYNC | 0, false, off lub no wyłącza synchronizację niezależnie od konfiguracji. |
OHARNESS_SYNC_TOKEN | Dane uwierzytelniające synchronizacji, jeśli nie ma ich w konfiguracji. |
OHARNESS_SITE_URL | Adres Cloud hostowanego samodzielnie lub deweloperskiego. |
OHARNESS_CATALOG | Używa tego pliku jako katalogu modeli. |
OHARNESS_NO_BUILTIN_MODELS | 1 pomija dołączony katalog modeli, więc zostają tylko twoje własne wpisy. |
OHARNESS_NO_CLAUDE_AGENT | 1 nigdy nie udostępnia Claude Code jako subagenta. |
OHARNESS_BROWSER_PATH | Plik wykonywalny Chrome lub Chromium, który uruchamia wbudowana przeglądarka. |
OHARNESS_BROWSER_HEADLESS | 0 daje wbudowanej przeglądarce widoczne okno. |
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOME | Skąd czytać pliki Claude Code i Codex, gdy nie leżą w zwykłym miejscu. |