Configuration

Sur cette page

• Où vit la configuration
• Exemple
• Référence des clés
• Endpoint personnalisé
• Variables d'environnement
• Fichiers du projet

Où vit la configuration

~/.config/marex-code/config.json — modifiable à chaud avec /config (assistant interactif) ou en éditant le fichier directement.

Exemple

{
  "provider": "<fournisseur>",
  "model": "<modèle>",
  "apiKeys": { "<fournisseur>": "..." },
  "permissionLevel": "ask",
  "maxTokens": 8192,
  "autoCompress": true,
  "compactAt": 0.65,
  "sandboxMode": "auto",
  "search": { "native": true },
  "ui": "ink",
  "showThinking": true
}

Référence des clés

Clé	Rôle	Défaut
provider, model	Fournisseur et modèle actifs	—
apiKeys	Clés par fournisseur (préférez les variables d'environnement)	{}
permissionLevel	auto, ask ou review	ask
maxTokens	Plafond de génération par requête	8192
temperature	Température d'échantillonnage	—
stream	Streaming des réponses	true
maxHistory	Taille d'historique conservée	—
autoCompress	Compaction automatique	true
compactAt	Seuil de compaction, utilisé tel quel (aucune borne imposée)	0.65
sandboxMode	auto, on ou off	auto
search	{ "native": true, "order": ["tavily","brave","jina","exa"], "maxResults": 10 }	—
ui	ink ou opentui	ink
showThinking	Affiche le raisonnement du modèle	true
providerUrls	URL complète d'un endpoint (.../chat/completions)	{}
modelCapabilities	Capacités connues, clé fournisseur/modèle : contextWindow, maxOutputTokens, supportsTools, supportsVision	{}
externalDirAllow	Patterns <dossier>/* autorisés durablement hors workspace (les patterns racine /* sont refusés)	[]
agents	Températures, étapes max et permissions par agent	—

Endpoint personnalisé

{
  "providerUrls": {
    "local": "https://mon-endpoint.exemple/v1/chat/completions"
  },
  "modelCapabilities": {
    "local/mon-modele": {
      "contextWindow": 128000,
      "maxOutputTokens": 8192,
      "supportsTools": true
    }
  }
}

Important — sans fenêtre de contexte connue, Marexcode ne devine pas : il conserve l'historique complet plutôt que de tronquer au hasard, et la compaction automatique ne se déclenche pas (/compact reste disponible manuellement).

Variables d'environnement

Variable	Rôle
MAREX_WORKSPACE	Racine du projet (défaut : répertoire courant)
MAREX_UI	ink ou opentui (prioritaire sur la config)
MAREX_NO_ANIM, MAREX_ANIM_MS	Animations (pas de sélection de thème par variable)
MAREX_MEMORY_DIR, MAREX_MEMORY_RETENTION_DAYS	Stockage et rétention mémoire
OPEN_SANDBOX_DOMAIN, OPEN_SANDBOX_PROTOCOL	Endpoint du sandbox (défaut localhost:8802, http)
*_API_KEY, OPENROUTER_KEY, LITELLM_MASTER_KEY	Clés des fournisseurs
TAVILY_API_KEY, BRAVE_API_KEY, JINA_API_KEY, EXA_API_KEY	Agrégateurs de recherche web

Un fichier .env est chargé depuis le répertoire courant puis ~/.config/marex-code/.env, sans jamais écraser une variable déjà définie. chmod 600 recommandé — ce sont des secrets, jamais versionnés.

Fichiers du projet

Fichier	Rôle
MAREX.md	Instructions et conventions du projet (voir Rules, créé avec /init)
skill/*.md	Skills injectés dans le prompt système
agent/skills/<nom>/SKILL.md	Skills à matching par mots-clés

Voir Skills pour le détail des deux mécanismes.