Configurer NotiBuddy

NotiBuddy transmet les demandes et progressions de vos logiciels connectés vers votre iPhone ou iPad. La configuration MCP ci-dessous relie un assistant IA compatible. Les apps, scripts et services peuvent aussi se connecter directement.

Obtenir NotiBuddy pour iPhone et iPad, puis jumelez l’app avec le client ordinateur notibuddy 0.4.0 (CLI et serveur MCP local sur npm). Installer le paquet seul n’accorde aucun accès : chaque expéditeur exige une connexion approuvée.

Une Apple Watch jumelée par iPhone est incluse et partage son quota ; les demandes enregistrées restent visibles sur la Watch et la livraison directe nécessite qu’elle soit activée sur le service.

Prérequis pour MCP

Connecter votre téléphone et votre ordinateur

  1. Ouvrez NotiBuddy, vérifiez les options de confidentialité et autorisez la connexion, le partage des réponses et les notifications.
  2. Ouvrez Connecter → Ajouter une connexion (ou Ajouter). Touchez Créer un code de configuration → Partager la configuration (ou Utiliser l’approbation manuelle) et transférez les instructions en privé par AirDrop ou presse-papiers.
  3. Gardez NotiBuddy ouvert et exécutez la commande de jumelage. Elle inclut --to suivi d’un alias local. Un code à usage unique connecte automatiquement le premier nouvel expéditeur pendant dix minutes. En cas d’approbation manuelle, comparez l’ID de clé complet dans le Terminal et sur votre iPhone.
  4. Ajoutez NotiBuddy dans les réglages MCP de votre app d’IA, envoyez une question test et répondez depuis votre téléphone.

Partagez ces instructions uniquement avec des expéditeurs de confiance. La configuration est terminée dès que votre IA reçoit votre réponse.

Une fois connecté, vous pouvez indiquer à votre IA :

Utilise NotiBuddy lorsque tu as besoin d’une décision de ma part et partage de courtes étapes d’avancement. Attends ma réponse avant toute action critique.

Votre IA doit relever la réponse pour continuer. NotiBuddy ne réveille pas un ordinateur en veille et ne relance pas une session terminée. Les nouvelles demandes restent valables trois heures par défaut. Voir Aide et assistance.

Connecter une app ou un service

MCP n’est qu’une option. Toute app, tout script ou service peut se connecter directement via le protocole chiffré documenté. Importez un paquet nbpair valide, enregistrez l’identité de signature et envoyez des demandes chiffrées et signées vers l’appareil jumelé. Vérifiez toujours les réponses avec la clé de signature du téléphone.

Le paquet notibuddy inclut un client TypeScript/JavaScript pour Node.js 20+. Consultez le code source et README et PROTOCOL.md.


Configuration technique pour votre assistant IA

Les sections ci-dessous sont destinées à un assistant configurant NotiBuddy pour vous. Elles sont aussi disponibles en Markdown brut, en anglais.

1. Vérifier le client publié

Le paquet est notibuddy, publié par Yourbit, LLC (également sur Homebrew : brew install yourbit-network/tap/notibuddy). La version 0.4.0 est disponible ; les commandes npx utilisent ^0.4.0. Vérifiez l’installation :

npx -y notibuddy@^0.4.0 --help

2. Vérifier le jumelage

Exécutez npx -y notibuddy@^0.4.0 status pour inspecter les destinations enregistrées. Si l’ordinateur n’est pas jumelé, invitez l’utilisateur à ouvrir Connecter → Ajouter une connexion → Créer un code de configuration → Partager la configuration et à transférer en privé le paquet nbpair1.. Configuration et clés sont stockées en privé dans ~/.notibuddy/. Dans les exemples, personal est un alias local (--to personal).

3. Enregistrer le serveur MCP local

Ajoutez un serveur MCP local stdio :

Pour les clients utilisant mcpServers (si un ancien message mentionne 0.2.x ou 0.3.x, remplacez par notibuddy@^0.4.0) :

{
  "notibuddy": {
    "command": "npx",
    "args": ["-y", "notibuddy@^0.4.0", "mcp", "--to", "personal"]
  }
}

