Que fait interactive-html ?
Commentez des pages HTML locales — mettez en surbrillance, posez des questions ou annotez ; un agent IA applique la modification et la page se recharge avec une visite guidée. Apportez vos propres pages ou laissez la compétence en générer une à commenter. Fonctionne avec Claude Code, Cursor ou n'importe quel agent CLI.
Utilisation
- Lancez l'agent IA avec cette compétence installée.
- Fournissez une page HTML (via un chemin de fichier ou laissez l'agent en générer une).
- L'agent ouvre la page et écoute les commentaires.
- Pour commenter, mettez en surbrillance du texte ou cliquez sur un élément, tapez votre question ou annotation, puis appuyez sur Entrée.
- L'agent traite le commentaire, applique la modification au fichier HTML source, et recharge la page avec un effet de surbrillance temporaire sur l'élément modifié.
Exemple
# Démarrer avec une page générée
agent run interactive-html --generate
# Ou avec votre propre page
agent run interactive-html /chemin/vers/ma-page.html
Configuration
| Variable | Défaut | Description |
|---|---|---|
AGENT_PORT | 8080 | Port pour le serveur local |
AGENT_OPEN | true | Ouvrir automatiquement le navigateur |
Comment ça marche
- Un petit serveur Node.js sert la page HTML et une API pour les commentaires.
- Un script d'injection dans le navigateur capture les surbrillances et les envoie à l'agent.
- L'agent IA (Claude Code, Cursor, etc.) reçoit le commentaire formaté et applique la modification via des outils d'édition de fichiers.
- Une visite guidée (highlight + animation) montre le changement après rechargement.
Dépendances
- Node.js 18+ requis
- Navigateur moderne (Chrome, Firefox, Edge)
Support des agents
- Claude Code — utilisez l'extension de compétence ou la commande
claude run. - Cursor — utilisable via la palette de commandes ou le fichier
.cursorrules. - CLI générique — exportez
AGENT_COMMAND=commandepour d'autres agents.
Dépannage
- Si la page ne se recharge pas, vérifiez que le port
8080n'est pas bloqué. - Assurez-vous que le fichier HTML a les permissions en écriture.
- Pour les grands fichiers, attendez que le serveur soit prêt avant de commenter.