Passer au contenu principal
Afficher en Markdown

Kiroignore

Le fichier .kiroignore empêche Kiro de lire des fichiers précis dans votre espace de travail. En utilisant la syntaxe familière de gitignore, vous définissez des motifs pour les fichiers qui doivent rester privés - identifiants, secrets ou contenu que vous préférez garder hors du contexte de l'agent.

Là où c'est pris en charge, les motifs d'exclusion s'appliquent à l'ensemble des outils de l'agent - les fichiers bloqués le restent, quel que soit l'outil qui tente de les lire. Avant de retourner les résultats de recherche de fichiers ou de texte, Kiro vérifie chaque résultat par rapport à vos permissions de lecture et à vos règles d'exclusion. Les chemins et le contenu correspondant provenant de fichiers exclus ou illisibles n'apparaissent pas dans les résultats de recherche. Consultez le tableau ci-dessous pour la disponibilité par plateforme.

FonctionnalitéIDECLIWebMobile
.kiroignore de l'espace de travail✓V3——
Fichier d'exclusion global (~/.kiro/settings/kiroignore)✓V3——

L'IDE applique .kiroignore à l'ensemble des outils de l'agent pris en charge. Dans la CLI V3, un fichier .kiroignore de l'espace de travail ou votre fichier d'exclusion global empêche la lecture directe des fichiers correspondants et les filtre des résultats de recherche de contenu et de noms de fichiers. La prise en charge pour Web n'est pas encore disponible.

Pourquoi utiliser .kiroignore?

  • Sécurité - Empêche Kiro d'accéder aux fichiers contenant des identifiants, des clés API ou d'autres données sensibles
  • Confidentialité - Exclut les renseignements confidentiels des interactions avec l'IA
  • Conformité - Assure que Kiro n'accède pas aux fichiers qui ne devraient pas être partagés avec des services externes
  • Concentration - Garde le contexte de Kiro pertinent en excluant les fichiers volumineux ou les artefacts de build

Configuration de l'exclusion pour l'espace de travail

Pour exclure des fichiers dans un projet précis, créez un fichier .kiroignore à la racine de votre projet (ou dans n'importe quel sous-répertoire) et ajoutez des motifs pour les fichiers que vous voulez exclure :

bash
# Secrets and credentials .env .env.* !.env.example *.pem *.key # Private directories secrets/ private/

Kiro ignore tous les fichiers correspondant à vos motifs.

L'IDE lit les noms de fichiers d'exclusion à partir du paramètre Agent Ignore Files. Ouvrez les paramètres (Cmd+, sur Mac ou Ctrl+, sur Windows/Linux), recherchez Agent Ignore Files (paramètre : kiroAgent.agentIgnoreFiles), et ajoutez .kiroignore au tableau.

Le paramètre kiroAgent.agentIgnoreFiles accepte un tableau de noms de fichiers :

  • Utilisez plusieurs types de fichiers d'exclusion simultanément : [".gitignore", ".kiroignore"]
  • Réglez à [] pour désactiver les fichiers d'exclusion au niveau de l'espace de travail

Fichiers d'exclusion de sous-répertoire

Comme .gitignore, vous pouvez placer des fichiers .kiroignore dans des sous-répertoires pour remplacer ou étendre les motifs des répertoires parents. Les motifs dans les fichiers d'exclusion de sous-répertoire ont priorité pour les fichiers de ce sous-répertoire.

Fichiers d'exclusion globaux

Kiro respecte automatiquement les fichiers d'exclusion globaux s'ils existent - aucune configuration n'est nécessaire :

  • ~/.kiro/settings/kiroignore - Vos motifs d'exclusion Kiro globaux
  • Le fichier d'exclusion global de Git (configuré via core.excludesfile dans votre configuration git) - appliqué uniquement dans les dépôts git

Utilisez des fichiers d'exclusion globaux pour les motifs que vous voulez appliquer à tous vos projets.

Syntaxe des motifs

.kiroignore utilise la syntaxe standard de gitignore :

MotifEffet
file.txtIgnorer un fichier précis
*.logIgnorer par extension
folder/Ignorer un répertoire
**/tempIgnorer dans n'importe quel sous-répertoire
!keep.txtNe pas ignorer (négation)

Exemples

Protection des clés API et des secrets

bash
# Environment files with credentials .env .env.local .env.production # Keep the template accessible !.env.example # Certificate and key files *.pem *.key *.p12 credentials/

Exclusion des artefacts de build et des fichiers de données

bash
# Build outputs dist/ build/ .next/ # Data files *.sql *.dump data/exports/

Configuration de conformité pour les équipes

bash
# Customer data directories customer-data/ pii/ # Audit and compliance docs compliance/internal/ audit-reports/

Bonnes pratiques

  • Utilisez des commentaires pour documenter pourquoi les fichiers sont exclus - utile pour les membres de l'équipe
  • Testez les motifs en demandant à Kiro de lire un fichier exclu - il indiquera que l'accès est bloqué
  • Révisez les motifs périodiquement à mesure que la structure de votre projet évolue
  • Coordonnez-vous avec votre équipe sur les motifs globaux pour un comportement cohérent entre les espaces de travail
Page mise à jour : 20 octobre 2026