✨ Activité en direct

Une petite bulle au-dessus de ton avatar montre ce que tu fais : la musique que tu écoutes, ton dernier push GitHub, Claude Code qui réfléchit, l'appli ouverte (VS Code, Figma, Slack…). Tes collègues la voient aussi dans la liste des 👥 Personnes et sur ta fiche.

🔑 Jetons : quand les comptes sont activés, les commandes de Ce que je fais → Connecter utilisent un jeton personnel ltp_…. Crée-le dans Mon compte → Jetons d'accès (bouton direct dans la section Connecter), puis remplace ltp_VOTRE_JETON dans la commande. Tu peux révoquer un jeton à tout moment. Sans comptes, la commande contient déjà ton jeton de navigateur.

📸 Capture à venir : img/activite.png (bulles d'activité au-dessus de plusieurs avatars).

💡 Astuce : survole la bulle de quelqu'un (💻) pour voir le détail et, s'il y en a un, le lien ↗. Dans 👥 Personnes, le filtre Code / Claude montre qui code en ce moment.

Partager ton activité à la main#

Clique sur ta photo → Ce que je fais… (📱 Plus → Ce que je fais).
Choisis un type : 🎵 Musique, 🐙 GitHub, ✳️ Claude, 💻 Code, 📅 Réunion, 🎯 Concentration, 🎮 Jeu, ☕ Pause, ✨ Autre.
Ajoute un détail (80 caractères), un lien https:// (facultatif) et une durée (15 min à « Toute la journée »).
Clique sur Partager.

La bulle disparaît toute seule à la fin de la durée. Pour l'enlever avant, rouvre la fenêtre et clique sur Effacer.

Mise à jour automatique avec `ft-activity`#

Dans la même fenêtre, la section 🔌 Connecter te donne ton jeton personnel et des commandes toutes prêtes à copier. Elles lancent le petit programme ft-activity sur ton ordinateur (il faut Node.js 18 ou plus, et une copie du dépôt LocalTown).

⚠️ Garde ton jeton pour toi : il permet de publier une activité en ton nom et d'écouter tes messages vocaux. Le bouton ↻ en génère un nouveau (les anciennes commandes cessent de marcher à ta prochaine connexion). LocalTown doit être ouvert dans ton navigateur pour que l'activité s'affiche.

Mode	Ce qui s'affiche	Ordinateur
`watch`	Le logo de l'appli au premier plan (Claude, Cursor, VS Code, JetBrains, Zed, Xcode, iTerm, Warp, Ghostty, Terminal, Slack, Figma, Notion, Linear, Spotify, Zoom, Google Meet…), toutes les 5 s	macOS, Linux (`xdotool` ou `xprop`)
`music`	« Artiste – Titre » (Spotify, Musique), toutes les 10 s	macOS, Linux (`playerctl`)
`github --user <login>`	Ton dernier push, PR, release…, toutes les 60 s	Tous
`claude`	Claude Code réfléchit / travaille (outil utilisé) / a terminé, avec le logo du terminal ou de l'éditeur où il tourne	Tous
`run --app codex -- codex`	Une autre IA en ligne de commande (Codex, Gemini CLI, Aider) : « travaille » tant qu'elle tourne	Tous
`git`	Animation push au-dessus de ton avatar à chaque `git push` (dépôt, branche, nombre de commits)	Tous
`set` / `clear`	Une activité personnalisée (« Deep work jusqu'à 16 h ») / l'effacer	Tous

Sous Windows, la détection de l'appli au premier plan et de la musique n'est pas disponible. Les autres modes fonctionnent.

🔒 Confidentialité : en mode watch, seul le nom de l'appli est envoyé. Le titre des fenêtres n'est envoyé qu'avec l'option --titles (désactivée par défaut). Pour reconnaître Google Meet, Figma… dans le navigateur, macOS peut te demander l'autorisation « Accessibilité » : le titre est alors lu sur ton ordinateur, mais pas envoyé.

💡 Astuce : mets FT_ORIGIN, FT_SPACE et FT_TOKEN dans tes variables d'environnement pour raccourcir les commandes.

Claude Code#

Ouvre Ce que je fais… → 🔌 Connecter → ✳️ Claude Code.
Copie la configuration proposée dans ~/.claude/settings.json (ou .claude/settings.json d'un projet), en remplaçant le chemin par celui de ton dépôt LocalTown.

Les hooks utilisés : UserPromptSubmit (réfléchit), PreToolUse (travaille), Notification (attend une réponse), Stop (terminé, la bulle disparaît après 30 s). Cela ne ralentit jamais Claude Code.

Codex, Gemini CLI, Aider#

Codex : dans ~/.codex/config.toml, notify = ["node", "/chemin/ft-activity.mjs", "claude", "--app", "codex", …] affiche « terminé » à la fin de chaque tour. Pour voir aussi « travaille », lance Codex avec le mode run.
Gemini CLI, Aider : crée un alias, par exemple alias gemini='node /chemin/ft-activity.mjs run --app gemini-cli --origin … --space … --token … -- gemini'.

Depuis n'importe quel script#

La section 🛠️ Autre / API donne une commande set et un exemple curl vers POST /api/spaces/<espace>/activity.

🐙 Animations GitHub#

Quand un dev pousse du code, ouvre ou fusionne une PR, déploie, publie une release ou que la CI passe (ou échoue), une animation apparaît au-dessus de son avatar. Si tu es à côté (ou en appel avec lui), un petit message te le dit aussi (« ⬆️ Prénom : a poussé 3 commits… »), avec un bouton Ouvrir.

Deux façons de les déclencher :

dans un dépôt, node /chemin/ft-activity.mjs install-git-hook --origin … --space … --token … installe un hook git (pre-push) : chaque git push fait apparaître l'animation au-dessus de toi ;
si l'admin a branché le webhook GitHub de l'espace (voir Admin : intégrations), les pushs, PR, déploiements et résultats de CI s'affichent automatiquement. Le mode github --user <login> (ou le connecteur GitHub) relie ton compte GitHub à ton avatar. Dans Ce que je fais → Connecter → GitHub, renseigne Mon identifiant GitHub ; si le connecteur GitHub est branché, l'identité s'affiche comme vérifiée ✓.

Ce que veut dire chaque animation :

Animation	Signification
🟩 Petits cubes verts qui s'empilent puis décollent comme une fusée (avec « +ajouts / −suppressions »)	Push : des commits viennent d'être poussés (un cube par commit, 10 max)
🌿 Une branche qui pousse au-dessus de la tête	PR ouverte
🟣 Deux branches qui se rejoignent, éclat violet et confettis	PR fusionnée
🚀 Une petite fusée qui décolle dans la fumée et les étoiles	Déploiement
✅ Une coche verte qui scintille	CI réussie
🌩️ Un petit nuage d'orage qui pleut sur l'avatar (et une goutte de sueur)	CI en échec (ça arrive à tout le monde !)
🏷️ Une étiquette et un feu d'artifice	Release publiée
🔍 Une loupe avec des yeux qui regarde à gauche et à droite	Revue de code en cours

Les bulles d'appli : quand quelqu'un utilise une appli connue (Claude Code, Codex, Gemini CLI, Cursor, VS Code, JetBrains, Zed, Xcode, un terminal, Slack, Figma, Notion, GitHub, Linear, Chrome, Meet, Zoom, Spotify…), sa bulle affiche un petit logo en pixel art. Claude Code dans un terminal ou un IDE montre les deux logos côte à côte. Trois petits points qui sautillent = réfléchit, un engrenage qui tourne = travaille, bulle pâle = en pause. Les bulles n'apparaissent que si tu es assez près et assez zoomé.

Tu n'aimes pas les animations ? Réglages → Animations GitHub au-dessus des devs pour les couper.