Il s’agit d’un processus MCP local. Ne configurez pas l’URL du relais comme serveur MCP distant (notibuddy.com redirige vers notibuddy.app ; le relais est https://notibuddy.app).

4. Finaliser la connexion

Gardez NotiBuddy ouvert et en ligne jusqu’à confirmation. Vérifiez ensuite avec npx -y notibuddy@^0.4.0 doctor --to personal l’accès relais, l’approbation, le protocole et la réception de fichiers. Pour plusieurs appareils, utilisez des alias distincts (--to personal, --to work) dans ~/.notibuddy/destinations.

5. Vérifier dans les deux sens

Rechargez MCP puis appelez notibuddy_notify :

{
  "title": "NotiBuddy connected",
  "message": "Tap OK to finish setup.",
  "options": ["OK"]
}

Si la réponse est en attente, rappelez l’outil avec requestId dans resume_id. Vous pouvez aussi tester depuis le Terminal :

npx -y notibuddy@^0.4.0 notify "Connection check" --to personal --message "Reply OK to test both directions." --options "OK" --wait 55

En cas d’attente, lancez npx -y notibuddy@^0.4.0 notify --resume REQUEST_ID --to personal --wait 55 avant l’échéance de trois heures.

Outils et réponses

notibuddy_notify envoie une notification chiffrée de bout en bout (unidirectionnelle par défaut) et attend une réponse signée lorsque des options interactives ou resume_id sont fournis.

ParamètreRôle
title, messageTitre et contexte
screenÉcran natif personnalisé (templateId ou template en ligne composé de 12 blocs natifs) ; exclusif avec message, options, fields, input_placeholder, diff et resume_id
optionsChoix de réponse (rend la demande interactive)
decline_optionOption de options refusant sans authentification
input_placeholderActive une réponse texte rapide
fieldsFormulaire natif avec text, email, url, toggle, stepper, picker, date ou secret
diffRevue de modifications (filename, language optionnel, original, modified)
sensitiveMasque le contenu sur l’écran verrouillé et les Activités en direct
requires_authExige Face ID ou l’authentification locale dans l’app
timeout_secondsDurée de validité : 1 à 10 800 s (3 heures par défaut et maximum)
wait_secondsAttente par appel : 25 s par défaut, 55 s maximum
resume_idVérifie une demande en cours sans nouvel envoi

Pour les Écrans personnalisés (0.4.0+), choisissez parmi 8 modèles intégrés ou envoyez un template personnalisé (ou pré-enregistrez-le via nb screen register <file> [--strict] puis nb notify --screen <json-file>). En Terminal, --timeout 10800 fixe l’échéance et --wait 55 la durée d’attente. N’interprétez jamais une expiration, une erreur ou un silence comme une approbation.

notibuddy_activity démarre, met à jour ou termine une progression ou un minuteur (poll lit les commandes envoyées par le téléphone).

ParamètreRôle
idIdentifiant stable de l’activité
actionstart, update, end ou poll
title, statusTitre court et statut
step, total_stepsÉtapes d’avancement
timer_minutesDurée du compte à rebours
controlspause, resume, cancel ou add_5m

Usage et confidentialité

La formule Gratuit inclut cinq demandes par 24 heures glissantes. Les questions et le démarrage d’une Activité en direct comptent dans ce quota ; les mises à jour, fins d’activité et vérifications de réponse ne consomment pas de demande supplémentaire. Les Activités en direct fonctionnent sur Gratuit et Pro. Quotas d’appareils : 1 iPhone/iPad en Gratuit, jusqu’à 3 en Pro Annuel, jusqu’à 12 en Pro À vie (1 Apple Watch incluse par iPhone). Voir formules, conditions et confidentialité.

Destinations multiples et libellés d’expéditeur

Utilisez --sender "Coding assistant" pour décrire la source dans le contenu chiffré (sans isoler les permissions). Pour exposer plusieurs destinations en MCP, utilisez --allow-to personal --allow-to work et précisez to à chaque appel ; notibuddy_list_destinations liste uniquement les destinations exposées.

Mettre à jour une destination existante

  1. Exécutez npx -y notibuddy@^0.4.0 devices list pour retrouver l’alias existant.
  2. Sur le même téléphone, ouvrez Connecter → Ajouter et partagez une nouvelle configuration manuelle.
  3. Remplacez le nom après --to par l’alias existant et omettez --label.
  4. Comparez l’ID de clé complet si une approbation est demandée.
  5. Redémarrez MCP et vérifiez avec npx -y notibuddy@^0.4.0 doctor --to personal.

Recevoir un fichier depuis votre téléphone

Sur le téléphone, choisissez Connecter → connexion → Partager un fichier ou Partager → NotiBuddy (limite 10 Mo (10 000 000 octets) par fichier). L’ordinateur doit récupérer le fichier manuellement ; aucun collecteur automatique en arrière-plan n’existe :

npx -y notibuddy@^0.4.0 files list --to personal
npx -y notibuddy@^0.4.0 files receive FILE_ID_FROM_LIST --to personal

Avec MCP, appelez notibuddy_files avec action "list", puis "receive" avec l’id (remplacez FILE_ID_FROM_LIST par l’ID retourné ; un libellé --sender n’isole pas l’accès aux fichiers). Le client vérifie, déchiffre et enregistre le fichier dans ~/.notibuddy/inbox/ sans jamais l’ouvrir. « Livré » signifie enregistré, pas lu par un agent. En cas de saved_pending_receipt, relancez la commande avec le même ID. Si doctor signale l’absence de réception de fichiers, suivez les instructions du client.