Paramètres avancés

La plupart des paramètres se trouvent dans la page Paramètres de l'application. Cette page couvre les autres : les clés que vous écrivez à la main dans un fichier de configuration, et les variables d'environnement que lit le harnais. Les clés qui ont leur propre page — fournisseurs, mémoire, synchronisation, plugins — sont simplement mentionnées ici, avec un lien vers cette page.

Où se trouvent les paramètres

FichierPortée
~/.oharness/config.jsonVous, sur cet ordinateur. Toutes les clés ci-dessous peuvent y figurer.
oharness.config.json (ou .oharness.json) dans un projetToute personne qui ouvre ce projet.

Le fichier du projet est fusionné par-dessus le vôtre : un projet peut donc durcir ou ajuster vos réglages. Certaines clés sont volontairement exclues d'un fichier de projet, car un dépôt que vous clonez ne doit pas pouvoir les définir à votre place :

  • team : les crédits de qui sont dépensés
  • sync.url, sync.token, sync.team : où partent vos transcriptions
  • runtimePlugins : du code qui s'exécute sur votre ordinateur
  • l'activation de l'extraction ou de la fusion automatique de la mémoire, qui consomme votre crédit de modèle. Un projet peut les désactiver.

OHARNESS_HOME déplace tout le répertoire ~/.oharness. Consultez Fichiers de configuration pour les autres fichiers qu'il contient.

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

Modèles

CléRôle
modelLe modèle sur lequel démarrent les nouvelles conversations, par identifiant ou alias.
smallModelLe modèle des tâches annexes qui n'ont pas besoin du modèle principal : résumés de compaction du contexte, extraction de mémoire, tâches d'arrière-plan comme les titres, et le vérificateur du mode auto. Sans cette clé, elles utilisent le modèle de la conversation, qui peut coûter bien plus que nécessaire.
thinkingRaisonnement par défaut : { "enabled": true, "effort": "high" }. effort est ajusté à ce que le modèle prend en charge. budgetTokens s'applique aux modèles qui acceptent un budget de tokens. display vaut "summarized" ou "omitted".
cacheMise en cache des prompts lorsque le fournisseur la prend en charge. Activée par défaut.
models, providers, catalog, openAiCompatible, oauthProvidersAjouter ou remplacer des modèles et des fournisseurs. Voir Fournisseurs et modèles.

Définissez smallModel. Le mode auto l'appelle avant chaque action qu'il vérifie, et la compaction l'appelle sur les longues conversations. Un modèle rapide et bon marché accélère les deux et en limite le coût. Si l'identifiant ne peut pas être résolu, le harnais journalise un avertissement et se rabat sur le modèle de la conversation.

Permissions

CléRôle
permissionModeLe mode dans lequel démarrent les nouvelles conversations : default, acceptEdits, plan, auto ou bypassPermissions.
permissionsRègles allow, ask et deny. Une règle deny l'emporte sur tous les modes, y compris Bypass.
workspaceModeOù les écritures peuvent aboutir : read-only, workspace-write (par défaut : le projet plus writableRoots) ou full-access. Ce réglage inspecte les arguments des outils ; ce n'est pas un bac à sable du système d'exploitation.
writableRootsRépertoires supplémentaires dans lesquels l'agent peut écrire.
readableRootsRépertoires supplémentaires que l'agent peut lire mais pas modifier.
auditConserver une trace de chaque décision de permission avec sa session. Activé sauf si défini à false.
auditLogAjouter aussi chaque décision à ce fichier, pour une exécution sans surveillance dont l'enregistrement doit être collecté.

Permissions explique les modes, la syntaxe des règles et la façon dont le vérificateur du mode auto décide.

Tours et instructions

CléRôle
maxTurnsNombre maximal d'appels au modèle pour un même prompt avant que l'agent s'arrête et fasse son rapport. 60 par défaut.
systemPromptRemplace le prompt système intégré. Rarement ce que vous voulez.
appendSystemPromptTexte ajouté après le prompt système intégré.
instructionsFileUn fichier d'instructions de projet autre que celui par défaut, relatif à la racine du projet.

Outils et extensions

CléRôle
tools{ "allow": [...], "deny": [...] } par nom d'outil. Les globs comme mcp__github__* fonctionnent. deny s'applique après allow. Un outil exclu ici n'est jamais proposé au modèle, contrairement à une règle de permission, qui refuse l'appel au moment où il est fait.
browser{ "mode": "auto" } (par défaut) laisse l'agent choisir entre votre navigateur, via l'extension, et un navigateur intégré. builtin, extension ou off le fixe.
claudeAgentPropose votre propre Claude Code comme sous-agent et comme @claude, payé par votre offre Claude. Désactivé sauf si défini à true.
importsLit les skills, agents et serveurs MCP de Claude Code et de Codex là où ils se trouvent. Les deux sont activés sauf si défini à false.
skillDirs, agentDirsRépertoires supplémentaires où chercher des skills et des définitions de sous-agents.
disabledSkillsSkills désactivés par nom.
mcpServers, hooks, subagents, plugins, runtimePluginsVoir Plugins.
schedulesPrompts exécutés selon une planification cron.

Sessions et worktrees

CléRôle
sessionDirOù sont conservées les sessions et les transcriptions. Par défaut storage/ dans ~/.oharness. Indiquer un autre répertoire repart de zéro : rien de ce qui a été enregistré à l'emplacement par défaut n'est importé.
sessionRetention{ "maxAgeDays": 90, "keep": 500 } supprime les sessions plus anciennes au démarrage. Rien n'est supprimé tant que vous ne définissez pas cette clé.
worktreePréparation d'un nouveau worktree git. copy liste les chemins ou globs copiés depuis le projet lorsqu'ils manquent dans le worktree (par défaut .env*). setup est une commande shell exécutée dans le nouveau worktree, par exemple npm ci.
memory, syncVoir Mémoire et synchronisation.

Facturation et journaux

CléRôle
teamImputer l'utilisation de l'offre officielle aux crédits d'une équipe plutôt qu'aux vôtres. Le service vérifie que vous faites partie de l'équipe. Autorisé dans votre propre configuration ou via OHARNESS_TEAM, jamais dans un fichier de projet.
logLeveldebug, info, warn, error ou silent.

Variables d'environnement

Une variable d'environnement remplace la clé de configuration correspondante, lorsqu'il y en a une.

VariableRôle
OHARNESS_HOMEUtiliser un autre répertoire à la place de ~/.oharness.
OHARNESS_TEAMIdentique à team.
OHARNESS_SYNC0, false, off ou no désactive la synchronisation, quoi qu'indique la configuration.
OHARNESS_SYNC_TOKENIdentifiant de synchronisation, lorsqu'il ne figure pas dans la configuration.
OHARNESS_SITE_URLUne adresse Cloud auto-hébergée ou de développement.
OHARNESS_CATALOGUtiliser ce fichier comme catalogue de modèles.
OHARNESS_NO_BUILTIN_MODELS1 écarte le catalogue de modèles fourni, pour ne garder que vos propres entrées.
OHARNESS_NO_CLAUDE_AGENT1 ne propose jamais Claude Code comme sous-agent.
OHARNESS_BROWSER_PATHL'exécutable Chrome ou Chromium que lance le navigateur intégré.
OHARNESS_BROWSER_HEADLESS0 donne une fenêtre visible au navigateur intégré.
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOMEOù lire les fichiers de Claude Code et de Codex lorsqu'ils ne sont pas à l'emplacement habituel.