Qu'est-ce que PeonPing ?

PeonPing est un utilitaire essentiel conçu pour éliminer la frustration de surveiller les terminaux silencieux des agents IA. Il s'intègre directement aux environnements de codage et aux agents IA populaires — y compris Claude Code, Cursor, Codex, et plus encore — pour fournir des notifications sonores opportunes, avec la voix d'un personnage, dès qu'un agent termine une tâche, demande une autorisation ou rencontre une erreur. En transformant la surveillance passive en un retour auditif actif, PeonPing permet aux développeurs et aux utilisateurs de rester concentrés sur d'autres tâches (comme Slack ou e-mail) sans perdre le contexte ou le flux.

Au-delà des simples alertes, PeonPing offre une personnalisation approfondie grâce à une vaste bibliothèque de packs de sons mettant en vedette des personnages de jeux classiques comme Warcraft III, StarCraft et Team Fortress 2. Les utilisateurs peuvent sélectionner leur voix de personnage préférée pour diffuser les mises à jour de statut, garantissant que le retour est engageant plutôt que perturbateur. De plus, le serveur MCP (Master Control Program) optionnel permet à l'agent IA de sélectionner et de jouer dynamiquement le son approprié, offrant une expérience de notification véritablement intégrée et intelligente.

Fonctionnalités Clés

• Compatibilité Étendue des Agents : Intégration transparente avec Claude Code, Cursor, Codex, OpenCode, Kiro, Windsurf, Antigravity, et d'autres IDE/agents via des crochets et adaptateurs dédiés.
• Système de Packs Sonores Riches : Accès à plus de 75 packs de sons dans 7 langues, mettant en vedette des personnages emblématiques (Peon Orc, Sarah Kerrigan, Ingénieur TF2, GLaDOS, etc.). Les utilisateurs peuvent facilement échanger des packs ou créer et enregistrer les leurs.
• Serveur Master Control Program (MCP) : Permet aux agents IA de déclencher des sons spécifiques directement, permettant à l'agent de choisir son propre mécanisme de retour basé sur le contexte.
• Améliorations du Flux de Travail : Comprend des notifications de bureau lorsque le terminal est désactivé et des titres d'onglets dynamiques qui affichent l'état du projet (par exemple, un indicateur de point lorsque la tâche est terminée).
• Contrôle de Lecture Intelligent : Comprend un contrôle du volume (0,0 – 1,0), des bascules de catégories (salutation, accusé de réception, erreur, autorisation) et un système "Pas de Répétitions" qui suit les lignes récemment jouées pour éviter la fatigue auditive.
• Mode Entraîneur Peon (Nouveau dans la v2.0) : Une fonctionnalité ludique unique qui incite l'utilisateur à atteindre des objectifs de fitness quotidiens (300 pompes/squats) entre les sessions de codage, enregistrant les répétitions via les compétences Claude et célébrant l'atteinte des objectifs.

Comment Utiliser PeonPing

Commencer avec PeonPing est simple, impliquant principalement l'installation via des gestionnaires de paquets ou une exécution de script directe.

1. Installation : Installez via Homebrew (brew install PeonPing/tap/peon-ping) ou via le script curl fourni pour une installation bash directe.
2. Configuration et Sélection des Packs : Avant d'installer, les utilisateurs peuvent visiter le site web pour sélectionner leurs packs de sons désirés (par exemple, Peon Orc par défaut, Croiseur de bataille StarCraft). La commande d'installation est mise à jour en direct en fonction de ces sélections.
3. Intégration : Assurez-vous que votre agent IA (comme Claude Code ou Cursor) est configuré pour utiliser PeonPing pour les notifications. Pour un contrôle avancé, le serveur MCP peut être activé afin que l'agent gère la lecture du son.
4. Surveillance du Flux de Travail : Une fois actif, lancez simplement votre tâche d'agent IA. PeonPing vous alertera de manière audible lorsque l'agent aura besoin d'une autorisation, aura terminé son travail ou rencontrera une erreur, vous permettant de changer de contexte en toute confiance.
5. Personnalisation : Modifiez le fichier de configuration pour ajuster le volume, basculer des catégories de sons spécifiques (comme désactiver les sons 'agacés') ou installer de nouveaux packs en utilisant la commande peon packs install.

Cas d'Utilisation

1. Sessions de Codage en Concentration Profonde : Les développeurs travaillant sur des problèmes complexes peuvent plonger profondément dans le code ou la documentation, se fiant entièrement aux signaux auditifs distincts de PeonPing pour les rappeler uniquement lorsque l'agent IA nécessite une intervention ou signale l'achèvement, maximisant ainsi l'état de flux ininterrompu.
2. Professionnels Multitâches : Les utilisateurs gérant plusieurs canaux de communication (Slack, E-mail, Jira) en parallèle de leur environnement de développement IA peuvent utiliser les voix de personnages uniques pour différencier instantanément une invite IA critique d'un message standard, assurant une réponse rapide aux besoins de l'agent.
3. Développement et Test d'Agents IA : Lors de la construction de flux de travail IA personnalisés ou du test de nouvelles capacités d'agents, PeonPing fournit un retour clair et distinct pour chaque transition d'état (salutation, demande d'autorisation, erreur), facilitant grandement le débogage de la logique de l'agent.
4. Productivité Ludique et Fitness : Le mode Entraîneur Peon sert de partenaire de responsabilité unique, intégrant des micro-entraînements obligatoires dans l'horaire de codage, ce qui plaît aux utilisateurs qui apprécient l'auto-amélioration ludifiée parallèlement à leur travail technique.

FAQ

Q : Quels agents IA sont officiellement pris en charge par PeonPing ? A : PeonPing prend officiellement en charge les plateformes majeures, notamment Claude Code, Cursor, Codex, OpenCode, Kiro et Antigravity. Des adaptateurs sont également disponibles pour les IDE qui prennent en charge les crochets personnalisés.

Q : Puis-je créer et utiliser mes propres packs de sons personnalisés ? A : Oui. PeonPing encourage les contributions de la communauté. Vous pouvez créer un dépôt GitHub pour vos sons, l'enregistrer et utiliser la commande peon packs install pour l'ajouter à votre système.

Q : Comment fonctionne le serveur MCP ? A : Le serveur MCP permet à l'agent IA lui-même d'initier la lecture du son en appelant un point de terminaison d'API direct (play_sound). Cela signifie que l'agent, et non seulement le client PeonPing local, décide quel son jouer en fonction de son état interne.

Q : PeonPing est-il perturbateur dans un environnement de bureau ? A : Non. Le système comprend un contrôle granulaire du volume (0,0 à 1,0) configurable dans les paramètres, permettant aux utilisateurs de régler les sons suffisamment bas pour les espaces de travail partagés. De plus, la fonction "Pas de Répétitions" empêche la même ligne d'être jouée consécutivement.

Q : Qu'est-ce que le mode Entraîneur Peon et comment fonctionne-t-il ? A : Le mode Entraîneur Peon est une intégration de fitness où le Peon vous incite à effectuer 300 pompes et 300 squats quotidiennement. Il envoie des rappels, permet d'enregistrer les répétitions en pleine conversation via une commande et célèbre l'achèvement des objectifs, transformant efficacement vos pauses de codage en séances d'entraînement obligatoires.