Configuration globale

La configuration globale définit le comportement par défaut pour toutes les sessions Cyberstrike sur tous les projets.

Emplacement du fichier

La configuration globale réside dans le répertoire de configuration globale :

~/.config/cyberstrike/

Cela correspond à $XDG_CONFIG_HOME/cyberstrike lorsque XDG_CONFIG_HOME est défini.

Noms de fichiers supportés

Les fichiers suivants sont lus depuis le répertoire de configuration globale et fusionnés dans l’ordre :

Si plusieurs fichiers existent, tous sont lus et chaque fichier suivant est fusionné par-dessus le précédent.

Structure du répertoire

~/.config/cyberstrike/
├── config.json          ← configuration globale auto-générée
├── cyberstrike.json     ← configuration globale
├── cyberstrike.jsonc    ← configuration globale (préféré)
├── agents/              ← agents personnalisés (*.md)   (accepte aussi agent/)
├── commands/            ← commandes personnalisées (*.md) (accepte aussi command/)
└── plugins/             ← plugins (*.ts / *.js)  (accepte aussi plugin/)

Cyberstrike scanne également un répertoire ~/.cyberstrike/ dans votre dossier personnel pour cyberstrike.json/cyberstrike.jsonc et les mêmes sous-dossiers agents/, commands/, plugins/.

Créer la configuration globale

Il n’y a pas de commande init — créez le fichier manuellement :

{
  // Configuration globale Cyberstrike
  "$schema": "https://cyberstrike.io/config.json",
  "model": "anthropic/claude-sonnet-4-20250514"
}

Configuration du modèle

Modèle par défaut

{
  "model": "anthropic/claude-sonnet-4-20250514"
}

Format : provider/model.

Petit modèle

Utilisé pour les tâches légères telles que la génération de titre de session :

{
  "small_model": "anthropic/claude-haiku-4-5-20251001"
}

Configuration des fournisseurs

Configurez les fournisseurs individuellement sous provider. L’objet options est transmis au SDK du fournisseur :

{
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}"
      }
    }
  }
}

Activer / Désactiver des fournisseurs

{
  "disabled_providers": ["ollama"],
  "enabled_providers": ["anthropic", "openai"]
}

Lorsque enabled_providers est défini, seuls ces fournisseurs sont chargés ; tous les autres sont ignorés. Voir Fournisseurs IA pour les détails par fournisseur.

Thème

theme est le nom d’un thème installé (une chaîne). La valeur par défaut est cyberstrike :

{
  "theme": "cyberstrike"
}

Parcourez et changez les thèmes dans le TUI avec la commande /themes (ou <leader>t). Les thèmes intégrés incluent cyberstrike, tokyonight, catppuccin, dracula, gruvbox, nord, github, monokai, matrix, rosepine, solarized, et plus encore.

Raccourcis clavier

Touche leader

{
  "keybinds": {
    "leader": "ctrl+x"
  }
}

Raccourcis personnalisés

{
  "keybinds": {
    "leader": "ctrl+a",
    "session_new": "<leader>n",
    "session_list": "<leader>l",
    "model_list": "<leader>m",
    "theme_list": "<leader>t",
    "app_exit": "ctrl+c,ctrl+d,<leader>q"
  }
}

Voir Raccourcis clavier pour la liste complète des actions et des valeurs par défaut.

Permissions par défaut

Les permissions associent un nom d’outil à une action (ask, allow ou deny), ou à une correspondance glob vers une action. Il n’y a pas de liste allow/deny séparée — la clé de l’outil est le regroupement :

{
  "permission": {
    "read": "allow",
    "glob": "allow",
    "grep": "allow",
    "bash": {
      "*": "ask",
      "rm -rf *": "deny"
    },
    "edit": {
      "*": "ask",
      "~/.ssh/**": "deny"
    }
  }
}

Seuls * et ? sont supportés comme caractères génériques. Voir Permissions pour le modèle complet et la liste des clés de permission.

Serveurs MCP

Les serveurs MCP sont déclarés comme une carte plate sous mcp, indexée par nom de serveur. Les serveurs locaux utilisent type: "local" avec un seul tableau command (commande + arguments ensemble) ; les serveurs distants utilisent type: "remote" avec une url :

{
  "mcp": {
    "filesystem": {
      "type": "local",
      "command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "~"],
      "environment": { "DEBUG": "true" },
      "enabled": true
    },
    "remote-api": {
      "type": "remote",
      "url": "https://api.example.com/mcp",
      "enabled": true
    }
  }
}

Les serveurs Bolt sont configurés séparément sous la clé de premier niveau bolt, pas sous mcp. Voir Bolt / MCP.

Agent par défaut

Définissez l’agent par défaut (doit être un agent principal ; revient à cyberstrike si non défini ou invalide) :

{
  "default_agent": "cyberstrike"
}

Les agents personnalisés sont chargés depuis le répertoire agents/ (ou agent/) dans le répertoire de configuration — voir Agents personnalisés.

Compaction

Contrôlez la compaction automatique du contexte :

{
  "compaction": {
    "auto": true,
    "prune": true
  }
}

Journalisation et mises à jour

{
  "logLevel": "INFO",
  "autoupdate": "notify"
}

logLevel est l’un de DEBUG, INFO, WARN, ERROR (par défaut INFO). autoupdate accepte true, false ou "notify".

Exemple complet

{
  "$schema": "https://cyberstrike.io/config.json",
  "model": "anthropic/claude-sonnet-4-20250514",
  "small_model": "anthropic/claude-haiku-4-5-20251001",
  "default_agent": "cyberstrike",
  "theme": "cyberstrike",
  "share": "manual",
  "autoupdate": "notify",

  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}"
      }
    }
  },

  "permission": {
    "read": "allow",
    "edit": { "*": "ask" },
    "bash": { "*": "ask", "rm -rf *": "deny" }
  },

  "mcp": {
    "filesystem": {
      "type": "local",
      "command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "."],
      "enabled": true
    }
  },

  "keybinds": { "leader": "ctrl+x" },
  "compaction": { "auto": true, "prune": true }
}

Sauvegarde

cp ~/.config/cyberstrike/cyberstrike.jsonc ~/.config/cyberstrike/cyberstrike.jsonc.backup

Considérations de sécurité

Permissions des fichiers

chmod 600 ~/.config/cyberstrike/cyberstrike.jsonc
chmod 700 ~/.config/cyberstrike/

Données sensibles

Ne stockez jamais les clés API directement — référencez les variables d’environnement à la place :

{
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}"
      }
    }
  }
}

Documentation associée

• Référence de configuration - Toutes les options de configuration
• Configuration du projet - Paramètres du projet
• Variables d’environnement - Variables d’env
• Raccourcis clavier - Raccourcis clavier