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.

La prise en charge pour CLI et Web n'est pas encore disponible - aujourd'hui, .kiroignore n'est appliqué que dans l'IDE.

• 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.

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.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.

.kiroignore utilise la syntaxe standard de gitignore :

# 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