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é | IDE | CLI | Web | Mobile |
|---|---|---|---|---|
.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.
- 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
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 :
# 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
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.
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.excludesfiledans 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.
.kiroignore utilise la syntaxe standard de gitignore :
| Motif | Effet |
|---|---|
file.txt | Ignorer un fichier précis |
*.log | Ignorer par extension |
folder/ | Ignorer un répertoire |
**/temp | Ignorer dans n'importe quel sous-répertoire |
!keep.txt | Ne pas ignorer (négation) |
# Environment files with credentials .env .env.local .env.production # Keep the template accessible !.env.example # Certificate and key files *.pem *.key *.p12 credentials/
# Build outputs dist/ build/ .next/ # Data files *.sql *.dump data/exports/
# Customer data directories customer-data/ pii/ # Audit and compliance docs compliance/internal/ audit-reports/
- 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
Kiroignore