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
| Fichier | Portée |
|---|
~/.oharness/config.json | Vous, sur cet ordinateur. Toutes les clés ci-dessous peuvent y figurer. |
oharness.config.json (ou .oharness.json) dans un projet | Toute 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éssync.url, sync.token, sync.team : où partent vos transcriptionsruntimePlugins : 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 |
|---|
model | Le modèle sur lequel démarrent les nouvelles conversations, par identifiant ou alias. |
smallModel | Le 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. |
thinking | Raisonnement 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". |
cache | Mise en cache des prompts lorsque le fournisseur la prend en charge. Activée par défaut. |
models, providers, catalog, openAiCompatible, oauthProviders | Ajouter 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 |
|---|
permissionMode | Le mode dans lequel démarrent les nouvelles conversations : default, acceptEdits, plan, auto ou bypassPermissions. |
permissions | Règles allow, ask et deny. Une règle deny l'emporte sur tous les modes, y compris Bypass. |
workspaceMode | Où 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. |
writableRoots | Répertoires supplémentaires dans lesquels l'agent peut écrire. |
readableRoots | Répertoires supplémentaires que l'agent peut lire mais pas modifier. |
audit | Conserver une trace de chaque décision de permission avec sa session. Activé sauf si défini à false. |
auditLog | Ajouter 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 |
|---|
maxTurns | Nombre 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. |
systemPrompt | Remplace le prompt système intégré. Rarement ce que vous voulez. |
appendSystemPrompt | Texte ajouté après le prompt système intégré. |
instructionsFile | Un fichier d'instructions de projet autre que celui par défaut, relatif à la racine du projet. |
| 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. |
claudeAgent | Propose votre propre Claude Code comme sous-agent et comme @claude, payé par votre offre Claude. Désactivé sauf si défini à true. |
imports | Lit 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, agentDirs | Répertoires supplémentaires où chercher des skills et des définitions de sous-agents. |
disabledSkills | Skills désactivés par nom. |
mcpServers, hooks, subagents, plugins, runtimePlugins | Voir Plugins. |
schedules | Prompts exécutés selon une planification cron. |
Sessions et worktrees
| Clé | Rôle |
|---|
sessionDir | Où 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é. |
worktree | Pré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, sync | Voir Mémoire et synchronisation. |
Facturation et journaux
| Clé | Rôle |
|---|
team | Imputer 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. |
logLevel | debug, info, warn, error ou silent. |
Variables d'environnement
Une variable d'environnement remplace la clé de configuration correspondante, lorsqu'il y en a une.
| Variable | Rôle |
|---|
OHARNESS_HOME | Utiliser un autre répertoire à la place de ~/.oharness. |
OHARNESS_TEAM | Identique à team. |
OHARNESS_SYNC | 0, false, off ou no désactive la synchronisation, quoi qu'indique la configuration. |
OHARNESS_SYNC_TOKEN | Identifiant de synchronisation, lorsqu'il ne figure pas dans la configuration. |
OHARNESS_SITE_URL | Une adresse Cloud auto-hébergée ou de développement. |
OHARNESS_CATALOG | Utiliser ce fichier comme catalogue de modèles. |
OHARNESS_NO_BUILTIN_MODELS | 1 écarte le catalogue de modèles fourni, pour ne garder que vos propres entrées. |
OHARNESS_NO_CLAUDE_AGENT | 1 ne propose jamais Claude Code comme sous-agent. |
OHARNESS_BROWSER_PATH | L'exécutable Chrome ou Chromium que lance le navigateur intégré. |
OHARNESS_BROWSER_HEADLESS | 0 donne une fenêtre visible au navigateur intégré. |
OHARNESS_CLAUDE_HOME, OHARNESS_CODEX_HOME | Où lire les fichiers de Claude Code et de Codex lorsqu'ils ne sont pas à l'emplacement habituel. |