haoyiyin/applescript-skill

Compétence d'agent pour l'automatisation macOS via AppleScript — contrôle des navigateurs, fichiers, mail, messages, médias et paramètres système. Compatible avec tout agent IA.

Qu'est-ce que applescript-skill ?

Cette compétence permet à un agent IA d'exécuter des automatisations sur macOS en utilisant AppleScript, un langage de script natif du système. Elle couvre un large éventail de domaines : contrôle des navigateurs web (Safari, Chrome, Firefox), gestion des fichiers et dossiers, envoi et lecture de courriels via Mail, gestion des messages (iMessage, SMS), contrôle de la lecture multimédia (Musique, Podcasts, Vidéos), et modification des paramètres système (réseau, affichage, son). L'intérêt principal réside dans l'intégration profonde avec macOS : l'agent peut effectuer des actions que seuls des scripts AppleScript peuvent réaliser, comme interagir avec des applications sans API publique ou manipuler des éléments d'interface utilisateur. Compatible avec tout agent IA (Claude Code, Cursor, Codex, etc.), elle se déclenche via des commandes simples et retourne les résultats de manière structurée. Pour les développeurs et power users macOS, cette compétence ouvre la voie à une automatisation poussée et contextuelle, réduisant les tâches répétitives et améliorant la productivité.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add haoyiyin/applescript-skill

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait applescript-skill ?

Compétence d'agent pour l'automatisation macOS via AppleScript — contrôle des navigateurs, fichiers, mail, messages, médias et paramètres système. Compatible avec tout agent IA.

Aperçu

Cette compétence permet à votre agent IA de contrôler et d'automatiser les applications macOS à l'aide d'AppleScript. Elle fournit un ensemble d'outils pour interagir avec les applications système natives et tierces, ce qui la rend idéale pour les flux de travail de productivité, les tâches de développement et les préférences utilisateur.

Fonctionnalités

  • Contrôle du navigateur : ouvrir, fermer, naviguer, actualiser, suivre des liens, gérer les onglets (Safari, Chrome, Firefox)
  • Gestion des fichiers : créer, supprimer, déplacer, copier, renommer des fichiers/dossiers, lire/écrire des fichiers texte
  • Automatisation du mail : composer, envoyer, lire, archiver, supprimer des courriels, gérer les pièces jointes
  • Gestion des messages : envoyer/recevoir des iMessages, des SMS, gérer les conversations
  • Contrôle multimédia : lecture/pause/saut de pistes, contrôle du volume, gestion des playlists (Musique, Podcasts)
  • Paramètres système : modifier les préférences d'affichage, réseau, son, et autres paramètres système

Installation

# Cloner le dépôt
git clone https://github.com/haoyiyin/applescript-skill.git

# Copier dans votre répertoire de compétences d'agent
cp -r applescript-skill /path/to/agent/skills/

Utilisation

# Exemple : ouvrir une URL dans Safari
agent run applescript-skill --action open_url --url "https://example.com"

# Exemple : envoyer un message
echo "Bonjour le monde" | agent run applescript-skill --action send_message --recipient "Jean Dupont"

Outils disponibles

OutilDescriptionParamètres
open_urlOuvre une URL dans le navigateur par défauturl (obligatoire)
send_emailEnvoie un courriel via Mail.appto, subject, body
read_inboxLit les courriels non lus depuis la boîte de réceptionmax_results (optionnel)
control_musicContrôle la lecture de Musique.appcommand (lecture/pause/suivant/précédent)
list_filesListe le contenu d'un dossierpath (défaut : dossier personnel)
create_fileCrée un nouveau fichierpath, content

Exemples

Navigateur

-- Ouvrir une URL dans Safari
tell application "Safari"
    open location "https://www.apple.com"
    activate
end tell

Fichiers

-- Créer un dossier et un fichier
set projectPath to (path to desktop as text) & "NouveauProjet"
do shell script "mkdir -p " & quoted form of POSIX path of projectPath
do shell script "echo 'Contenu du fichier' > " & quoted form of (POSIX path of projectPath & "/notes.txt")

Dépannage

  • Permission refusée : Assurez-vous que votre agent dispose des autorisations d'accessibilité dans Préférences Système > Confidentialité et sécurité > Accessibilité.
  • Application introuvable : Vérifiez que l'application cible est installée et en cours d'exécution.
  • Erreur de syntaxe AppleScript : Utilisez l'application Script Editor pour déboguer vos scripts avant de les exécuter via la compétence.

Licence

MIT

Skills associés