Configuration du projet

La configuration du projet personnalise le comportement de Cyberstrike pour des projets spécifiques, surchargeant les paramètres globaux lorsqu’elle est présente.

Emplacement du fichier

La configuration du projet est stockée dans cyberstrike.json (ou cyberstrike.jsonc) à la racine du projet. Cyberstrike remonte depuis le répertoire de travail, donc une configuration dans n’importe quel dossier parent est prise en compte :

my-project/
├── cyberstrike.json     ← Configuration du projet
├── src/
├── package.json
└── ...

Créer la configuration du projet

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

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

Paramètres de base

Sélection du modèle

{
  "model": "anthropic/claude-opus-4-5-20251101"
}

Agent par défaut

{
  "default_agent": "cyberstrike"
}

default_agent doit être un agent principal ; il revient à cyberstrike si non défini ou invalide.

Instructions personnalisées

instructions est une liste de fichiers ou motifs glob dont le contenu est ajouté au prompt système (ce n’est pas du texte en ligne). Les listes sont fusionnées en union avec la configuration globale :

{
  "instructions": [
    "SECURITY.md",
    "docs/security-guidelines.md",
    ".cursor/rules/*.md"
  ]
}

Configuration des fournisseurs

Configurez les fournisseurs sous provider. Il n’y a pas de clé provider.default — le fournisseur actif découle de model (provider/model) :

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

Voir Fournisseurs IA pour les détails par fournisseur.

Permissions

Les permissions associent un nom d’outil à une action (ask, allow, deny) ou à une correspondance glob vers une action. Il n’y a pas de tableaux allow/deny ni de « modes » de permission :

{
  "permission": {
    "read": "allow",
    "bash": {
      "npm test": "allow",
      "npm run lint": "allow",
      "rm -rf *": "deny"
    },
    "edit": {
      "reports/**": "allow",
      ".env*": "deny"
    }
  }
}

Seuls * et ? sont supportés comme caractères génériques. Voir Permissions pour le modèle complet et la liste complète 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 :

{
  "mcp": {
    "project-tools": {
      "type": "local",
      "command": ["node", "./tools/mcp-server.js"],
      "enabled": true
    }
  }
}

Les entrées mcp du projet sont fusionnées par-dessus les entrées globales. Pour désactiver un serveur hérité, définissez son enabled à false :

{
  "mcp": {
    "some-global-server": { "enabled": false }
  }
}

Agents personnalisés

Définissez des agents de projet comme fichiers Markdown sous .cyberstrike/agents/ (voir Agents personnalisés), puis sélectionnez-en un par défaut :

{
  "default_agent": "project-scanner"
}

Exemple complet

{
  "$schema": "https://cyberstrike.io/config.json",
  "model": "anthropic/claude-sonnet-4-20250514",
  "default_agent": "cyberstrike",
  "instructions": ["docs/SECURITY.md"],

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

  "permission": {
    "read": "allow",
    "bash": { "npm *": "allow", "git status": "allow", "rm *": "deny" },
    "edit": { "reports/**": "allow", ".env*": "deny" }
  },

  "mcp": {
    "db-tools": {
      "type": "local",
      "command": ["node", "./tools/db-mcp.js"],
      "enabled": true
    }
  }
}

Héritage de configuration

La configuration du projet est fusionnée par-dessus la configuration globale et distante :

Configuration distante / well-known (base)
      ↓
Configuration globale (~/.config/cyberstrike/)
      ↓
Configuration personnalisée (CYBERSTRIKE_CONFIG)
      ↓
Configuration du projet (cyberstrike.json)
      ↓
Configuration du répertoire .cyberstrike/
      ↓
CYBERSTRIKE_CONFIG_CONTENT / config gérée / args CLI (surcharge)

Voir la Référence de configuration pour l’ordre de priorité complet.

Comportement de fusion

Validation du schéma

Ajoutez la référence du schéma pour l’autocomplétion et la validation dans l’IDE :

{
  "$schema": "https://cyberstrike.io/config.json"
}

Intégration Git

Committer la configuration du projet

git add cyberstrike.json
git commit -m "Add Cyberstrike project configuration"

Ignorer les données sensibles

# Ignorer les données de session locales
.cyberstrike/sessions/

Bonnes pratiques

1. Contrôle de version - Committez la configuration du projet pour le partage en équipe
2. Utilisez les références env - Ne codez jamais les clés API en dur ({env:VAR})
3. Documentez les instructions - Pointez instructions vers vos documents de sécurité
4. Permissions minimales - N’autorisez que ce qui est nécessaire
5. Surcharges personnelles - Utilisez CYBERSTRIKE_CONFIG pour les paramètres qui ne doivent pas être committés

Documentation associée

• Référence de configuration - Guide complet
• Configuration globale - Paramètres globaux
• Variables d’environnement - Référence des variables d’env