Kagura

Qu’est-ce que Kagura ?

Kagura est un harnais de test open source pour les agents IA de codage qui doivent valider leur travail dans un vrai navigateur. Il permet à un agent d’ouvrir une session navigateur, de piloter des flux utilisateur (clics, formulaires, navigation) et de vérifier les résultats avant déploiement.

L’objectif principal est de combler l’écart entre « l’agent a écrit le code » et « le code fonctionne vraiment dans l’UI ». Kagura fournit un contrôle navigateur, une gestion des flux email (comme les magic links et OTP), et la possibilité de publier des actions capturées ou résultats de tests en CI/CD.

Fonctionnalités clés

• Contrôle navigateur en une commande pour agents : Lancez l’automatisation navigateur via une commande CLI, conçu pour les agents IA qui appellent des outils pendant le codage et la vérification.
• Support MCP et API HTTP : Utilisez Kagura via MCP (intégration native Claude Code) ou via une API HTTP pour compatibilité avec divers runtimes d’agents.
• Opérations navigateur basées sur Playwright : Naviguez les pages, parcourez les flux, remplissez les formulaires et capturez des screenshots avec le contrôle Playwright.
• Compétences email pour flux de vérification : Gérez magic links, OTP et vérification email pour éviter que les tests navigateur ne bloquent sur « vérifiez votre boîte de réception ».
• Analyse DOM et arbre d’accessibilité : Fournit une vue structurée d’accessibilité pour que l’agent comprenne la structure de page au-delà du rendu visuel.
• Journalisation d’actions avec replay en CI/CD : Enregistrez les actions et rejouez-les en CI/CD sans que l’agent réécrive les scripts de test.

Comment utiliser Kagura

1. Installez le CLI : Le site indique npm install -g @kagura-run/cli.
2. Démarrez le harnais : Exécutez une commande pour lancer le contrôle navigateur pour votre agent IA de codage.
3. Connectez l’agent : Configurez l’agent pour utiliser Kagura via configuration MCP (intégration Claude Code) ou l’API HTTP.
4. Exécutez les flux et collectez les preuves : Laissez l’agent naviguer, interagir avec l’UI et capturer des screenshots ; utilisez les actions enregistrées comme base pour les tests.
5. Publiez en CI/CD : Les tests sont conçus pour une publication automatique afin de s’exécuter à chaque push, comme décrit sur le site.

Cas d’usage

• Vérification UI après génération de code : Un agent effectue des changements puis utilise Kagura pour parcourir les chemins UI critiques et confirmer le comportement attendu via interactions et screenshots enregistrés.
• Tests d’authentification et onboarding par email : Pour les flux avec magic links, OTP ou vérification email, les compétences email de Kagura aident l’agent à compléter le parcours navigateur.
• Régression automatisée en CI/CD sans nouveaux scripts : Capturez les actions une fois et rejouez-les en CI/CD pour des exécutions répétables à chaque push, comme décrit sur le site.
• QA pilotée par agent pour compréhension UI accessible : Utilisez l’arbre d’accessibilité structuré pour que l’agent raisonne sur les éléments et actions de page de façon plus structurée.
• Intégration outil multi-agents de codage : Utilisez MCP avec Claude Code, ou l’API HTTP pour que Codex, Cursor ou autres agents compatibles curl pilotent les tests navigateur.

FAQ

• Kagura fonctionne-t-il avec Claude Code ? Oui. Le site indique que Kagura dispose d’une intégration « MCP native » avec Claude Code, en l’ajoutant à votre config MCP.

• Puis-je utiliser Kagura avec d’autres agents que Claude Code ? Oui. Le site liste l’usage MCP pour Claude Code et mentionne aussi une API HTTP utilisable par d’autres agents comme Codex et Cursor.

• Comment Kagura gère-t-il les flux de login ou vérification ? Kagura inclut des compétences email pour magic links, OTP et vérification email, aidant l’automatisation navigateur à compléter les étapes nécessitant normalement un accès email utilisateur.

• Quels artefacts de test produit Kagura ? Le site décrit l’enregistrement d’actions, la capture de screenshots, et la publication de tests en CI/CD (y compris replay des actions enregistrées).

• Kagura est-il auto-hébergé ou cloud ? La page décrit les deux options : un mode auto-hébergé sur votre infrastructure et une option d’hébergement cloud géré avec CI/CD et email inclus.

Alternatives

• Frameworks d’automatisation navigateur généralistes (ex. Playwright/Selenium) avec code de test personnalisé : Ils automatisent les tests UI, mais nécessitent généralement d’écrire et maintenir des scripts de test, plutôt qu’un harnais conçu pour les agents IA.
• Frameworks d’agents avec outils UI/DOM intégrés : Certaines plateformes d’agents incluent de l’automatisation navigateur ou des outils, mais sans la même combinaison de compétences email et workflow CI/CD publication/relecture.
• Outils de test end-to-end axés sur l’écriture de tests : Les suites E2E valident le comportement applicatif, mais se centrent sur des cas de test écrits par des humains, au lieu d’enregistrement/relecture pour exécution agent-driven.
• Services d’automatisation compatibles MCP : Si vous dépendez déjà fortement de MCP pour l’orchestration d’agents, vous pourriez chercher d’autres outils MCP exposant le contrôle navigateur, au prix d’assembler vous-même la gestion email et la publication CI/CD.