Laissez votre agent IA voir, enregistrer et présenter votre Mac.
L'outil en ligne de commande et le serveur MCP de Recoly offrent à Claude Code, Codex, Cursor et à tout client MCP un enregistreur d'écran local : des captures qu'il peut examiner, des enregistrements pour reproduire un bug, des vidéos de démo soignées et des transcriptions sur l'appareil.
Configurer en une minute
- 1
Installez Recoly 0.9 ou plus récent
Téléchargez-le, déplacez-le dans Applications et ouvrez-le une fois.
- 2
Connectez vos agents
Dans Recoly, ouvrez "Settings" (l'engrenage) → "Command line & AI agents" → "Connect Claude Code, Codex, Cursor". Ou utilisez les commandes Terminal ci-dessous.
- 3
Redémarrez votre agent
Il charge le serveur MCP de Recoly. Essayez de lui demander une capture de votre écran.
Depuis le Terminal
curl -fsSL https://recoly.app/install-cli.sh | sh
recoly agents install --target claude --dry-run
recoly agents install --target claude --yes # or: codex · cursor · allAjoute la commande recoly, puis enregistre le serveur MCP (aperçu possible avec --dry-run).
Tout client MCP
{
"mcpServers": {
"recoly": {
"command": "/Applications/Recoly.app/Contents/Resources/native/bin/darwin-arm64/recoly",
"args": ["mcp", "serve"]
}
}
}Collez-le dans la configuration MCP de votre client. Obtenez le chemin exact pour votre Mac avec recoly agents print-config.
Ou laissez votre agent s'en charger
Collez ceci dans Claude Code, Codex ou Cursor :
Lis https://recoly.app/agents et configure le serveur MCP de Recoly pour moi. Montre-moi chaque modification de configuration et demande-moi avant de l'appliquer.Ce que votre agent peut faire
| recoly_screenshot | Capturer l'écran, une fenêtre ou une zone — et regarder l'image. |
| recoly_record_start · recoly_record_stop | Enregistrer la reproduction d'un bug ou une démo. Vous voyez les commandes d'enregistrement en permanence. |
| recoly_export | Générer du MP4, GIF, WebM ou ProRes avec zoom automatique, arrière-plan, preset enregistré et tout format d'image. |
| recoly_transcript | Transcription Whisper sur l'appareil, avec horodatage. |
| recoly_targets | Lister les écrans et fenêtres qui peuvent être capturés. |
| recoly_doctor | Vérifier les autorisations et obtenir la solution exacte quand il en manque une. |
| recoly_recordings_list · recoly_presets_list | Retrouver les enregistrements récents et les styles sauvegardés. |
Ce que vous pouvez demander à votre agent
- “Reproduis le bug du paiement, enregistre-le et donne-moi un GIF pour l'issue.”
- “Fais une capture d'écran et dis-moi pourquoi cette modale a un aspect étrange.”
- “Enregistre une démo de 30 secondes de la fonctionnalité que tu viens de créer et exporte des versions 16:9 et 9:16 avec mon preset Brand.”
- “Transcris mon dernier enregistrement et liste les actions à mener.”
- “Vérifie si Recoly dispose des autorisations nécessaires.”
- “Exporte mon dernier enregistrement en GIF 720p.”
Sûr par conception
- Uniquement en local : la CLI dialogue avec l'app via un socket privé que seul votre utilisateur macOS peut ouvrir. Pas de ports, pas de cloud, pas de compte.
- Vous gardez la main : désactivez l'accès des agents dans Settings à tout moment. Une notification s'affiche quand un agent lance un enregistrement, et ⌘⇧3 l'arrête.
- Les demandes d'approbation de votre agent s'appliquent toujours à chaque appel d'outil.
- Les modifications de configuration peuvent être prévisualisées avec --dry-run, et Recoly sauvegarde les fichiers avant d'y toucher.
- Votre forfait s'applique : la 4K, ProRes, WebM et la qualité Studio nécessitent Pro ; les exports Free portent un petit filigrane.
Ligne de commande
Chaque commande accepte --json. Les résultats vont sur stdout, la progression sur stderr. Codes de sortie : 0 succès, 1 échec, 2 usage invalide.
recoly doctor # permissions + fix hints
recoly targets # displays and windows
recoly screenshot --window window:1234:0 --output shot.png
recoly record start --window window:1234:0 --duration 30
recoly export --video ~/Movies/Recoly/recording-….mp4 --format gif --aspect 9:16
recoly transcript --video ~/Movies/Recoly/recording-….mp4
recoly guide --json # the full, machine-readable contract