Documentation d’Astral

Le mode développeur d’Astral permet à un agent IA de piloter un véritable onglet du navigateur via MCP (Model Context Protocol). L’agent peut lire une page, cliquer et saisir du texte, examiner le réseau et la console, prendre des captures d’écran et exécuter un test qui laisse un rapport avec des preuves. Cette page vous met en route.

Ce que peut faire un agent connecté

• Ouvrir des onglets, naviguer et attendre la page, puis la lire sous forme de texte ou d’instantané d’accessibilité.
• Cliquer, saisir du texte, appuyer sur des touches, faire défiler et sélectionner, avec une saisie de confiance comme le ferait une personne.
• Inspecter les requêtes, les messages de la console et les erreurs de page regroupées, et lire les performances de la page.
• Vérifier la mise en page responsive d’une page et obtenir le correctif CSS pour chaque problème détecté.
• Écrire et exécuter un test : étapes, attentes, captures d’écran et enregistrement, puis le sauvegarder pour que vous, un autre agent ou la CI puissiez le rejouer.

Cela représente 46 outils répartis en 10 groupes. Chaque groupe est une permission que vous activez ou désactivez, et quelques-uns sont désactivés par défaut. Voir la référence des outils.

1. Installer Astral

Téléchargez l’installateur pour votre système depuis la section des téléchargements. Le pont MCP, astral-mcp, est inclus dans l’installateur : il n’y a rien d’autre à installer pour connecter un agent.

2. Activer le mode développeur

1. Ouvrez Settings → Developer et activez le Developer mode.
2. La carte Connection affiche la commande qui enregistre Astral auprès de votre agent, par exemple claude mcp add --scope user astral -- "/Applications/Astral.app/Contents/MacOS/astral-mcp".
3. Utilisez Share with AI dans l’en-tête du panneau pour choisir les onglets que l’agent peut voir. Le périmètre se choisit sur le même écran.

Chaque appel d’un agent apparaît dans le flux d’activité et dans le journal d’audit. Chaque groupe d’outils (read, navigate, interact, network, console, screenshot, evaluate, script, tests) peut être activé ou désactivé dans Settings → Developer.

3. Connecter votre agent

astral-mcp setup écrit la bonne entrée pour le client que vous utilisez. Choisissez le vôtre, copiez la commande et exécutez-la dans un terminal.

astral-mcp setup --list affiche tous les clients pris en charge et indique s’ils sont installés ; --client all-detected les configure tous, et --dry-run affiche d’abord le diff. Les extraits manuels, la vérification du bon fonctionnement et les clients absents de la liste (OpenCode, tout autre client MCP) se trouvent dans Connecter votre agent.

4. Un premier prompt à essayer

Avec un onglet partagé et votre agent connecté, demandez quelque chose comme :

Ouvre https://example.com dans Astral, lis la page et dis-moi
ce qu’elle contient. Vérifie ensuite sa mise en page dans un viewport mobile
et liste les problèmes que tu trouves.

Une fois que cela fonctionne, demandez un vrai test :

Teste le parcours d’inscription sur mon application locale à http://localhost:3000.
Écris-le sous forme de test avec une étape par écran, attends-toi à ne voir aucune
erreur de console ni de réseau, enregistre les actions et montre-moi le rapport.

Poursuivez avec les exécutions de test pour voir ce que l’agent écrit et ce qu’il laisse derrière lui.

Chaque page de la documentation est aussi disponible en Markdown, pour que vous puissiez transmettre son URL à un agent IA : ajoutez .md à l’URL de la page, ou donnez à l’agent llms.txt, un index de toutes les pages.