busybits 0.0.0-stage → 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +26 -0
- package/CHANGELOG.md +692 -0
- package/LICENSE +21 -0
- package/README.es.md +1457 -0
- package/README.fr.md +1435 -0
- package/README.md +1623 -2
- package/README.pt-BR.md +1373 -0
- package/dist/build.json +5 -0
- package/dist/cli/busybits.js +14724 -0
- package/dist/client/assets/art/framed/painting-abstract.png +0 -0
- package/dist/client/assets/art/framed/painting-beach.png +0 -0
- package/dist/client/assets/art/framed/painting-cat.png +0 -0
- package/dist/client/assets/art/framed/painting-city-night.png +0 -0
- package/dist/client/assets/art/framed/painting-mountains.png +0 -0
- package/dist/client/assets/art/framed/painting-rio.png +0 -0
- package/dist/client/assets/art/framed/painting-sunflowers.png +0 -0
- package/dist/client/assets/art/framed/painting-wave.png +0 -0
- package/dist/client/assets/art/framed/painting-wide-aurora.png +0 -0
- package/dist/client/assets/art/framed/painting-wide-color-fields.png +0 -0
- package/dist/client/assets/art/framed/painting-wide-forest-lake.png +0 -0
- package/dist/client/assets/art/painting-abstract.png +0 -0
- package/dist/client/assets/art/painting-beach.png +0 -0
- package/dist/client/assets/art/painting-cat.png +0 -0
- package/dist/client/assets/art/painting-city-night.png +0 -0
- package/dist/client/assets/art/painting-mountains.png +0 -0
- package/dist/client/assets/art/painting-rio.png +0 -0
- package/dist/client/assets/art/painting-sunflowers.png +0 -0
- package/dist/client/assets/art/painting-wave.png +0 -0
- package/dist/client/assets/art/painting-wide-aurora.png +0 -0
- package/dist/client/assets/art/painting-wide-color-fields.png +0 -0
- package/dist/client/assets/art/painting-wide-forest-lake.png +0 -0
- package/dist/client/assets/art/poster-bug.png +0 -0
- package/dist/client/assets/art/poster-cat.png +0 -0
- package/dist/client/assets/art/poster-code.png +0 -0
- package/dist/client/assets/art/poster-coffee.png +0 -0
- package/dist/client/assets/art/poster-rocket.png +0 -0
- package/dist/client/assets/art/poster-ship-it.png +0 -0
- package/dist/client/assets/brand/apple-touch-icon.png +0 -0
- package/dist/client/assets/brand/favicon-16.png +0 -0
- package/dist/client/assets/brand/favicon-32.png +0 -0
- package/dist/client/assets/brand/icon-192.png +0 -0
- package/dist/client/assets/brand/icon-512.png +0 -0
- package/dist/client/assets/brand/logo-detailed.png +0 -0
- package/dist/client/assets/brand/logo-mark.png +0 -0
- package/dist/client/assets/brand/logo-mark@4x.png +0 -0
- package/dist/client/assets/brand/signage.png +0 -0
- package/dist/client/assets/brand/signage@4x.png +0 -0
- package/dist/client/assets/emoji/LICENSE-SerenityOS.txt +28 -0
- package/dist/client/assets/emoji/sheet.png +0 -0
- package/dist/client/assets/illustrations/empty-office.png +0 -0
- package/dist/client/assets/manifest.json +260 -0
- package/dist/client/assets/og-image.png +0 -0
- package/dist/client/bundle/app-CoDOLwxe.css +1 -0
- package/dist/client/bundle/app-QYGBa260.js +24 -0
- package/dist/client/bundle/city-DPTwQLdi.css +1 -0
- package/dist/client/bundle/city-UYDbxWIy.js +1 -0
- package/dist/client/bundle/daystats-CJyNq6hu.js +1 -0
- package/dist/client/bundle/dom-slmnBOjx.js +1 -0
- package/dist/client/bundle/en-BQQEHqmG.js +169 -0
- package/dist/client/bundle/es-BgBoKwEe.js +169 -0
- package/dist/client/bundle/format-CvlPqloO.js +1 -0
- package/dist/client/bundle/fr-PI_gjIFq.js +169 -0
- package/dist/client/bundle/main-DTHUta25.js +2 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-Ckz2YJkH.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-DfOZNMlW.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-500-normal--wrb4dVK.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-500-normal-CR9SIKMr.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-B3EuUOZG.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-BhqNJYOZ.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-BrZTw8tu.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-CYtG5Rfp.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-400-normal-DLrIX9QE.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-400-normal-JapMNN6Z.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-500-normal-Bq6pAlou.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-500-normal-DC052d-m.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-600-normal-BNlgYbDL.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-600-normal-Dd_Dy7u5.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-700-normal-BctWAS0u.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-700-normal-D3Xxx3QE.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-BkfTUL4s.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-DdH6zlBQ.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-BHT4w5qI.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-Bkr-oq6R.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-CDaIumwU.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-Dha6RiOG.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-BadXkHzZ.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-ClyJstAh.woff2 +0 -0
- package/dist/client/bundle/ptypane-9pL54zR0.js +16 -0
- package/dist/client/bundle/ptypane-BrP-ENHg.css +1 -0
- package/dist/client/bundle/room-name-Bv6N672f.js +1 -0
- package/dist/client/bundle/simulator-B45JPgSp.js +7 -0
- package/dist/client/bundle/world-model-BgjMjmrp.js +1 -0
- package/dist/client/bundle/world-stream-CUfry7aL.js +1 -0
- package/dist/client/index.html +41 -0
- package/dist/client/manifest.webmanifest +17 -0
- package/dist/server/index.js +40342 -0
- package/mod/README.md +193 -0
- package/mod/habblaud/.claude-plugin/plugin.json +11 -0
- package/mod/habblaud/hooks/hooks.json +4 -0
- package/mod/habblaud/hooks/register.ts +517 -0
- package/mod/habblaud-codex/hook.mjs +274 -0
- package/mod/habblaud-mensagens/.claude-plugin/plugin.json +11 -0
- package/mod/habblaud-mensagens/hooks/hooks.json +4 -0
- package/mod/habblaud-mensagens/hooks/register.ts +384 -0
- package/mod/habblaud-permissoes/.claude-plugin/plugin.json +11 -0
- package/mod/habblaud-permissoes/hooks/hooks.json +18 -0
- package/mod/habblaud-permissoes/hooks/permission-hook.mjs +265 -0
- package/mod/habblaud-pi/core.ts +325 -0
- package/mod/habblaud-pi/extension.ts +119 -0
- package/mod/habblaud-pi/package.json +12 -0
- package/package.json +100 -4
package/README.fr.md
ADDED
|
@@ -0,0 +1,1435 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/client/public/assets/brand/logo-mark@4x.png" width="96" alt="Logo de Busybits : une tuile de petits blocs en pixel art" />
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
<h1 align="center">Busybits</h1>
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
<b>Le bureau virtuel de vos agents Claude Code (et Codex).</b><br />
|
|
9
|
+
Chaque projet devient une salle, chaque agent un personnage en pixel art qui montre, en temps réel, ce qu'il est en train de faire.
|
|
10
|
+
</p>
|
|
11
|
+
|
|
12
|
+
<p align="center"><a href="README.md">English</a> · <a href="README.pt-BR.md">Português</a> · <a href="README.es.md">Español</a> · <b>Français</b></p>
|
|
13
|
+
|
|
14
|
+
<p align="center"><sub>Basé sur <a href="https://github.com/marmottajr/habblaud">Habblaud</a>, de Márcio Junior (MIT).</sub></p>
|
|
15
|
+
|
|
16
|
+
<p align="center">
|
|
17
|
+
<img alt="Node.js 22.12+" src="https://img.shields.io/badge/node-%E2%89%A522.12-5fa04e?logo=node.js&logoColor=white" />
|
|
18
|
+
<img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-7-3178c6?logo=typescript&logoColor=white" />
|
|
19
|
+
<img alt="Docker" src="https://img.shields.io/badge/Docker-pr%C3%AAt-2496ed?logo=docker&logoColor=white" />
|
|
20
|
+
<img alt="Zéro dépendance d'exécution" src="https://img.shields.io/badge/d%C3%A9pendances%20runtime-0-f08a3c" />
|
|
21
|
+
<img alt="Interface en portugais, anglais, espagnol et français" src="https://img.shields.io/badge/interface-PT%20%C2%B7%20EN%20%C2%B7%20ES%20%C2%B7%20FR-4aa8e8" />
|
|
22
|
+
</p>
|
|
23
|
+
|
|
24
|
+
<p align="center">
|
|
25
|
+
<img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/office.gif" width="820" alt="Animation d'une salle de Busybits : des personnages qui tapent à leur bureau, des sous-agents avec un badge et des bulles d'activité" />
|
|
26
|
+
</p>
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
Vous ouvrez Claude Code dans plusieurs projets, lancez des sous-agents, laissez des tâches tourner… et vous ne savez plus
|
|
31
|
+
qui fait quoi. **Busybits** transforme tout ça en un bureau qu'on comprend d'un coup d'œil : qui est en train de taper,
|
|
32
|
+
qui a levé la main parce qu'il **a besoin de vous**, qui a rendu son travail et est parti, qui est allé prendre un café
|
|
33
|
+
en attendant la prochaine instruction — et combien vous avez déjà consommé de chaque compte sur la session de 5 heures
|
|
34
|
+
et sur la semaine.
|
|
35
|
+
|
|
36
|
+
Et quand deux agents ou plus n'ont rien à faire, le bureau s'anime d'une **vie sociale** : chacun a sa propre
|
|
37
|
+
personnalité, et ils regardent le foot ensemble au salon, jouent aux jeux vidéo et au ping-pong, papotent à la cuisine,
|
|
38
|
+
se recoiffent devant le miroir et parient des pièces au chifoumi. Voir [Vie sociale](#vie-sociale).
|
|
39
|
+
|
|
40
|
+
Tout tourne sur votre machine, en lisant les fichiers que Claude Code écrit déjà lui-même (et seulement les lignes
|
|
41
|
+
`alias` de votre shell, pour attribuer une lettre à chaque compte). Rien ne quitte l'ordinateur : Busybits ne lit
|
|
42
|
+
aucun identifiant et ne fait aucun appel externe.
|
|
43
|
+
|
|
44
|
+
## Sommaire
|
|
45
|
+
|
|
46
|
+
- [À quoi ça ressemble](#à-quoi-ça-ressemble)
|
|
47
|
+
- [Installation](#installation)
|
|
48
|
+
- [Mode d'emploi](#mode-demploi)
|
|
49
|
+
- [Comptes et utilisation (5 heures et semaine)](#comptes-et-utilisation-5-heures-et-semaine)
|
|
50
|
+
- [Configuration](#configuration)
|
|
51
|
+
- [Habblaud World](#habblaud-world)
|
|
52
|
+
- [Comment ça marche](#comment-ça-marche)
|
|
53
|
+
- [Confidentialité et sécurité](#confidentialité-et-sécurité)
|
|
54
|
+
- [Développement](#développement)
|
|
55
|
+
- [Dépannage](#dépannage)
|
|
56
|
+
- [Avertissement](#avertissement)
|
|
57
|
+
- [Licence](#licence)
|
|
58
|
+
- [Vie sociale](#vie-sociale)
|
|
59
|
+
|
|
60
|
+
## À quoi ça ressemble
|
|
61
|
+
|
|
62
|
+
**Vue d'ensemble.** L'immeuble a un accueil avec des ascenseurs, une cuisine, des toilettes et un salon ; chaque projet
|
|
63
|
+
qui a une session ouverte reçoit sa salle le long du couloir. En haut, les compteurs et l'utilisation de chaque compte ;
|
|
64
|
+
à gauche, les salles et les agents ; en bas, le fil d'activité.
|
|
65
|
+
|
|
66
|
+

|
|
67
|
+
|
|
68
|
+
<table>
|
|
69
|
+
<tr>
|
|
70
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/agent-details.png" alt="Panneau de détails d'un agent avec ses tâches, ses sous-agents, sa chronologie et ses statistiques" /></td>
|
|
71
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/night.png" alt="Le bureau la nuit, avec les lampadaires allumés et les salles éclairées" /></td>
|
|
72
|
+
</tr>
|
|
73
|
+
<tr>
|
|
74
|
+
<td><b>Détails de l'agent :</b> activité en cours, tâches avec leur progression, sous-agents, chronologie et statistiques.</td>
|
|
75
|
+
<td><b>Jour et nuit :</b> le ciel aux fenêtres et l'éclairage suivent l'heure locale.</td>
|
|
76
|
+
</tr>
|
|
77
|
+
</table>
|
|
78
|
+
|
|
79
|
+
<table>
|
|
80
|
+
<tr>
|
|
81
|
+
<td width="42%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/collab.png" alt="Un sous-agent remet son résultat à l'agent principal pendant qu'une autre agente demande la permission" /></td>
|
|
82
|
+
<td width="58%">
|
|
83
|
+
<b>La collaboration bien visible.</b> Les sous-agents sont des collègues avec leur propre nom et un badge : ils
|
|
84
|
+
arrivent par l'ascenseur, travaillent dans la salle du projet et, une fois leur travail terminé, vont remettre le
|
|
85
|
+
résultat (📦) à l'agent qui les a appelés avant de partir.<br /><br />
|
|
86
|
+
<b>A besoin de vous.</b> Quand un agent attend une permission ou une réponse dans le terminal, il court à son bureau
|
|
87
|
+
et lève la main, avec un signal qui clignote — et une alerte s'affiche à l'écran (en option avec un son et une
|
|
88
|
+
notification du navigateur). Vous pouvez valider, répondre à la question ou envoyer la prochaine instruction
|
|
89
|
+
directement depuis là.
|
|
90
|
+
</td>
|
|
91
|
+
</tr>
|
|
92
|
+
</table>
|
|
93
|
+
|
|
94
|
+
<table>
|
|
95
|
+
<tr>
|
|
96
|
+
<td width="58%">
|
|
97
|
+
<b>En attente du shell.</b> Quand l'agent finit son tour mais laisse une commande tourner (tests, build,
|
|
98
|
+
déploiement…), il ne part pas se promener : il reste à son bureau avec un sablier qui tourne au-dessus de la
|
|
99
|
+
tête, le terminal qui affiche la progression et une bulle avec la commande et le temps écoulé. Et l'attente tourne
|
|
100
|
+
à la comédie : d'abord il mange du pop-corn en regardant le terminal ; après 3 min, il croise les bras et tourne
|
|
101
|
+
sur sa chaise ; après 10 min, il se couvre de toiles d'araignée ; après 25 min, il pique un somme. Quand la
|
|
102
|
+
commande se termine, il se lève et fête ça avec des confettis — ou récolte un nuage de pluie si elle a échoué.
|
|
103
|
+
Dans la liste latérale et dans les détails, un chronomètre indique depuis combien de temps chaque commande tourne.
|
|
104
|
+
</td>
|
|
105
|
+
<td width="42%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/shell-wait.png" alt="Un agent mange du pop-corn à son bureau, avec un sablier au-dessus de la tête et la bulle « Lancer la suite de tests · 1 min » ; au rang de devant, une collègue attend depuis plus longtemps, avec une toile d'araignée sur sa chaise et le terminal qui affiche la progression" /></td>
|
|
106
|
+
</tr>
|
|
107
|
+
</table>
|
|
108
|
+
|
|
109
|
+
**La lumière s'éteint.** Quand vous fermez la dernière session d'un projet, le dernier personnage va jusqu'à
|
|
110
|
+
l'interrupteur, éteint la lumière et sort par l'ascenseur — puis la salle est démontée et devient un jardin jusqu'à
|
|
111
|
+
l'arrivée d'un nouveau projet. Si le jardin se retrouve entre deux salles, la salle la plus éloignée déménage : elle est
|
|
112
|
+
montée à l'emplacement libre, l'équipe s'y rend à pied, et l'ancienne adresse s'éteint et est démontée. Ainsi,
|
|
113
|
+
l'immeuble ne garde pas de trous et rétrécit tout seul.
|
|
114
|
+
|
|
115
|
+
| 1. La salle est montée, encore éteinte | 2. Quelqu'un allume la lumière et tout le monde travaille | 3. Le dernier sort et éteint la lumière | 4. La salle devient un jardin |
|
|
116
|
+
| --- | --- | --- | --- |
|
|
117
|
+
|  |  |  |  |
|
|
118
|
+
|
|
119
|
+
<table>
|
|
120
|
+
<tr>
|
|
121
|
+
<td width="34%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/mobile.png" alt="Busybits sur un téléphone, avec l'utilisation des comptes en haut" /></td>
|
|
122
|
+
<td>
|
|
123
|
+
<b>Aussi sur téléphone.</b> L'interface s'adapte aux petits écrans : l'utilisation des comptes reste en haut, la
|
|
124
|
+
liste des salles devient un panneau coulissant et les détails s'ouvrent de bas en haut. Pour autoriser l'accès
|
|
125
|
+
depuis le réseau local, voir <a href="#ouvrir-sur-le-téléphone-facultatif">Ouvrir sur le téléphone</a>.
|
|
126
|
+
</td>
|
|
127
|
+
</tr>
|
|
128
|
+
</table>
|
|
129
|
+
|
|
130
|
+
> Les images ci-dessus utilisent le **mode démonstration** (projets, personnes et comptes fictifs).
|
|
131
|
+
|
|
132
|
+
## Installation
|
|
133
|
+
|
|
134
|
+
### Installer (npm)
|
|
135
|
+
|
|
136
|
+
Nécessite **Node.js 22.12+** et npm. Sans cloner ni compiler :
|
|
137
|
+
|
|
138
|
+
```bash
|
|
139
|
+
npx busybits setup --service
|
|
140
|
+
# ou, pour garder la commande :
|
|
141
|
+
npm i -g busybits && busybits setup --service
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
`busybits setup` installe la version empaquetée dans `~/.busybits`, installe le mod Claude Code, l'extension Pi et les
|
|
145
|
+
hooks Codex (chacun seulement si l'outil est présent) et, avec `--service`, un service utilisateur toujours actif
|
|
146
|
+
(`busybits.service` sous Linux, `com.busybits.server` sous macOS). Ouvrez ensuite **http://localhost:4747**. Options de
|
|
147
|
+
setup : `--service`, `--port <n>`, `--no-claude`, `--no-pi`, `--no-codex`, `--dry-run`, `--ignore-node`.
|
|
148
|
+
|
|
149
|
+
| Commande | Ce qu'elle fait |
|
|
150
|
+
| --- | --- |
|
|
151
|
+
| `busybits status` | affiche l'installation et l'état du service |
|
|
152
|
+
| `busybits start` | lance le serveur au premier plan |
|
|
153
|
+
| `busybits update` | met à jour vers la dernière version (voir [Mettre à jour](#mettre-à-jour)) |
|
|
154
|
+
| `busybits update --rollback` | revient à la version précédente |
|
|
155
|
+
| `busybits uninstall` | retire extensions et services (`--purge` efface aussi les données) |
|
|
156
|
+
| `busybits pair` | associe cette machine comme satellite d'un Busybits central |
|
|
157
|
+
|
|
158
|
+
**Où se trouve chaque chose**
|
|
159
|
+
|
|
160
|
+
- `~/.busybits` (`BUSYBITS_HOME` le change) : les versions installées, les shims de la commande et le marketplace.
|
|
161
|
+
- Les données restent dans `~/.habblaud` et le fichier d'environnement dans `~/.config/habblaud/env`, comme avant ; une
|
|
162
|
+
installation depuis un clone est reprise sur place et garde son appairage et son état TLS.
|
|
163
|
+
- `habblaud.service` / `com.habblaud.server` deviennent `busybits.service` / `com.busybits.server` (setup retire les
|
|
164
|
+
anciens).
|
|
165
|
+
|
|
166
|
+
**Bon à savoir**
|
|
167
|
+
|
|
168
|
+
- **Codex :** après la première prise de contrôle, approuvez de nouveau les hooks Busybits dans `/hooks` de Codex.
|
|
169
|
+
- **Linux :** `node-pty` (prise de contrôle du terminal) ne compile qu'avec les outils de build (une chaîne d'outils C/C++ et Python, pour node-gyp) ;
|
|
170
|
+
sans eux l'installation fonctionne et la prise de contrôle reste désactivée.
|
|
171
|
+
- **Node et le service :** le service empaqueté démarre via un shim qui cherche Node à chaque démarrage ; changer de
|
|
172
|
+
version de Node est donc sans risque. Un service installé **depuis un clone** fixe le Node qui a exécuté
|
|
173
|
+
`npm run setup` ; relancez setup après avoir changé de Node.
|
|
174
|
+
- **Windows :** `busybits setup`, `update` et `uninstall` refusent et renvoient vers `scripts/windows/install-satellite.ps1`
|
|
175
|
+
(depuis un clone).
|
|
176
|
+
|
|
177
|
+
Depuis un clone (développement), voir les étapes ci-dessous.
|
|
178
|
+
|
|
179
|
+
### Prérequis
|
|
180
|
+
|
|
181
|
+
- **macOS** (testé) ou Linux.
|
|
182
|
+
- **[Claude Code](https://code.claude.com)** installé, avec un ou plusieurs comptes (2.1.287 ou plus récent pour le mod).
|
|
183
|
+
- **Node.js 22.12+** et **npm** (développé avec Node 24 ; l'image Docker utilise déjà Node 24).
|
|
184
|
+
- **Docker Desktop** (ou Docker Engine avec Compose v2), si vous voulez le faire tourner dans un conteneur.
|
|
185
|
+
|
|
186
|
+
### 1. Téléchargez le projet
|
|
187
|
+
|
|
188
|
+
```bash
|
|
189
|
+
git clone https://github.com/marmottajr/habblaud.git
|
|
190
|
+
cd habblaud
|
|
191
|
+
npm install
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
> `npm install` ne télécharge que des outils de compilation (Vite, TypeScript, tsx…). Le serveur de Busybits n'a
|
|
195
|
+
> aucune dépendance d'exécution : il n'utilise que les modules natifs de Node.
|
|
196
|
+
|
|
197
|
+
### 2. Lancez Busybits
|
|
198
|
+
|
|
199
|
+
**Option A — Docker (recommandé pour le laisser toujours allumé)**
|
|
200
|
+
|
|
201
|
+
```bash
|
|
202
|
+
npm run docker:up
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
Le script détecte vos comptes Claude Code, ne monte que les dossiers nécessaires (en lecture seule), construit l'image
|
|
206
|
+
et démarre le conteneur — qui redémarre tout seul avec Docker. Ouvrez **http://localhost:4747**.
|
|
207
|
+
|
|
208
|
+
**Option B — Node, sans Docker**
|
|
209
|
+
|
|
210
|
+
```bash
|
|
211
|
+
npm run build
|
|
212
|
+
npm start
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
Ouvrez **http://localhost:4747**. Pour développer, utilisez `npm run dev` (serveur + Vite avec rechargement automatique).
|
|
216
|
+
|
|
217
|
+
Ouvrez maintenant Claude Code dans n'importe quel projet et regardez votre agent arriver par l'ascenseur. 🎉
|
|
218
|
+
|
|
219
|
+
### 3. Installez le mod Busybits dans Claude Code (recommandé)
|
|
220
|
+
|
|
221
|
+
```bash
|
|
222
|
+
npm run mod:install # o mod e os plugins de permissões e de mensagens, em cada conta
|
|
223
|
+
npm run mod:install -- --sem-permissoes # sem responder permissões e perguntas pelo escritório
|
|
224
|
+
npm run mod:install -- --sem-mensagens # sem mandar mensagens aos agentes pelo escritório
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
Busybits fournit un [mod](https://code.claude.com/docs/en/plugins/mods/overview) (un plugin qui tourne à l'intérieur de
|
|
228
|
+
Claude Code) et l'installe dans chaque compte, via `claude plugin` lui-même, à partir de ce dossier. Avec lui :
|
|
229
|
+
|
|
230
|
+
- l'**utilisation sur 5 heures et sur la semaine** de chaque compte s'affiche en direct dans Busybits ;
|
|
231
|
+
- le terminal affiche une ligne quand **une autre session a besoin de vous** (permission ou réponse) ;
|
|
232
|
+
- la commande **`/busybits`** devient disponible dans Claude Code ;
|
|
233
|
+
- vous pouvez **valider ou refuser depuis le bureau** les demandes de permission (« Do you want to… ») et **répondre aux
|
|
234
|
+
questions** de l'agent, avec le plugin `busybits-permissions` (voir [Répondre depuis le bureau](#répondre-depuis-le-bureau)) ;
|
|
235
|
+
- vous pouvez **envoyer des messages** à l'agent depuis le bureau, comme si vous tapiez dans son terminal, avec le plugin
|
|
236
|
+
`busybits-messages` (voir [Envoyer des messages](#envoyer-des-messages)).
|
|
237
|
+
|
|
238
|
+
Il faut **Claude Code 2.1.287 ou plus récent** (`claude --version`). Le mod tourne dans chaque session, avec vos
|
|
239
|
+
permissions, et n'accède qu'à ce qui est listé dans [`mod/README.md`](mod/README.md) ; pour vérifier sans rien exécuter,
|
|
240
|
+
`claude plugin validate mod/habblaud` affiche les événements qu'il traite et les appels qu'il fait. Les sessions déjà
|
|
241
|
+
ouvertes chargent le mod avec `/reload-plugins` (ou à leur réouverture). Si le compte utilisait l'ancienne méthode
|
|
242
|
+
(ci-dessous), `mod:install` retire la dérivation (tap) et le hook du `settings.json` (avec sauvegarde), puisque le mod
|
|
243
|
+
fait la même chose. Vérifiez avec `npm run mod:status` ; pour revenir en arrière : `npm run mod:uninstall`.
|
|
244
|
+
|
|
245
|
+
> Le mod est lu depuis ce dossier. Si vous déplacez le dossier, relancez `npm run mod:install`.
|
|
246
|
+
|
|
247
|
+
<details>
|
|
248
|
+
<summary><b>Claude Code antérieur à 2.1.287 : l'ancienne méthode</b></summary>
|
|
249
|
+
|
|
250
|
+
Sans les mods, l'utilisation en direct et la réponse depuis le bureau passent par deux installateurs qui modifient le
|
|
251
|
+
`settings.json` de chaque compte (avec une sauvegarde préalable) :
|
|
252
|
+
|
|
253
|
+
```bash
|
|
254
|
+
npm run usage:install # põe um "tap" na frente do statusline de cada conta, que captura o uso de 5h/semanal
|
|
255
|
+
npm run hooks:install # acrescenta o hook PermissionRequest, para responder permissões pelo escritório
|
|
256
|
+
```
|
|
257
|
+
|
|
258
|
+
Votre statusline continue de s'afficher comme avant. Pour revenir en arrière : `npm run usage:uninstall` et
|
|
259
|
+
`npm run hooks:uninstall`. Les deux pointent vers ce dossier : si vous déplacez le dossier, relancez-les (en attendant,
|
|
260
|
+
la statusline des comptes affiche une erreur). Quand vous mettrez à jour Claude Code, passez au mod :
|
|
261
|
+
`npm run mod:install` retire l'ancienne dérivation et l'ancien hook (avec sauvegarde) pour éviter que deux mécanismes
|
|
262
|
+
capturent l'utilisation ou répondent à la même demande.
|
|
263
|
+
|
|
264
|
+
</details>
|
|
265
|
+
|
|
266
|
+
### 4. Codex dans le bureau (facultatif)
|
|
267
|
+
|
|
268
|
+
Si vous utilisez aussi **Codex** d'OpenAI (la CLI `codex` ou l'app), ses sessions entrent dans le même bureau : chaque
|
|
269
|
+
projet est une salle — la même que celle de Claude Code, quand les deux sont ouverts sur le même projet — et chaque
|
|
270
|
+
session, un personnage avec le badge **CODEX**. Busybits trouve tout seul le dossier de Codex (`~/.codex`, `CODEX_HOME`
|
|
271
|
+
ou `~/.codex*`) et lit les conversations, sans rien installer. Pour voir Codex **en direct** (ce qu'il fait en ce
|
|
272
|
+
moment, qui a besoin de vous) et valider des commandes depuis le bureau, installez les hooks :
|
|
273
|
+
|
|
274
|
+
```bash
|
|
275
|
+
npm run codex:install # acrescenta os hooks do Busybits em ~/.codex/hooks.json (backup antes; os outros ficam)
|
|
276
|
+
npm run codex:status # confere
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
Ensuite, **ouvrez Codex et validez les hooks de Busybits dans `/hooks`** : Codex n'exécute un nouveau hook qu'après
|
|
280
|
+
votre validation (Busybits n'enregistre jamais cette validation à votre place). Avec Busybits dans Docker, pour envoyer
|
|
281
|
+
des messages aux sessions Codex, laissez aussi tourner `npm run codex:bridge` sur le Mac (voir [Codex](#codex)).
|
|
282
|
+
|
|
283
|
+
### Ouvrir sur le téléphone (facultatif)
|
|
284
|
+
|
|
285
|
+
Par défaut, Busybits n'accepte que les connexions venant de l'ordinateur lui-même. Pour l'ouvrir sur le téléphone (sur
|
|
286
|
+
le même Wi-Fi), avec Docker :
|
|
287
|
+
|
|
288
|
+
```bash
|
|
289
|
+
printf 'HABBLAUD_BIND=0.0.0.0\n' > .env
|
|
290
|
+
npm run docker:up -- --no-build
|
|
291
|
+
```
|
|
292
|
+
|
|
293
|
+
Ouvrez ensuite `http://<ip-do-computador>:4747` sur le téléphone (sur macOS : `ipconfig getifaddr en0` ; si le
|
|
294
|
+
résultat est vide, `ipconfig getifaddr en1`). En mode Node, utilisez `HABBLAUD_HOST=0.0.0.0 npm start`.
|
|
295
|
+
|
|
296
|
+
> ⚠️ Dans ce cas, n'importe quel appareil du réseau voit l'activité des agents (commandes, fichiers, titres des
|
|
297
|
+
> sessions). À n'utiliser que sur des réseaux de confiance. Le [terminal](#terminal) (et avec lui la réponse et l'envoi
|
|
298
|
+
> de messages depuis le bureau) reste désactivé tant que le port est exposé. Pour revenir en arrière : supprimez le
|
|
299
|
+
> `.env` et lancez `npm run docker:up -- --no-build`.
|
|
300
|
+
|
|
301
|
+
#### Téléphone avec connexion et HTTPS (valider les demandes)
|
|
302
|
+
|
|
303
|
+
Au lieu d'exposer le port principal, ouvrez un **second port avec identifiant, mot de passe et HTTPS**. Le port 4747
|
|
304
|
+
reste limité à l'ordinateur (les hooks, les plugins et votre navigateur continuent de fonctionner sans connexion) ; le
|
|
305
|
+
port distant s'ouvre au réseau et chaque requête qui y arrive exige une connexion. Ce qui distingue les deux, c'est le
|
|
306
|
+
port par lequel la connexion est arrivée, jamais l'en-tête Host. Rien de tout cela n'existe avant le setup : sans lui,
|
|
307
|
+
aucun port supplémentaire n'est publié.
|
|
308
|
+
|
|
309
|
+
```bash
|
|
310
|
+
npm run remote:setup # usuário, senha, nome do endereço e (opcional) um endereço próprio
|
|
311
|
+
npm run docker:up
|
|
312
|
+
```
|
|
313
|
+
|
|
314
|
+
`remote:setup` n'écrit dans le `.env` que le **hash** du mot de passe (scrypt), crée une CA locale et le certificat du
|
|
315
|
+
serveur dans `~/.habblaud/remote-tls`, et laisse un service qui annonce `<nome>.local` sur le réseau (mDNS ;
|
|
316
|
+
LaunchAgent sous macOS, systemd sous Linux). Ouvrez `https://<nome>.local` sur le téléphone (avec `:4748` si le port
|
|
317
|
+
443 était occupé). La première fois, acceptez l'avertissement, touchez **Installez le certificat Busybits** et
|
|
318
|
+
faites-lui confiance (iPhone : Réglages › Profil téléchargé › Installer, puis Réglages › Général › Informations ›
|
|
319
|
+
Réglages des certificats ; Android : Sécurité › Chiffrement et identifiants › Installer un certificat › Certificat CA),
|
|
320
|
+
en vérifiant l'empreinte que le setup a affichée.
|
|
321
|
+
|
|
322
|
+
- **CA restreinte :** elle ne signe que `localhost`, les noms `.local`, votre propre adresse et les IP de réseau privé.
|
|
323
|
+
Même si sa clé fuitait, un certificat pour n'importe quel autre site serait refusé par le téléphone qui lui fait
|
|
324
|
+
confiance. Changer votre propre adresse crée une nouvelle CA (réinstallez le certificat sur le téléphone). La clé de
|
|
325
|
+
la CA n'entre jamais dans le conteneur.
|
|
326
|
+
- **Adresse propre** (ex. : `meuclaude.home`) : elle figure dans le certificat, mais le téléphone ne la trouve qu'avec
|
|
327
|
+
une entrée dans le DNS du routeur pointant vers l'IP de l'ordinateur. `<nome>.local` fonctionne sans rien configurer.
|
|
328
|
+
- **Ce que le téléphone peut faire :** par défaut, valider et refuser les demandes de permission.
|
|
329
|
+
`HABBLAUD_REMOTE_ALLOW` dans le `.env` accepte `permissions`, `messages`, `terminal` et `spawn`, séparés par des
|
|
330
|
+
virgules, ou `none` (consultation seule). Le terminal interactif ne fonctionne jamais depuis le téléphone.
|
|
331
|
+
- **Livraisons** (téléphone, avec `terminal` autorisé) : le bouton en forme de boîte dans la barre du haut liste ce que
|
|
332
|
+
chaque agent a terminé, avec un résumé et des pièces jointes (captures d'écran, PDF, fichiers qu'il a envoyés) qui
|
|
333
|
+
s'ouvrent d'un simple toucher.
|
|
334
|
+
- **Nouvel agent** (le bouton **+**) : lance une session Claude Code en arrière-plan sur l'ordinateur (`claude --bg`,
|
|
335
|
+
dans le dossier choisi), qui apparaît dans le bureau et reçoit les messages et les demandes de permission via
|
|
336
|
+
Busybits. Dans un dossier auquel Claude Code ne fait pas encore confiance, il ouvre, déjà rempli, l'écran de nouvelle
|
|
337
|
+
session de l'appli Claude, et vous appuyez sur Enter là-bas. **Désactivé par défaut :** il faut `HABBLAUD_PTY=1` (la
|
|
338
|
+
même activation que le [terminal interactif](#terminal-interactif-prendre-le-contrôle-nouvelle-session-et-fermer) ;
|
|
339
|
+
dans Docker, mettez-la dans le `.env` et laissez tourner `npm run codex:bridge` sur l'ordinateur) et, depuis le
|
|
340
|
+
téléphone, `spawn` dans `HABBLAUD_REMOTE_ALLOW` aussi.
|
|
341
|
+
- **Nouvel agent dans herdr :** la fenêtre propose les fournisseurs installés sur l'ordinateur (Claude Code, Gentle
|
|
342
|
+
Shell et Codex) et où ouvrir la session : en arrière-plan (Claude Code seulement, comme ci-dessus), dans un nouvel
|
|
343
|
+
onglet herdr d'un workspace choisi, ou dans une division à droite ou en bas d'un panneau herdr existant. Une division
|
|
344
|
+
crée toujours un nouveau panneau et ne touche jamais celui choisi ; le dossier choisi dans la fenêtre l'emporte sur
|
|
345
|
+
celui du panneau. Il faut herdr ouvert sur l'ordinateur, Habblaud hors Docker et la session `default` de herdr ;
|
|
346
|
+
sinon ces options apparaissent désactivées avec une indication. **Prendre le contrôle ici** sur une session ouverte
|
|
347
|
+
là-bas met son panneau herdr au premier plan. La reprise de ces sessions après un redémarrage de herdr **n'est pas
|
|
348
|
+
encore vérifiée** pour aucun des trois fournisseurs (voir
|
|
349
|
+
[`docs/herdr-resume-verification.md`](docs/herdr-resume-verification.md)). Pour Gentle Shell, herdr n'enregistre la
|
|
350
|
+
session que via son intégration pi : `herdr integration install pi` est le moyen d'activer la reprise, elle aussi non
|
|
351
|
+
vérifiée.
|
|
352
|
+
Avec herdr ouvert et rien de choisi avant, la fenêtre présélectionne un nouvel onglet herdr, aussi pour Claude
|
|
353
|
+
Code, pour que les nouvelles sessions soient là où herdr peut les reprendre ; le dernier fournisseur et la
|
|
354
|
+
dernière destination sont retenus.
|
|
355
|
+
- **Dictée** (dans Nouvel agent et dans la zone de message) : nécessite `whisper-cli` et `ffmpeg` (`brew install
|
|
356
|
+
whisper-cpp ffmpeg`) et un modèle multilingue dans `~/.local/share/whisper/` (`ggml-small.bin` se trompe moins que
|
|
357
|
+
`ggml-base.bin` ; les `.en` ne comprennent que l'anglais). Sans eux, le bouton Dicter n'apparaît pas. La voix ne
|
|
358
|
+
quitte jamais l'ordinateur. `HABBLAUD_WHISPER_BIN`, `HABBLAUD_FFMPEG_BIN`, `HABBLAUD_WHISPER_MODEL` et
|
|
359
|
+
`HABBLAUD_DICTATION_LANGS` (par défaut `pt,en`) permettent de l'ajuster.
|
|
360
|
+
- **Hors de chez vous (Tailscale) :** avec Tailscale sur l'ordinateur et sur le téléphone, `tailscale serve --bg
|
|
361
|
+
--https=443 https+insecure://127.0.0.1:443` publie le port distant (avec connexion) uniquement pour vos appareils,
|
|
362
|
+
avec un certificat valide sur `https://<computador>.<tailnet>.ts.net` ; ajoutez ce nom à `HABBLAUD_ALLOWED_HOSTS`.
|
|
363
|
+
Pointez toujours vers le port distant, jamais vers le 4747 (qui ne demande pas de connexion).
|
|
364
|
+
- **Session :** 30 jours ; changer le mot de passe (relancer le setup) les ferme toutes, et **Réglages › Accès
|
|
365
|
+
depuis le téléphone › Se déconnecter** ferme celle de cet appareil. Après 5 mauvais mots de passe d'affilée, chaque nouvelle tentative attend
|
|
366
|
+
de 1 s à 5 min.
|
|
367
|
+
- **L'IP a changé ?** `docker:up` réémet le certificat du serveur quand la nouvelle IP n'y figure pas ou quand il
|
|
368
|
+
expire dans moins de 30 jours, avec la même CA (le téléphone continue de lui faire confiance) ; le serveur remplace le
|
|
369
|
+
certificat sans redémarrer.
|
|
370
|
+
- **Désactiver :** `npm run remote:setup -- --off` et `npm run docker:up`.
|
|
371
|
+
|
|
372
|
+
Sans HTTPS, le port distant ne démarre pas ; `HABBLAUD_REMOTE_INSECURE_HTTP=1` force le HTTP simple (mot de passe et
|
|
373
|
+
cookie en clair sur le réseau). En mode Node : `HABBLAUD_REMOTE_PORT` et `HABBLAUD_REMOTE_HOST` (par défaut
|
|
374
|
+
`0.0.0.0:4748`) et `HABBLAUD_REMOTE_TLS_DIR` (par défaut `~/.habblaud/remote-tls/server`).
|
|
375
|
+
|
|
376
|
+
### Mettre à jour
|
|
377
|
+
|
|
378
|
+
La version utilisée s'affiche dans la barre du haut, à côté de « Connecté », et dans **Réglages › À propos**. Sur une
|
|
379
|
+
installation empaquetée, Busybits interroge npm toutes les 6 heures par défaut (clone et Docker : désactivé ;
|
|
380
|
+
`HABBLAUD_UPDATE_CHECK=1` ou `0` le change). Quand une nouvelle version sort, le badge vert **Nouvelle version** remplace
|
|
381
|
+
le numéro. **À propos** a le lien vers les nouveautés (aussi dans [`CHANGELOG.md`](CHANGELOG.md)), le bouton
|
|
382
|
+
**Vérifier maintenant** et, sur une installation empaquetée, **Mettre à jour maintenant**, qui lance `busybits update`
|
|
383
|
+
hors du service. Depuis un terminal :
|
|
384
|
+
|
|
385
|
+
```bash
|
|
386
|
+
busybits update # vers la dernière version
|
|
387
|
+
busybits update --check # affiche seulement la version actuelle et la dernière
|
|
388
|
+
busybits update --to 1.2.0 # vers une version précise
|
|
389
|
+
busybits update --global # met aussi à jour la commande busybits globale
|
|
390
|
+
busybits update --rollback # revient à la version précédente
|
|
391
|
+
```
|
|
392
|
+
|
|
393
|
+
- Refuse de démarrer tant qu'une autre mise à jour tourne (fichier de verrou `~/.busybits/update.lock` ; si aucune ne
|
|
394
|
+
tourne vraiment, supprimez-le).
|
|
395
|
+
- Si la nouvelle version échoue au setup ou ne répond pas sur `/api/health` en 30 s, elle revient à la précédente (la vérification de `/api/health` et son retour arrière n'ont lieu que si un service en arrière-plan est installé ; un échec du setup revient toujours en arrière).
|
|
396
|
+
- L'interrompre avec Ctrl-C pendant l'attente de santé laisse en général la **nouvelle** version active : lancez
|
|
397
|
+
`busybits update --rollback` pour revenir.
|
|
398
|
+
- Windows : `busybits update` n'est pas disponible ; voir la section d'installation.
|
|
399
|
+
|
|
400
|
+
**Depuis un clone** (ou Docker) :
|
|
401
|
+
|
|
402
|
+
```bash
|
|
403
|
+
git pull
|
|
404
|
+
npm install
|
|
405
|
+
npm run docker:up # ou: npm run build && npm start (e depois npm run mod:install)
|
|
406
|
+
```
|
|
407
|
+
|
|
408
|
+
> Si `git pull` s'arrête avec « Your local changes to the following files would be overwritten by merge:
|
|
409
|
+
> package-lock.json », lancez `git checkout -- package-lock.json` et recommencez : jusqu'à la 0.4.0, `npm install`
|
|
410
|
+
> modifiait ce fichier.
|
|
411
|
+
|
|
412
|
+
`docker:up` met aussi à jour le mod dans les comptes où il est déjà installé (il ne l'installe jamais tout seul) et
|
|
413
|
+
vous prévient : « Mod mis à jour en 0.3.0 pour Compte D ; sessions ouvertes : /reload-plugins ». En mode Node, lancez
|
|
414
|
+
`npm run mod:install` après la mise à jour. Pour que Busybits interroge npm, utilisez `HABBLAUD_UPDATE_CHECK=1`
|
|
415
|
+
(dans le `.env`, pour Docker).
|
|
416
|
+
|
|
417
|
+
#### Migrer depuis CodeTown
|
|
418
|
+
|
|
419
|
+
Busybits s'appelait **CodeTown** jusqu'à la 0.3.2. Après le `git pull`, lancez une fois :
|
|
420
|
+
|
|
421
|
+
```bash
|
|
422
|
+
npm install
|
|
423
|
+
npm run mod:install # troca o marketplace e os plugins codetown pelos habblaud, em cada conta
|
|
424
|
+
npm run docker:up # tira o container codetown e copia os dados do volume antigo para o novo
|
|
425
|
+
```
|
|
426
|
+
|
|
427
|
+
- **Mod :** tant que `mod:install` n'a pas été lancé, Claude Code se plaint, dans les comptes, du marketplace `codetown`
|
|
428
|
+
(les dossiers `mod/codetown*` ont changé de nom). `docker:up` vous prévient, mais ne fait pas le remplacement tout seul.
|
|
429
|
+
- **Docker :** l'ancien volume (`codetown_codetown-data`) reste intact. Après avoir vérifié que les noms des personnages
|
|
430
|
+
ont bien été repris, supprimez-le avec `docker volume rm codetown_codetown-data`, et l'ancienne image avec `docker image rm codetown:local`.
|
|
431
|
+
- **Dossier local :** `~/.codetown` devient `~/.habblaud` tout seul (dans le serveur, dans `docker:up` et dans `mod:install`).
|
|
432
|
+
- **Navigateur :** les préférences et les pièces passent aux nouvelles clés la première fois que la page s'ouvre.
|
|
433
|
+
- **Variables :** les `CODETOWN_*` ne sont plus prises en compte ; renommez-les en `HABBLAUD_*` dans le `.env` (ex. : `HABBLAUD_BIND`). Le
|
|
434
|
+
serveur et `docker:up` vous préviennent quand ils en trouvent une ancienne.
|
|
435
|
+
- **Dépôt :** c'est désormais `github.com/marmottajr/habblaud` (GitHub redirige l'ancienne adresse). Pour mettre à jour le
|
|
436
|
+
clone : `git remote set-url origin https://github.com/marmottajr/habblaud.git`. Le dossier local peut garder son
|
|
437
|
+
ancien nom.
|
|
438
|
+
- Les sauvegardes du `settings.json` faites avant le changement de nom gardent le nom `settings.json.codetown-backup-<data>`.
|
|
439
|
+
|
|
440
|
+
### Désinstaller
|
|
441
|
+
|
|
442
|
+
```bash
|
|
443
|
+
busybits uninstall --dry-run # montre ce qui serait retiré
|
|
444
|
+
busybits uninstall # retire le service, l'extension Pi, les hooks Codex et le mod
|
|
445
|
+
busybits uninstall --purge # efface aussi les données de Busybits
|
|
446
|
+
npm rm -g busybits # seulement si vous l'avez installé globalement
|
|
447
|
+
```
|
|
448
|
+
|
|
449
|
+
**Depuis un clone** (ou Docker) :
|
|
450
|
+
|
|
451
|
+
```bash
|
|
452
|
+
npm run mod:uninstall # tira o mod, os plugins de permissões e de mensagens e o marketplace
|
|
453
|
+
npm run codex:uninstall # tira os hooks do Busybits do Codex (os outros ficam)
|
|
454
|
+
npm run docker:down # para o container
|
|
455
|
+
docker volume rm habblaud_habblaud-data # apaga os dados do container (nomes, salas, linha do tempo e estatísticas)
|
|
456
|
+
docker image rm habblaud:local # apaga a imagem
|
|
457
|
+
rm -rf ~/.habblaud # apaga os dados locais (uso capturado, nomes, salas, linha do tempo e estatísticas)
|
|
458
|
+
```
|
|
459
|
+
|
|
460
|
+
Il ne reste plus qu'à supprimer le dossier du projet — lancez `mod:uninstall` **avant**, sinon Claude Code se plaindra,
|
|
461
|
+
dans les comptes, du marketplace disparu. Si vous avez utilisé l'ancienne méthode, lancez aussi `npm run usage:uninstall`
|
|
462
|
+
(qui rétablit la statusline d'origine) et `npm run hooks:uninstall` (qui retire le hook de permission) ; sans eux, la
|
|
463
|
+
statusline des comptes se met à afficher une erreur (et le hook, à échouer en silence). `mod:install`, qui retire
|
|
464
|
+
l'ancienne dérivation et l'ancien hook, ainsi que les anciens installateurs et désinstallateurs, laissent des copies
|
|
465
|
+
`settings.json.habblaud-backup-<data>` dans le dossier de chaque compte (ex. : `~/.claude/`) ; supprimez-les si vous
|
|
466
|
+
n'en avez plus besoin.
|
|
467
|
+
|
|
468
|
+
## Mode d'emploi
|
|
469
|
+
|
|
470
|
+
### Ce que fait chaque personnage
|
|
471
|
+
|
|
472
|
+
| État | Ce que vous voyez |
|
|
473
|
+
| --- | --- |
|
|
474
|
+
| **Au travail** | À son bureau, en train de taper. L'écran et une bulle montrent l'activité : 📖 lecture, ✏️ modification, 💻 terminal, 🧪 tests, 🌐 recherche… |
|
|
475
|
+
| **A besoin de vous** | Court à son bureau et lève la main, avec un signal qui clignote : il attend une permission ou une réponse dans le terminal. |
|
|
476
|
+
| **Attend le shell** | A fini son tour mais a laissé une commande tourner (tests, build, déploiement…) ; il reste donc à son bureau avec un sablier qui tourne au-dessus de la tête et le terminal en pleine progression : il mange du pop-corn en regardant, après 3 min il croise les bras et tourne sur sa chaise, après 10 min il se couvre de toiles d'araignée et après 25 min il pique un somme ; quand la commande se termine, il se lève et fête ça avec des confettis (ou récolte un nuage de pluie si elle a échoué). Au bout de 40 s, s'il y a des collègues sans rien à faire, il peut rejoindre un groupe — sablier sur la tête. |
|
|
477
|
+
| **Inactif** | A fini son tour et se promène : café à la cuisine, fontaine à eau, toilettes, canapé du salon, téléphone sur le pouf, miroir. Avec des collègues sans rien à faire, il rejoint un groupe : télé, jeux vidéo, ping-pong, pause à la cuisine, chifoumi (voir [Vie sociale](#vie-sociale)). Après 10 min sans bouger, il pique un somme — mais un collègue peut le réveiller pour rejoindre un groupe. |
|
|
478
|
+
| **Sous-agent terminé** | Va jusqu'à l'agent qui l'a appelé, lui remet le résultat et sort par l'ascenseur. |
|
|
479
|
+
| **Session terminée** | S'en va ; si c'était le dernier de la salle, il éteint la lumière avant de sortir. |
|
|
480
|
+
|
|
481
|
+
Chaque personnage a un **prénom brésilien unique** (Marina, Henrique, Luan…) qu'il garde tant que la session existe, et
|
|
482
|
+
une **pastille colorée avec la lettre du compte** (C, D…).
|
|
483
|
+
|
|
484
|
+
### Interface
|
|
485
|
+
|
|
486
|
+
- **En haut :** les compteurs (salles, agents, au travail, sous-agents, shells en cours, ont besoin de vous) et une carte
|
|
487
|
+
d'**utilisation par compte**. Celui des shells n'apparaît que lorsqu'une commande tourne ; cliquez dessus pour aller
|
|
488
|
+
jusqu'à celui qui attend. Sous le logo se trouvent la connexion et la version utilisée, qui devient le badge
|
|
489
|
+
**Nouvelle version** quand une nouvelle version sort (voir [Mettre à jour](#mettre-à-jour)).
|
|
490
|
+
- **Panneau latéral :** recherche, filtre par compte et liste des salles avec leurs agents et sous-agents.
|
|
491
|
+
- **Panneau de détails :** cliquez sur un personnage (dans l'immeuble ou dans la liste) pour voir son activité, ses
|
|
492
|
+
tâches, ses sous-agents, sa chronologie et ses statistiques (outils, tokens, coût, lignes modifiées, modèle, branche).
|
|
493
|
+
- **Fil d'activité :** les dernières activités de tout le bureau.
|
|
494
|
+
- **Réglages (⚙) :** noms, bulles, à quel point les inactifs se promènent, cycle jour/nuit, sons, notifications du
|
|
495
|
+
navigateur, limite de FPS (60/30/15 FPS) et mise en pause quand l'onglet est masqué, mode démonstration et **À propos** (version utilisée et nouvelle version). **Aide (?) :** légende complète
|
|
496
|
+
et raccourcis.
|
|
497
|
+
- **Panneau de Performances :** l'icône de jauge dans la barre supérieure affiche l'utilisation des ressources en temps réel par machine (centrale et satellites : processeur, mémoire RSS/tas, délai de boucle d'événements p99, temps de fonctionnement, compteurs d'activité et sparklines sur 10 minutes) et dans le navigateur (FPS, temps d'image p50/p95 comme indicateur du GPU, tâches longues, tas JS, nœuds du DOM et limite de FPS). Le rafraîchissement ne tourne que lorsque le panneau est ouvert et visible.
|
|
498
|
+
- **Ma journée (📊) :** où est passé le temps de la journée (voir [Ma journée](#ma-journée)). **Timelapse** et
|
|
499
|
+
**Historique** (les horloges de la barre du haut) : voir [Timelapse de la journée](#timelapse-de-la-journée) et [Terminal](#terminal).
|
|
500
|
+
|
|
501
|
+
**Caméra :** faites glisser pour la déplacer, utilisez la molette pour zoomer, double-cliquez sur un personnage pour le suivre.
|
|
502
|
+
|
|
503
|
+
**Raccourcis :** `/` recherche · `F` suivre la sélection · `T` terminal · `L` timelapse · `M` ma journée · `P` demande
|
|
504
|
+
suivante (permission ou question) · `O` ou `0` vue d'ensemble · `Esc` effacer la sélection · `[` panneau latéral · `]` fil d'activité · flèches/`WASD` déplacer ·
|
|
505
|
+
`+` `-` zoom · `?` aide.
|
|
506
|
+
|
|
507
|
+
### Thèmes du bureau
|
|
508
|
+
|
|
509
|
+
Dans **Réglages → Apparence → Thème du bureau**, choisissez :
|
|
510
|
+
|
|
511
|
+
- **Automatique** (par défaut) : suit le calendrier, à l'heure locale. Halloween du 1er au 31 octobre, Noël du
|
|
512
|
+
1er novembre au 26 décembre et, le reste de l'année, l'apparence d'origine.
|
|
513
|
+
- **Aucun** : toujours l'apparence d'origine.
|
|
514
|
+
- **Noël** : guirlandes, lumières chaudes, sapins avec des cadeaux, tapis de Noël, neige aux fenêtres et bonnets sur les personnages.
|
|
515
|
+
- **Halloween** : citrouilles, fantômes décoratifs, toiles d'araignée, chauves-souris, lumières violettes, tapis thématiques et accessoires de déguisement.
|
|
516
|
+
|
|
517
|
+
Le changement est immédiat et le choix est enregistré dans ce navigateur. Les thèmes conservent les trajets,
|
|
518
|
+
les activités et les animations des agents. Le cycle jour/nuit reste une option indépendante.
|
|
519
|
+
|
|
520
|
+
<table>
|
|
521
|
+
<tr>
|
|
522
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/seasonal-christmas.png" alt="Le bureau avec le thème Noël : sapins avec des cadeaux dans les coins des salles, guirlandes et lumières aux murs, tapis rouges et personnages en bonnet" /></td>
|
|
523
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/seasonal-halloween.png" alt="Le bureau avec le thème Halloween : citrouilles et fantômes à la place des plantes, toiles d'araignée et chauves-souris aux murs, tapis violets et personnages déguisés" /></td>
|
|
524
|
+
</tr>
|
|
525
|
+
</table>
|
|
526
|
+
|
|
527
|
+
### Langues
|
|
528
|
+
|
|
529
|
+
L'interface est disponible en **portugais, anglais, espagnol et français**. Elle suit la langue du navigateur ; dans
|
|
530
|
+
**Réglages › Langue**, vous pouvez en fixer une (le choix est enregistré dans ce navigateur). Les textes générés par le
|
|
531
|
+
serveur (activités, alertes, terminal, journaux et scripts d'installation) suivent `HABBLAUD_LANG` et, à défaut, la
|
|
532
|
+
langue du système et, sinon, l'anglais. Pour une autre langue, définissez `HABBLAUD_LANG` (`pt-BR`, `en`, `es` ou `fr` ;
|
|
533
|
+
dans Docker, dans le `.env`), par exemple `HABBLAUD_LANG=es`. Un texte sans traduction s'affiche en portugais.
|
|
534
|
+
|
|
535
|
+
### Jour, nuit et sons
|
|
536
|
+
|
|
537
|
+
Le bureau suit l'**heure locale** : tard dans la nuit et le soir, la pelouse et la rue deviennent bleutées et sombres,
|
|
538
|
+
les lampadaires, les lampes, les machines et les écrans allumés projettent des halos de lumière, les salles occupées
|
|
539
|
+
sont éclairées (la lumière qui s'éteint quand la salle se vide reste de mise), les voitures passent phares allumés et
|
|
540
|
+
des lucioles apparaissent dans le jardin. À l'aube (~5–7 h) et au crépuscule (~17–19 h), tout prend une teinte chaude,
|
|
541
|
+
et pendant la journée le soleil entre par les fenêtres et dessine des bandes de lumière sur le sol — courtes à midi,
|
|
542
|
+
longues et orangées en fin d'après-midi. Dans **Réglages › Cycle jour/nuit**, vous pouvez choisir automatique, toujours
|
|
543
|
+
jour ou toujours nuit ; pour tester une heure, utilisez `?hora=21:30` dans l'URL.
|
|
544
|
+
|
|
545
|
+
Les **sons** sont désactivés par défaut. Une fois activés dans **Réglages › Sons**, ils sont synthétisés par le
|
|
546
|
+
navigateur lui-même (sans fichiers audio) et discrets : le clavier de ceux qui travaillent dans les salles visibles, le
|
|
547
|
+
« ding » de l'ascenseur quand quelqu'un arrive ou s'en va, la cloche quand quelqu'un a besoin de vous, le petit
|
|
548
|
+
claquement d'une tâche terminée, et le ping-pong et l'arcade des groupes. Il y a un volume général, et chaque catégorie
|
|
549
|
+
s'active et se désactive séparément. Quand l'onglet est masqué, seule la cloche sonne.
|
|
550
|
+
|
|
551
|
+
### Terminal
|
|
552
|
+
|
|
553
|
+
Cliquez sur un agent et utilisez **Ouvrir le terminal** pour voir la conversation de la session telle que Claude Code
|
|
554
|
+
l'affiche : les prompts, les réponses, chaque outil appelé (avec la commande ou le diff) et le résultat, mis à jour en
|
|
555
|
+
direct. Cela vaut pour les agents principaux et les sous-agents ; en mode démonstration, la conversation est fictive.
|
|
556
|
+
|
|
557
|
+
En bas, pour les agents principaux, vous pouvez **taper** : `Enter` envoie et `Shift+Enter` va à la ligne. Le texte
|
|
558
|
+
entre dans la session comme si vous l'aviez tapé dans son terminal (voir [Envoyer des messages](#envoyer-des-messages)) ;
|
|
559
|
+
si l'agent est occupé, il entre quand l'agent a fini ce qu'il est en train de faire. Les sous-agents et les sessions de
|
|
560
|
+
l'historique restent en lecture seule.
|
|
561
|
+
|
|
562
|
+
- **Recherche :** quand le terminal a le focus, `Ctrl+F` (`⌘F` sur Mac) ou la loupe de l'en-tête ouvre la recherche
|
|
563
|
+
dans la conversation, sans tenir compte des majuscules ni des accents. Le compteur indique la position (« 3/17 ») ;
|
|
564
|
+
`Enter` et `Shift+Enter` passent au résultat suivant et au précédent, en dépliant les blocs repliés (« … +N lignes »)
|
|
565
|
+
où se trouve le terme. La recherche reste active pendant que de nouveaux messages arrivent. `Esc` ferme la recherche ;
|
|
566
|
+
l'appui suivant ferme le terminal.
|
|
567
|
+
- **Filtre :** **Tout**, **Prompts seuls** (vos prompts et les réponses finales de l'agent, sans les étapes
|
|
568
|
+
intermédiaires) ou **Sans outils**.
|
|
569
|
+
- **Copier :** survolez (ou mettez le focus sur) un prompt, une réponse, une commande ou un résultat pour le copier.
|
|
570
|
+
- **Historique :** l'horloge de la barre du haut liste les sessions des 7 derniers jours de tous les comptes (jusqu'à
|
|
571
|
+
150), regroupées par jour, avec une recherche par titre, projet ou compte. Une session terminée s'ouvre dans le
|
|
572
|
+
terminal avec le projet, le titre et la date dans l'en-tête et « Session terminée à … » en bas ; une session encore
|
|
573
|
+
ouverte ouvre le terminal en direct de l'agent.
|
|
574
|
+
|
|
575
|
+
Comme le terminal (et l'historique) affiche toute la conversation, il n'existe que lorsque Busybits est accessible
|
|
576
|
+
**uniquement depuis l'ordinateur lui-même** (par défaut) et ne s'ouvre que via `http://localhost` ou `http://127.0.0.1`.
|
|
577
|
+
Avec le port ouvert au réseau (`HABBLAUD_BIND=0.0.0.0` ou `HABBLAUD_HOST=0.0.0.0`), il est désactivé. Détails dans
|
|
578
|
+
[Confidentialité et sécurité](#confidentialité-et-sécurité).
|
|
579
|
+
|
|
580
|
+
### Terminal interactif (prendre le contrôle, nouvelle session et fermer)
|
|
581
|
+
|
|
582
|
+
Avec `HABBLAUD_PTY=1` et en lançant avec `npm start` (hors Docker), la fenêtre de terminal de chaque agent principal
|
|
583
|
+
est interactive : le bouton **Ouvrir le terminal** du panneau de détails, le raccourci à côté de chaque agent dans la
|
|
584
|
+
liste latérale ou la touche `T` ouvrent la même fenêtre, avec des onglets pour les autres agents du même projet.
|
|
585
|
+
|
|
586
|
+
- Session ouverte ici : c'est le vrai Claude Code (taper, répondre ; Esc interrompt l'agent, comme dans le terminal).
|
|
587
|
+
- Session ouverte dans un autre terminal : **Prendre le contrôle ici** (en haut de la fenêtre) ferme la session là-bas
|
|
588
|
+
et poursuit la **même conversation** ici (`claude --resume <sessão>`, dans le même dossier et avec le même compte).
|
|
589
|
+
Le personnage garde son nom. Sous Windows, le terminal d'où la session est partie revient à la normale (Busybits
|
|
590
|
+
désactive les modes souris/clavier que Claude avait activés).
|
|
591
|
+
- **Fermer** met fin à la session, qu'elle soit ici ou dans un autre terminal (la conversation reste enregistrée).
|
|
592
|
+
- **Nouvelle session** (dans le panneau de la salle) ouvre un nouveau Claude Code dans le dossier du projet.
|
|
593
|
+
|
|
594
|
+
Prendre le contrôle et fermer demandent un second clic ; fermer la fenêtre ne met pas fin à la session. La fenêtre (et
|
|
595
|
+
le panneau de l'agent) peut être déplacée par sa barre et redimensionnée par le coin ; un double clic sur la barre la
|
|
596
|
+
remet à sa place.
|
|
597
|
+
**Désactivé par défaut :** activez-le avec `HABBLAUD_PTY=1` (lisez d'abord l'avertissement dans [Confidentialité et sécurité](#confidentialité-et-sécurité)).
|
|
598
|
+
Utilise `node-pty`, `@xterm/headless` (dépendances optionnelles) et le `claude` du PATH (`HABBLAUD_CLAUDE_BIN` pour
|
|
599
|
+
un autre) ; n'accepte que les requêtes venant de l'ordinateur lui-même. Au démarrage, Busybits ouvre un terminal de
|
|
600
|
+
test : si `node-pty` ou `claude` ne fonctionnent pas, la fonction reste désactivée et le journal en donne la raison.
|
|
601
|
+
**Redémarrer Busybits met fin aux sessions qu'il a ouvertes.**
|
|
602
|
+
Le terminal en direct reste disponible dans l'historique des sessions, pour les sous-agents et quand le mode interactif est désactivé.
|
|
603
|
+
|
|
604
|
+
### Timelapse de la journée
|
|
605
|
+
|
|
606
|
+
Le bouton **Timelapse** (une horloge avec une flèche de retour, ou la touche `L`) rejoue la journée en accéléré : les
|
|
607
|
+
salles qui s'allument et s'éteignent, les agents qui arrivent, travaillent, vous attendent, rejoignent les groupes, les
|
|
608
|
+
sous-agents qui entrent et sortent. La barre de lecture contient le jour, lecture/pause, la vitesse (60×, 180× ou
|
|
609
|
+
600× : une journée de 10 h en 10, 3⅓ ou 1 min), la chronologie déplaçable avec le graphique de qui était présent et au
|
|
610
|
+
travail, les repères des pics (cliquez pour y sauter) et **Revenir au direct**. Pendant ce temps, le bureau prend une
|
|
611
|
+
légère teinte sépia, avec le badge **REPLAY 14:32**, et le fil d'activité continue de montrer ce qui se passe maintenant.
|
|
612
|
+
|
|
613
|
+
Le serveur enregistre la chronologie **à partir du moment où il est allumé** (impossible de reconstituer le passé) :
|
|
614
|
+
des résumés de ce que le bureau affiche, sans les conversations, dans `~/.habblaud/timeline/` (dans Docker, dans le
|
|
615
|
+
volume de données), avec une taille limite par jour et les **7 derniers jours** conservés. Pour ne pas enregistrer :
|
|
616
|
+
`HABBLAUD_TIMELINE=0`. Détails dans [`server/README.md`](server/README.md#timeline-timelapse).
|
|
617
|
+
|
|
618
|
+
Les personnages marchent plus vite pendant le replay, mais aux vitesses élevées, ceux qui restent peu de temps au
|
|
619
|
+
bureau atteignent à peine leur poste ; sauter à un autre moment montre tout le monde déjà en place.
|
|
620
|
+
### Répondre depuis le bureau
|
|
621
|
+
|
|
622
|
+
Avec le plugin de permissions installé (`npm run mod:install`, qui l'installe en même temps que le mod ; avec Claude Code
|
|
623
|
+
antérieur à 2.1.287, `npm run hooks:install`), quand un agent demande une permission — exécuter une commande, modifier
|
|
624
|
+
un fichier, ouvrir une page — la demande apparaît dans le bureau : le personnage lève la main, une alerte avec
|
|
625
|
+
**Répondre** s'affiche à l'écran et, dans les détails de l'agent, la carte **Demande la permission** montre la commande
|
|
626
|
+
(ou le diff de la modification) avec les boutons :
|
|
627
|
+
|
|
628
|
+
- **Valider** — et, quand Claude Code le propose, **Valider et ne plus demander** (la même règle que le terminal
|
|
629
|
+
proposerait, par exemple `Bash(npm test:*)` dans ce projet) ;
|
|
630
|
+
- **Refuser** — avec un motif facultatif, transmis à l'agent, et la possibilité de l'interrompre ;
|
|
631
|
+
- **Répondre dans le terminal** — Busybits laisse la demande de côté.
|
|
632
|
+
|
|
633
|
+
Le dialogue continue de s'afficher dans le terminal en même temps, et c'est la première réponse qui compte : si vous
|
|
634
|
+
répondez dans le terminal, la demande disparaît toute seule du bureau. Le compteur **ont besoin de vous** (et la touche
|
|
635
|
+
`P`) vous emmène à chaque demande.
|
|
636
|
+
|
|
637
|
+
Les **questions de l'agent** (`AskUserQuestion`) aussi : la carte de questions montre chaque question avec ses
|
|
638
|
+
options et leurs descriptions, comme le terminal les afficherait. Choisissez une option (ou plusieurs, quand la question
|
|
639
|
+
le permet) ou écrivez la vôtre dans **Autre**, puis utilisez **Répondre** ; **Refuser…** indique à l'agent que vous ne
|
|
640
|
+
voulez pas répondre, et **Répondre dans le terminal** laisse la question là-bas. La réponse arrive à l'agent comme si
|
|
641
|
+
vous l'aviez choisie dans le terminal.
|
|
642
|
+
|
|
643
|
+
- La demande passe par un hook `PermissionRequest` de Claude Code (celui du plugin, ou celui de l'ancienne méthode), qui
|
|
644
|
+
ne la détourne que lorsqu'**une page de Busybits est ouverte** sur cet ordinateur ; si Busybits est arrêté ou
|
|
645
|
+
qu'aucune page n'est ouverte, il se termine aussitôt et le terminal fonctionne normalement.
|
|
646
|
+
- Sans réponse depuis le bureau au bout de 5 minutes (jusqu'à 24 h avec `HABBLAUD_PERMISSION_TIMEOUT=86400` dans le
|
|
647
|
+
bloc `env` du `settings.json`), la demande ne vaut plus que dans le terminal (les options du plugin sont dans
|
|
648
|
+
[`mod/README.md`](mod/README.md) ; avec l'ancienne méthode, `npm run hooks:install -- --timeout 120` change le délai
|
|
649
|
+
et `--port`, le port). Pour les **sous-agents en arrière-plan**, Claude Code n'affiche le dialogue dans le terminal
|
|
650
|
+
qu'une fois le hook terminé : répondez depuis le bureau ou utilisez **Répondre dans le terminal**. Avec une attente
|
|
651
|
+
de plus de 5 minutes, si 5 minutes passent sans aucune page ouverte capable de répondre (et sans
|
|
652
|
+
[téléphone avec connexion](#téléphone-avec-connexion-et-https-valider-les-demandes) configuré pour répondre), la
|
|
653
|
+
demande revient au terminal.
|
|
654
|
+
- Cela fonctionne avec le même verrou que le terminal : uniquement avec Busybits accessible seulement depuis l'ordinateur
|
|
655
|
+
lui-même et ouvert via `http://localhost`. Vérifiez avec `npm run mod:status` (ou `npm run hooks:status`, avec
|
|
656
|
+
l'ancienne méthode).
|
|
657
|
+
Cela fonctionne aussi depuis le [téléphone avec connexion](#téléphone-avec-connexion-et-https-valider-les-demandes) (c'est le réglage par défaut là-bas).
|
|
658
|
+
- En mode démonstration, les agents fictifs demandent aussi des permissions et posent des questions (pour de faux),
|
|
659
|
+
pour que vous puissiez essayer.
|
|
660
|
+
|
|
661
|
+
### Envoyer des messages
|
|
662
|
+
|
|
663
|
+
Avec le plugin de messages installé (`npm run mod:install`, qui l'installe en même temps que le mod ; nécessite Claude
|
|
664
|
+
Code 2.1.287 ou plus récent), les détails de chaque agent principal gagnent la section **Envoyer un message**, et le bas
|
|
665
|
+
du [terminal](#terminal) devient une zone de saisie. Écrivez et appuyez sur `Enter` (`Shift+Enter` va à la ligne) : le
|
|
666
|
+
texte entre dans la session **comme si vous l'aviez tapé dans son terminal**. Vous pouvez répondre quand l'agent finit
|
|
667
|
+
son tour et attend la demande suivante, donner une nouvelle instruction ou corriger le cap, sans chercher la bonne fenêtre.
|
|
668
|
+
|
|
669
|
+
- La zone indique l'état : **en file** (la session récupère les messages toutes les 2 secondes), **remis** ou **non
|
|
670
|
+
remis**, avec la raison. Si l'agent est occupé, le message attend et entre quand il finit son tour, comme un
|
|
671
|
+
prompt tapé pendant que l'agent travaille.
|
|
672
|
+
- Le plugin tourne dans chaque session et ne parle à Busybits que sur `127.0.0.1`. Sans lui (ou dans une session ouverte
|
|
673
|
+
avant l'installation : utilisez `/reload-plugins`), l'astuce d'installation apparaît à la place de la zone. Les
|
|
674
|
+
sous-agents ne reçoivent pas de messages.
|
|
675
|
+
- Cela fonctionne avec le même verrou que le terminal (accès local uniquement) et peut être désactivé avec `HABBLAUD_MENSAGENS=0`.
|
|
676
|
+
Lisez l'avertissement dans [Confidentialité et sécurité](#confidentialité-et-sécurité).
|
|
677
|
+
Depuis le [téléphone avec connexion](#téléphone-avec-connexion-et-https-valider-les-demandes), seulement avec `messages` dans `HABBLAUD_REMOTE_ALLOW`.
|
|
678
|
+
- En mode démonstration, les agents fictifs reçoivent aussi des messages (pour de faux).
|
|
679
|
+
|
|
680
|
+
### Modifier le personnage
|
|
681
|
+
|
|
682
|
+
Chaque session arrive avec un nom et une apparence tirés au sort. Pour fixer le personnage d'un projet, ouvrez les
|
|
683
|
+
détails de l'agent principal et cliquez sur le crayon à côté du nom (**Modifier le personnage**). Dans l'éditeur :
|
|
684
|
+
|
|
685
|
+
- **Nom :** jusqu'à 24 caractères. Il ne peut pas reprendre celui de quelqu'un qui est dans le bureau ni celui choisi
|
|
686
|
+
pour un autre projet.
|
|
687
|
+
- **Tirer au sort :** propose une autre apparence.
|
|
688
|
+
- **Éléments :** peau, cheveux, barbe, yeux, haut, bas, chaussures et accessoire, avec l'aperçu à côté.
|
|
689
|
+
- **Enregistrer :** s'applique au projet (la salle). La prochaine session ouverte dans ce projet arrive avec ce
|
|
690
|
+
personnage. Avec deux sessions en même temps dans la même salle, la seconde reçoit un personnage tiré au sort.
|
|
691
|
+
- **Revenir au tirage au sort :** annule le choix.
|
|
692
|
+
|
|
693
|
+
Le choix est enregistré dans `~/.habblaud/names.json` et disparaît après 60 jours sans utilisation du projet. L'éditeur
|
|
694
|
+
a le même verrou que le terminal : le crayon n'apparaît qu'avec le terminal activé (sans `HABBLAUD_TERMINAL=0`) et
|
|
695
|
+
l'accès local, c'est-à-dire avec Busybits accessible uniquement depuis l'ordinateur lui-même et ouvert via `http://localhost`.
|
|
696
|
+
|
|
697
|
+
### Codex
|
|
698
|
+
|
|
699
|
+
Les sessions Codex (CLI ou app) apparaissent comme celles de Claude Code : personnage, salle du projet, activité,
|
|
700
|
+
tâches, sous-agents, terminal et historique, utilisation sur 5 heures et sur la semaine, et **Ma journée** (tokens
|
|
701
|
+
seulement : Codex n'indique pas le coût). La pastille du compte Codex est évidée et porte le badge **CODEX**.
|
|
702
|
+
|
|
703
|
+
- **Sans rien installer**, Busybits lit les fichiers que Codex écrit lui-même (les conversations dans `~/.codex/sessions`
|
|
704
|
+
et les verrous des sessions ouvertes dans `~/.codex/thread-writer-locks`). Mais Codex n'écrit chaque étape **qu'une
|
|
705
|
+
fois** qu'elle est terminée et n'écrit jamais « vous attend » : sans les hooks, le bureau montre Codex avec du retard
|
|
706
|
+
et ne prévient pas quand il a besoin de vous.
|
|
707
|
+
- **Avec les hooks** (`npm run codex:install` puis validation dans `/hooks`), Codex prévient Busybits à chaque étape :
|
|
708
|
+
la session apparaît immédiatement, l'activité affichée est celle du moment et une demande de validation fait lever la
|
|
709
|
+
main au personnage.
|
|
710
|
+
- **Valider depuis le bureau :** avec une page de Busybits ouverte, la demande de validation de Codex attend votre
|
|
711
|
+
réponse dans la carte **Demande la permission** jusqu'à **25 secondes** (`npm run codex:install -- --espera <s>`, de 5 à 120) :
|
|
712
|
+
**Valider** ou **Refuser** (avec le motif). Contrairement à Claude Code, Codex n'affiche la validation dans le terminal
|
|
713
|
+
**qu'après** la réponse du bureau ou la fin du délai — en attendant, le terminal affiche « En attente de réponse dans
|
|
714
|
+
Busybits… ». Il n'y a ni « toujours autoriser » ni « interrompre », et Codex ne permet pas de répondre à ses questions
|
|
715
|
+
depuis l'extérieur.
|
|
716
|
+
- **Envoyer des messages :** la zone **Envoyer un message** fonctionne aussi pour Codex, via `codex queue` : le message
|
|
717
|
+
entre dans la file de la session et Codex le prend quand il a fini ce qu'il est en train de faire (jusqu'à une dizaine
|
|
718
|
+
de secondes plus tard). En mode Node, Busybits lance lui-même la commande ; **dans Docker**, laissez tourner
|
|
719
|
+
`npm run codex:bridge` sur le Mac (le conteneur ne voit pas votre Codex).
|
|
720
|
+
- **Utilisation sur 5 heures et sur la semaine :** elle provient des fichiers de Codex eux-mêmes et ne se met à jour que
|
|
721
|
+
pendant qu'une session tourne ; la carte affiche l'âge des chiffres et « sans quota » quand l'espace de travail n'a
|
|
722
|
+
plus de crédits.
|
|
723
|
+
- **Quand la session entre :** au premier message (c'est à ce moment que Codex enregistre le dossier du projet) ; une
|
|
724
|
+
CLI ouverte mais encore sans conversation n'apparaît pas.
|
|
725
|
+
- **Quand la session quitte le bureau :** la CLI de Codex fait tourner les sessions sur un serveur en arrière-plan, qui
|
|
726
|
+
les garde chargées jusqu'à une minute après qu'elles sont devenues inactives et que plus personne ne les regarde ; le
|
|
727
|
+
personnage peut donc mettre un peu de temps à partir après la fermeture du terminal.
|
|
728
|
+
- Les conversations du cloud de ChatGPT (sans fichier sur l'ordinateur) n'apparaissent pas. `HABBLAUD_CODEX=0` désactive Codex.
|
|
729
|
+
|
|
730
|
+
### GitHub dans le bureau
|
|
731
|
+
|
|
732
|
+
Ce que les agents font sur GitHub anime la salle du projet, sans token et sans accès à Internet : Busybits lit dans les
|
|
733
|
+
transcripts les appels (`gh pr create`, `gh pr merge`, `git push`, `gh run watch`, `gh pr checks`, `gh run view`,
|
|
734
|
+
`gh release create` et les outils du MCP de GitHub) et leurs résultats.
|
|
735
|
+
|
|
736
|
+
| Événement | Ce qui se passe |
|
|
737
|
+
| --- | --- |
|
|
738
|
+
| 🎉 **PR ouverte ou mergée, release publiée** | Des confettis tombent dans la salle, tout le monde fête ça en sautillant et une banderole en donne la raison (« PR #12 mergée ! ») pendant ~12 s. |
|
|
739
|
+
| 🚨 **CI au rouge** | Des gyrophares clignotent dans les coins de la salle, le sol devient rougeâtre et une bulle « ! » apparaît au-dessus de celui qui a vu l'échec, jusqu'à une CI au vert dans la salle (qui tourne à la fête) ou pendant 10 min. |
|
|
740
|
+
| 🚀 **Push** | Seulement l'alerte et le fil d'activité. |
|
|
741
|
+
|
|
742
|
+
<table>
|
|
743
|
+
<tr>
|
|
744
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/github-party.png" alt="La salle app-mobile en fête : des confettis tombent, la banderole dorée « PR #12 mergée ! » et Jéssica debout, les bras levés, avec une étoile au-dessus de la tête" /></td>
|
|
745
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/github-alarm.png" alt="La salle data-pipeline en alarme : sol rougeâtre, banderole rouge « CI en échec (feat/checkout) », gyrophares dans les coins du haut et une bulle « ! » rouge à côté d'Ícaro" /></td>
|
|
746
|
+
</tr>
|
|
747
|
+
</table>
|
|
748
|
+
|
|
749
|
+
Chaque événement génère aussi une alerte (« 🎉 Danilo a ouvert la PR #12 dans habblaud », « 🚨 CI en échec dans habblaud (feat/x) ») et entre
|
|
750
|
+
dans le fil d'activité. Seul ce qui se passe en direct anime la salle : ce qui était déjà dans les transcripts à
|
|
751
|
+
l'ouverture de Busybits ne va que dans l'historique. Avec « réduire les animations » activé dans le système, rien ne
|
|
752
|
+
clignote ni ne tourne. En mode démonstration, des PR, des merges et des CI fictifs apparaissent de temps en temps.
|
|
753
|
+
### Ma journée
|
|
754
|
+
|
|
755
|
+
Le bouton **Ma journée** (ou la touche `M`) montre où est passée la journée : combien de temps les agents ont passé à
|
|
756
|
+
travailler et, mis en avant, combien de temps ils sont restés **à vous attendre** (permission, question ou choix) — avec
|
|
757
|
+
la plus longue attente, qui a attendu, où et quand. À côté : sessions, sous-agents, demandes, tokens et coût (quand
|
|
758
|
+
Claude Code enregistre le coût dans le transcript), ainsi que des graphiques par heure, par projet (de celui qui vous a
|
|
759
|
+
le plus attendu à celui qui vous a le moins attendu) et par compte, et le classement des plus longues attentes.
|
|
760
|
+
Choisissez le jour dans le sélecteur (Busybits garde les 30 derniers) ; ouvert sur la journée en cours, le panneau se
|
|
761
|
+
met à jour toutes les 30 s. Chaque graphique a une version en tableau, et la légende active et désactive chaque statut.
|
|
762
|
+
|
|
763
|
+
Le temps compté est du **temps d'agent** : deux agents qui travaillent pendant une heure comptent pour deux heures.
|
|
764
|
+
Busybits ne compte que ce qui se passe pendant qu'il tourne, et la journée suit le fuseau horaire de votre navigateur.
|
|
765
|
+
Avec le mode démonstration activé, le panneau affiche des chiffres fictifs (avec le badge « démonstration ») et permet
|
|
766
|
+
de basculer vers les données réelles ; les agents de la démo n'entrent jamais dans les vraies statistiques.
|
|
767
|
+
|
|
768
|
+
### Mode démonstration
|
|
769
|
+
|
|
770
|
+
Vous voulez voir le bureau plein sans avoir de sessions ouvertes ?
|
|
771
|
+
|
|
772
|
+
- Ajoutez **`?mock=1`** à l'URL (ex. : http://localhost:4747/?mock=1) pour tout simuler dans le navigateur, sans vos
|
|
773
|
+
vraies sessions. Paramètres : `&speed=3` accélère le temps et `&sessions=6` change le nombre de sessions simulées.
|
|
774
|
+
- Ou activez-le depuis l'interface — **Voir la démonstration** (quand le bureau est vide) ou **Réglages › Mode
|
|
775
|
+
démonstration** —, ce qui ajoute des agents fictifs à côté des vrais. Avec `npm run demo` (ou `HABBLAUD_DEMO=1` dans
|
|
776
|
+
le `.env` de Docker), ce mode est activé dès le démarrage.
|
|
777
|
+
|
|
778
|
+
## Comptes et utilisation (5 heures et semaine)
|
|
779
|
+
|
|
780
|
+
> Les comptes **Codex** sont pris en compte automatiquement (chaque dossier `~/.codex*` ou `CODEX_HOME` est un compte ; la
|
|
781
|
+
> lettre vient d'un `alias x='CODEX_HOME=… codex'`, s'il y en a un) et leur utilisation provient des fichiers de Codex ;
|
|
782
|
+
> voir [Codex](#codex). Le reste de cette section concerne Claude Code.
|
|
783
|
+
|
|
784
|
+
Si vous utilisez plus d'un compte Claude Code (par exemple, un raccourci `c` avec `~/.claude` et un `d` avec
|
|
785
|
+
`CLAUDE_CONFIG_DIR=~/.claude-conta2`), Busybits les affiche tous ensemble : chaque agent porte la pastille de son compte
|
|
786
|
+
et le haut de l'écran montre, pour chaque compte, le **pourcentage utilisé** de la session de 5 heures et de la semaine,
|
|
787
|
+
et **quand chaque limite se réinitialise**.
|
|
788
|
+
|
|
789
|
+
**Comment les comptes sont reconnus.** Chaque dossier de configuration de Claude Code est un compte : `~/.claude` et
|
|
790
|
+
tout `~/.claude*` contenant `projects/` ou `sessions/` (en plus de `CLAUDE_CONFIG_DIR`). Pour attribuer une lettre à
|
|
791
|
+
chacun, Busybits lit dans les fichiers du shell (`~/.zshrc`, `~/.bashrc`…) **uniquement** les lignes `alias x='... claude ...'` :
|
|
792
|
+
|
|
793
|
+
```bash
|
|
794
|
+
alias c='claude'
|
|
795
|
+
alias d='CLAUDE_CONFIG_DIR=~/.claude-conta2 claude'
|
|
796
|
+
```
|
|
797
|
+
|
|
798
|
+
devient **Compte C** et **Compte D**. Seuls les raccourcis de 3 lettres maximum sont pris en compte ; les comptes sans
|
|
799
|
+
raccourci reçoivent A, B…
|
|
800
|
+
|
|
801
|
+
**D'où viennent les chiffres.** La méthode recommandée est le mod Busybits (`npm run mod:install`, Claude Code 2.1.287+) :
|
|
802
|
+
dans chaque session, il reçoit de Claude Code lui-même les limites du forfait et ne garde que les pourcentages sur
|
|
803
|
+
5 heures et sur la semaine (et le moment où ils se réinitialisent) dans `~/.habblaud/usage/<conta>.json`. Les chiffres
|
|
804
|
+
arrivent après la prochaine réponse de chaque compte. Vérifiez avec `npm run mod:status`. Avec les versions antérieures
|
|
805
|
+
de Claude Code, la dérivation de statusline (`npm run usage:install`) fait la même chose via la commande de statusline,
|
|
806
|
+
dans le même fichier.
|
|
807
|
+
|
|
808
|
+
<details>
|
|
809
|
+
<summary><b>Détails de la dérivation et du cache de /usage</b></summary>
|
|
810
|
+
|
|
811
|
+
- `usage:install` (ancienne méthode) modifie, dans `<conta>/settings.json`, **seulement** le champ `statusLine.command` :
|
|
812
|
+
la commande d'origine (ex. : `npx -y ccstatusline`) passe désormais par `node "<pasta do Busybits>/scripts/statusline-tap.mjs" --
|
|
813
|
+
<comando original>` (sous Windows, la commande d'origine tourne dans Git Bash, comme Claude Code la lancerait). Une
|
|
814
|
+
copie du fichier est d'abord enregistrée dans `settings.json.habblaud-backup-<data>`. Si le compte n'avait pas de
|
|
815
|
+
statusline, il en crée une qui ne fait que capturer l'utilisation. `npm run usage:install -- --dry-run` montre ce qui
|
|
816
|
+
changerait sans rien écrire.
|
|
817
|
+
- La dérivation transmet le même JSON à votre statusline (sa sortie et son code de sortie restent inchangés) et
|
|
818
|
+
n'enregistre **que** `{accountId, configDir, fetchedAt, five_hour, seven_day}` — ni prompts, ni coûts, ni chemins de
|
|
819
|
+
projet. Tout échec de capture est ignoré : la statusline ne casse jamais à cause de Busybits.
|
|
820
|
+
|
|
821
|
+
| Source | Fonctionnement |
|
|
822
|
+
| --- | --- |
|
|
823
|
+
| **Mod Busybits** (recommandé) | En direct, comme décrit ci-dessus. Remplace la dérivation : `mod:install` retire la dérivation du compte. |
|
|
824
|
+
| Dérivation de statusline (Claude Code antérieur à 2.1.287) | En direct, via la commande de statusline, dans le même fichier. |
|
|
825
|
+
| Cache de `/usage` (toujours actif) | Claude Code enregistre le dernier résultat de la commande `/usage`. En mode Node, Busybits le relit toutes les 60 s ; dans Docker, c'est la valeur lue lors du dernier `npm run docker:up` qui compte. Ne change que lorsque quelqu'un lance `/usage`. |
|
|
826
|
+
|
|
827
|
+
Les sources sont des fichiers locaux : aucune ne lit de mots de passe ou de tokens, ni ne fait d'appels réseau. C'est
|
|
828
|
+
toujours la source aux chiffres les plus récents qui l'emporte. Les chiffres de plus de 30 minutes apparaissent comme
|
|
829
|
+
**pas à jour** ; une fenêtre qui s'est réinitialisée depuis la collecte apparaît comme **—** jusqu'à l'arrivée de
|
|
830
|
+
nouveaux chiffres.
|
|
831
|
+
|
|
832
|
+
</details>
|
|
833
|
+
|
|
834
|
+
## Configuration
|
|
835
|
+
|
|
836
|
+
Tout fonctionne sans rien configurer. Si vous avez besoin d'ajuster quelque chose, utilisez des variables d'environnement
|
|
837
|
+
(en mode Node, chaque `HABBLAUD_X` accepte aussi l'alias `BUSYBITS_X` ; si les deux sont définies, `HABBLAUD_X` l'emporte) :
|
|
838
|
+
|
|
839
|
+
| Variable | Par défaut | À quoi ça sert |
|
|
840
|
+
| --- | --- | --- |
|
|
841
|
+
| `HABBLAUD_PORT` | `4747` | Port HTTP (dans Docker, le port publié sur l'hôte). |
|
|
842
|
+
| `HABBLAUD_HOST` | `127.0.0.1` | Interface du serveur en mode Node. En dehors de `127.0.0.1`/`localhost`, le terminal (ainsi que la réponse et l'envoi de messages depuis le bureau) est désactivé. |
|
|
843
|
+
| `HABBLAUD_BIND` | `127.0.0.1` | Docker uniquement (dans le `.env`) : où le port est publié. `0.0.0.0` ouvre l'accès au réseau local (et désactive le terminal et tout ce qui agit sur les sessions). |
|
|
844
|
+
| `HABBLAUD_CLAUDE_DIRS` | détection automatique | Dossiers des comptes, séparés par des virgules (ex. : `/caminho/conta1,/caminho/conta2`). |
|
|
845
|
+
| `HABBLAUD_DATA_DIR` | `~/.habblaud` | Où Busybits garde ses propres données (noms des personnages et des salles, chronologie du timelapse et statistiques de Ma journée). |
|
|
846
|
+
| `HABBLAUD_TIMELINE` | activé | `0` désactive l'enregistrement de la chronologie (les jours déjà enregistrés restent dans le timelapse). Dans Docker, il est toujours activé. |
|
|
847
|
+
| `HABBLAUD_USAGE_DIR` | `~/.habblaud/usage` | Où le mod (ou la dérivation de statusline) enregistre l'utilisation. |
|
|
848
|
+
| `HABBLAUD_DEMO` | désactivé | `1` active le mode démonstration au démarrage. |
|
|
849
|
+
| `HABBLAUD_ALLOWED_HOSTS` | — | Noms supplémentaires acceptés dans l'adresse (ex. : `meu-mac.local`), en plus de `localhost` et des IP. |
|
|
850
|
+
| `HABBLAUD_TERMINAL` | activé (en accès local uniquement) | `0` désactive le terminal, la réponse et l'envoi de messages depuis le bureau, et l'éditeur de personnage. Avec le port exposé, ils sont déjà désactivés, sans possibilité de les activer. |
|
|
851
|
+
| `HABBLAUD_PTY` | désactivé | `1` active le terminal interactif (ouvrir, reprendre et fermer des sessions Claude Code depuis le bureau ; uniquement en accès local et hors Docker) et **Nouvel agent** (aussi dans Docker, via `npm run codex:bridge`). Lisez l'avertissement dans [Confidentialité et sécurité](#confidentialité-et-sécurité). |
|
|
852
|
+
| `HABBLAUD_CLAUDE_BIN` | `claude` du PATH | L'exécutable de Claude Code que lancent le terminal interactif et Nouvel agent. |
|
|
853
|
+
| `HABBLAUD_REMOTE_ALLOW` | `permissions` | Ce que peut faire le [téléphone avec connexion](#téléphone-avec-connexion-et-https-valider-les-demandes) : `permissions`, `messages`, `terminal`, `spawn` (séparés par des virgules) ou `none`. Les autres `HABBLAUD_REMOTE_*` sont écrites par `npm run remote:setup`. |
|
|
854
|
+
| `HABBLAUD_MENSAGENS` | activé (avec le terminal) | `0` désactive seulement les messages depuis le bureau (la zone dans le terminal et dans les détails de l'agent). |
|
|
855
|
+
| `HABBLAUD_CODEX` | activé | `0` désactive Codex dans le bureau. |
|
|
856
|
+
| `HABBLAUD_CODEX_DIRS` | détection automatique | Dossiers de Codex, séparés par des virgules (à la place de `~/.codex*` et `CODEX_HOME`). |
|
|
857
|
+
| `HABBLAUD_CODEX_BIN` | `codex` du PATH (sous Windows, `codex.exe`) | Le binaire de Codex qui remet les messages (`codex queue`), en mode Node ou dans `npm run codex:bridge`. |
|
|
858
|
+
| `HABBLAUD_UPDATE_CHECK` | empaquetée : activée ; clone/Docker : désactivée | `1` active la vérification de nouvelle version (une requête au registre npm toutes les 6 h), `0` la désactive. |
|
|
859
|
+
| `HABBLAUD_LANG` | langue du système, sinon `en` | Langue des textes générés par le serveur (activités, alertes, journaux) : `pt-BR`, `en`, `es` ou `fr`. L'interface suit le navigateur ou le choix fait dans Réglages › Langue. Voir [Langues](#langues). |
|
|
860
|
+
| `HABBLAUD_ACCOUNTS` | — | JSON pour personnaliser le nom, la lettre ou la couleur, associé par le nom du dossier du compte. Ex. : `[{"id":".claude-conta2","name":"Trabalho","short":"T","color":"#5cc97b"}]`. |
|
|
861
|
+
|
|
862
|
+
**Dans Docker**, sont prises en compte `HABBLAUD_PORT`, `HABBLAUD_BIND`, `HABBLAUD_ALLOWED_HOSTS`, `HABBLAUD_DEMO`, `HABBLAUD_TERMINAL`,
|
|
863
|
+
`HABBLAUD_MENSAGENS`, `HABBLAUD_CODEX`, `HABBLAUD_UPDATE_CHECK`, `HABBLAUD_LANG`, `HABBLAUD_PTY`, les `HABBLAUD_WORLD*` et les
|
|
864
|
+
`HABBLAUD_REMOTE_*` (dans le `.env` ou dans l'environnement) ainsi que `HABBLAUD_CLAUDE_DIRS`, `HABBLAUD_CODEX_DIRS`, `HABBLAUD_USAGE_DIR` et
|
|
865
|
+
`HABBLAUD_ACCOUNTS` (lues par `docker:up` sur l'hôte) ; les autres sont fixées à l'intérieur du conteneur. Options : `npm run docker:up -- --no-build` (démarre sans reconstruire),
|
|
866
|
+
`npm run docker:down` (arrête) et `npm run docker:logs` (suit les journaux).
|
|
867
|
+
|
|
868
|
+
## Habblaud World
|
|
869
|
+
|
|
870
|
+
Habblaud World est une ville en ligne en pixel art où chaque bureau Busybits devient un immeuble, allumé en direct
|
|
871
|
+
pendant que les agents travaillent, et où chacun se promène avec un personnage. **Il est désactivé par défaut dans
|
|
872
|
+
Busybits** : `HABBLAUD_WORLD=1` l'active, pointant vers `server.habblaud.com` ; même alors, **rien ne sort de
|
|
873
|
+
l'ordinateur tant que vous n'avez pas créé de compte** et ouvert une session. L'accès est accordé par liste d'attente.
|
|
874
|
+
|
|
875
|
+
**Comment le configurer.** Activez-le avec `HABBLAUD_WORLD=1` (dans le `.env` ou dans l'environnement) ; les autres
|
|
876
|
+
variables ci-dessous sont facultatives : sans elles, Busybits pointe vers le serveur officiel. La section apparaît dans la fenêtre **Habblaud World** (le bouton ville de la barre du haut) et ne fonctionne que depuis l'ordinateur
|
|
877
|
+
lui-même (jamais par le port du téléphone) ; le compte reste ici seulement, dans `~/.habblaud/world.json` (permission
|
|
878
|
+
600 ; dans Docker, dans le volume `/data`).
|
|
879
|
+
|
|
880
|
+
| Variable | Par défaut | À quoi ça sert |
|
|
881
|
+
| --- | --- | --- |
|
|
882
|
+
| `HABBLAUD_WORLD_URL` | `https://server.habblaud.com` | Adresse du serveur du monde, uniquement `https://` ou `wss://` (sans chemin). |
|
|
883
|
+
| `HABBLAUD_WORLD` | désactivé | `1` active le World (routes et interface). Non définie ou à `0`, il n'y a rien du World et rien ne sort de l'ordinateur. |
|
|
884
|
+
| `HABBLAUD_WORLD_DEV` | désactivé | `1` accepte un serveur du monde local sans TLS : `http://127.0.0.1:<port>` (`npm run dev` l'accepte déjà) ou, depuis Docker, `http://host.docker.internal:<port>`. |
|
|
885
|
+
|
|
886
|
+
**Confidentialité.** Rien de votre travail ne sort de l'ordinateur. De l'immeuble ne sortent que le thème, un étage par
|
|
887
|
+
salle ouverte (avec un code aléatoire qui change chaque jour) et, pour chaque agent, principal ou sous-agent, l'outil,
|
|
888
|
+
le statut, l'apparence, un nom tiré au sort et la tranche de tâches terminées dans la journée. Chemins, noms de
|
|
889
|
+
projets, titres, commandes, messages, code, coût, modèle, branche et votre compte Claude ne sortent jamais. La liste
|
|
890
|
+
complète, champ par champ (en portugais) : [docs/world/privacidade.md](docs/world/privacidade.md). **Voir ce qui a été
|
|
891
|
+
envoyé**, sur la carte Votre immeuble, montre le JSON exact du dernier envoi, avec sa taille en octets et la réponse du
|
|
892
|
+
monde.
|
|
893
|
+
|
|
894
|
+
**Compte et liste d'attente.** Inscription avec e-mail, **nom de joueur** (3 à 20 caractères, unique dans le monde :
|
|
895
|
+
il vous est réservé pendant l'attente sur la liste et devient le nom du personnage) et mot de passe (12 caractères ou
|
|
896
|
+
plus ; les mots de passe ayant fuité sont refusés), code à 6 chiffres par e-mail et acceptation des Conditions
|
|
897
|
+
d'utilisation et de la Politique de confidentialité. Chaque compte entre dans une liste d'attente, et l'accès est ouvert
|
|
898
|
+
par lots : le Busybits ouvert vérifie tout seul toutes les 30 minutes. Jusqu'à 3 ordinateurs par compte (**Appareils**,
|
|
899
|
+
avec révocation).
|
|
900
|
+
|
|
901
|
+
**Personnage.** Le nom de joueur choisi à l'inscription (modifiable ensuite, une fois tous les 30 jours), le même éditeur
|
|
902
|
+
d'apparence que les agents, 2 ou 3 traits de personnalité et une phrase de présentation de la liste (dans le monde, pas
|
|
903
|
+
de texte libre en dehors du nom). On peut le créer dès la liste d'attente.
|
|
904
|
+
|
|
905
|
+
**Immeuble.** Avec le compte validé et le personnage créé, l'immeuble monte tout seul (par WebSocket) et suit le bureau
|
|
906
|
+
en direct. La carte **Votre immeuble** montre la connexion, les étages, les agents, le dernier envoi et, quand le monde
|
|
907
|
+
refuse un envoi ou arrête l'immeuble (ancienne version, autre ordinateur, compte suspendu ou banni), la raison ; un
|
|
908
|
+
compte suspendu ou banni reçoit **Faire appel par e-mail**. Un immeuble marqué « non vérifié » (chiffres hors du
|
|
909
|
+
plausible, en cours d'examen) reste hors des classements et des mises en avant et affiche **Contester par e-mail**.
|
|
910
|
+
Quand le monde est en maintenance, la carte le dit, et Busybits réessaie tout seul.
|
|
911
|
+
|
|
912
|
+
**Visibilité.** En direct (étages, compteurs et statut de chaque personnage) ou **mode discret** (seulement allumé ou
|
|
913
|
+
éteint et le nombre d'étages) ; fermé aux visites ; cacher le pays ; les **tokens** de l'immeuble seulement par tranches
|
|
914
|
+
(jusqu'à 100 000, 1 million…), jamais le nombre ni le coût, et désactivables ; classement et compactages seulement si
|
|
915
|
+
vous les activez ; frapper à la porte (**Me prévenir quand on frappe à la porte**) aussi seulement si vous l'activez.
|
|
916
|
+
|
|
917
|
+
**Ville.** Le bouton **Monde**, dans la barre du haut, remplace le bureau par la ville : on marche avec les flèches/WASD
|
|
918
|
+
ou en cliquant, la carte de chaque immeuble montre étages, agents et état, et la minicarte est dans le coin ; en pause
|
|
919
|
+
ou hors du monde, votre immeuble reste éteint, mais vous pouvez vous promener dans la ville. En mode démonstration
|
|
920
|
+
(`?mock=1&world=approved&scene=city`, seulement des immeubles et des personnes fictifs) :
|
|
921
|
+
[la ville](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-cidade.png) et [la carte d'un immeuble](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-cartao.png).
|
|
922
|
+
|
|
923
|
+
**Visites.** Près de la porte d'un immeuble, **Entrer (E)** vous fait entrer : le bureau du propriétaire en direct, avec
|
|
924
|
+
des salles aux noms fictifs et les agents dans leur statut du moment, en lecture seule (ni terminal, ni messages, ni
|
|
925
|
+
permissions, et rien du travail) ; un immeuble fermé aux visites ne se voit que de l'extérieur. Sur le vôtre, vous voyez
|
|
926
|
+
« N visiteurs en ce moment » (seulement le nombre, jamais qui). En mode démonstration :
|
|
927
|
+
[la visite](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-visita.png) et [le panneau de la visite](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-visita-painel.png).
|
|
928
|
+
|
|
929
|
+
**Social.** Dans la ville, sans aucun texte libre : **L** aime l'immeuble près de la porte, **G** ouvre la roue des
|
|
930
|
+
salutations (phrases toutes faites, traduites pour qui les lit) et **K** frappe à la porte de ceux qui l'acceptent ; la
|
|
931
|
+
carte de chaque personne propose Saluer, Bloquer et Signaler, et la minicarte mène à un immeuble par son code (« Aller à
|
|
932
|
+
HB-XXXX ») ou à n'importe quel immeuble allumé. À l'intérieur d'un immeuble, **J'aime** et **Laisser un tampon** à
|
|
933
|
+
l'accueil (un par immeuble et par jour). Sur la place, le thermomètre de l'objectif hebdomadaire de la ville et, quand
|
|
934
|
+
il est atteint, un feu d'artifice. Au bureau, la puce « ❤️ N aujourd'hui » et la carte « Pendant votre absence » avec
|
|
935
|
+
les visites, les j'aime et les tampons laissés à l'accueil (jamais qui) ; les personnes bloquées sont dans **Bloqués**,
|
|
936
|
+
avec **Débloquer**. En mode démonstration : [la roue des salutations](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-social.png) et
|
|
937
|
+
[la place avec le feu d'artifice](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-praca.png).
|
|
938
|
+
|
|
939
|
+
**Pause, quitter, supprimer.** **Pause** éteint l'immeuble tout de suite et garde le lot (après 30 jours en pause, il
|
|
940
|
+
disparaît de la carte ; 30 jours plus tard, il est retiré). **Quitter le monde** retire l'immeuble et libère le lot ; le
|
|
941
|
+
compte et le personnage restent, et revenir crée un nouvel immeuble. **Supprimer le compte** (dans **Compte et
|
|
942
|
+
données**, avec le code reçu par e-mail) retire l'immeuble et le profil du monde tout de suite, efface le compte, les
|
|
943
|
+
likes, les blocages, les signalements faits et les appareils de la base de données sous 7 jours (et des sauvegardes sous
|
|
944
|
+
30 jours au plus) et efface le `world.json` de cet ordinateur. Sans nouvelles de Busybits pendant 7 jours, l'immeuble
|
|
945
|
+
disparaît de la carte et, 30 jours plus tard, il est retiré ; un e-mail prévient 3 jours avant (désactivable dans
|
|
946
|
+
**Compte et données**).
|
|
947
|
+
|
|
948
|
+
**Exporter.** **Télécharger mes données** (dans **Compte et données**) enregistre `habblaud-world-dados.json` avec ce
|
|
949
|
+
que le monde garde de votre compte : e-mail, dates, personnage, visibilité, appareils, immeuble, likes donnés, blocages
|
|
950
|
+
et signalements faits. Une fois par jour.
|
|
951
|
+
|
|
952
|
+
**Données véridiques.** Le World ne fonctionne que si les immeubles sont vrais : modifier Busybits pour envoyer des
|
|
953
|
+
étages, agents, statuts, tokens ou personnages inventés ou gonflés enfreint les Conditions d'utilisation et fait bannir
|
|
954
|
+
le compte (le serveur vérifie la plausibilité de chaque paquet). Modifier Busybits pour autre chose reste libre (MIT).
|
|
955
|
+
Comment Busybits parle au World (en portugais) : [shared/world/README.md](shared/world/README.md).
|
|
956
|
+
|
|
957
|
+
**Tester avec un serveur du monde local.** Pour qui développe le World, avec le serveur du monde qui tourne sur le même
|
|
958
|
+
ordinateur (par exemple, dans Docker, publié sur le port 4848) :
|
|
959
|
+
|
|
960
|
+
- Hors de Docker : `HABBLAUD_WORLD_URL=http://127.0.0.1:4848 npm run dev`.
|
|
961
|
+
- Avec Busybits dans Docker : dans le `.env` de ce dossier, `HABBLAUD_WORLD_URL=http://host.docker.internal:4848` et
|
|
962
|
+
`HABBLAUD_WORLD_DEV=1` ; ensuite, `npm run docker:up`, qui se termine par la ligne du World
|
|
963
|
+
(`Habblaud World : activé : http://host.docker.internal:4848`, ou pourquoi il est resté désactivé). Le
|
|
964
|
+
`docker-compose.yml` relie déjà `host.docker.internal` à l'hôte (`extra_hosts` avec `host-gateway` ; Docker Desktop a
|
|
965
|
+
déjà ce nom). Sous Linux, le serveur du monde doit écouter sur une interface que le conteneur atteint (`0.0.0.0` ou
|
|
966
|
+
l'IP du pont Docker) : un port publié seulement sur le `127.0.0.1` de l'hôte ne répond pas par `host-gateway`.
|
|
967
|
+
- Sans TLS, seulement avec `HABBLAUD_WORLD_DEV=1` (ou `--dev`) et seulement pour `127.0.0.1` et `host.docker.internal` ;
|
|
968
|
+
sinon, uniquement `https://` ou `wss://`. Le serveur du monde doit accepter le nom utilisé dans l'URL comme hôte du
|
|
969
|
+
jeu (sinon il répond `421`).
|
|
970
|
+
|
|
971
|
+
À quoi ressemble la section, en mode démonstration (`?mock=1&world=logged_out`, `waiting` ou `approved` ; en
|
|
972
|
+
portugais) : [sans compte](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-sem-conta.png), [liste d'attente](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-lista-de-espera.png),
|
|
973
|
+
[personnage](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-personagem.png), [Votre immeuble](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-predio.png) et
|
|
974
|
+
[ce qui a été envoyé](https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/world-enviado.png).
|
|
975
|
+
|
|
976
|
+
## Comment ça marche
|
|
977
|
+
|
|
978
|
+
```
|
|
979
|
+
~/.claude*/sessions/<pid>.json ─────────────────┐
|
|
980
|
+
~/.claude*/projects/<projeto>/<sessão>.jsonl ───┼──▶ servidor Node ──▶ modelo do escritório ──▶ SSE ──▶ navegador
|
|
981
|
+
.../<sessão>/subagents/**/agent-*.jsonl ────────┘ (polling de 1 s) (canvas + interface)
|
|
982
|
+
```
|
|
983
|
+
|
|
984
|
+
- **Qui est dans le bureau :** tant qu'une session est ouverte, Claude Code tient à jour `sessions/<pid>.json` avec le
|
|
985
|
+
projet et le statut (occupé, inactif, en attente de vous ou en attente d'un shell en arrière-plan). C'est ce qui
|
|
986
|
+
décide qui apparaît et ce que fait chacun.
|
|
987
|
+
- **Shells en cours :** dans les transcripts, chaque `Bash` en arrière-plan (ou commande longue au premier plan) devient
|
|
988
|
+
un « shell » avec un libellé et un chronomètre, jusqu'à l'arrivée de la notification indiquant qu'il s'est terminé, a
|
|
989
|
+
échoué ou a été interrompu.
|
|
990
|
+
- **Vie sociale :** les groupes, les personnalités et les pièces sont une simulation du navigateur (`client/src/world/social/`),
|
|
991
|
+
sans aucun effet sur les vrais agents. La personnalité découle de la graine de chaque agent (elle est la même dans
|
|
992
|
+
n'importe quel navigateur) ; les porte-monnaie sont stockés dans le `localStorage` du navigateur.
|
|
993
|
+
- **Ce que fait chacun :** le serveur suit la fin des transcripts (`.jsonl`) des sessions ouvertes et traduit chaque
|
|
994
|
+
appel d'outil en une activité, avec une icône, dans la langue du serveur (voir [Langues](#langues)). Il en tire aussi
|
|
995
|
+
les tâches, le titre, le modèle et les statistiques.
|
|
996
|
+
- **Sous-agents :** les transcripts dans `<sessão>/subagents/` (y compris ceux des workflows) deviennent des personnages
|
|
997
|
+
liés à l'agent qui les a appelés.
|
|
998
|
+
- **GitHub :** les PR, les pushs, la CI et les releases proviennent des mêmes lignes du transcript (la commande et sa
|
|
999
|
+
sortie, ou le `gitOperation` que Claude Code enregistre lui-même) ; rien n'est demandé à GitHub.
|
|
1000
|
+
- **Le dessin :** le navigateur reçoit l'état par SSE et dessine tout sur un canvas — personnages, meubles, sols et murs
|
|
1001
|
+
sont du pixel art **généré par code** ; en revanche, le logo, les illustrations et les tableaux aux murs ont été générés par IA.
|
|
1002
|
+
|
|
1003
|
+
<details>
|
|
1004
|
+
<summary><b>Structure du code et API</b></summary>
|
|
1005
|
+
|
|
1006
|
+
```
|
|
1007
|
+
shared/ protocolo (types.ts), atividades em PT-BR, nomes, simulador de demonstração
|
|
1008
|
+
server/ servidor HTTP + SSE: contas e uso, leitura das sessões e transcripts, modelo do escritório
|
|
1009
|
+
client/ Vite: src/art (pixel art procedural), src/world (o escritório no canvas), src/ui (interface)
|
|
1010
|
+
scripts/ build do servidor, docker-up, instaladores (mod, tap de statusline e hook de permissão) e screenshots
|
|
1011
|
+
mod/ o mod do Busybits e os plugins de permissões e de mensagens (plugins do Claude Code; marketplace em .claude-plugin/)
|
|
1012
|
+
```
|
|
1013
|
+
|
|
1014
|
+
| Route | Description |
|
|
1015
|
+
| --- | --- |
|
|
1016
|
+
| `GET /api/stream` | SSE avec les événements `snapshot`, `feed` et `notice` (format dans `shared/types.ts`). |
|
|
1017
|
+
| `GET /api/snapshot` | État actuel du bureau. |
|
|
1018
|
+
| `GET /api/agents/:id` | Détails d'un agent, avec jusqu'à 200 activités. |
|
|
1019
|
+
| `GET /api/agents/:id/terminal` | SSE du terminal (événements `init` et `append`) ; en accès local uniquement. |
|
|
1020
|
+
| `PUT /api/agents/:id/character` | Modifier le personnage : `{name, seed, parts}` enregistre le nom et l'apparence de l'agent principal comme personnage du projet (la salle) ; en accès local uniquement. |
|
|
1021
|
+
| `DELETE /api/agents/:id/character` | « Revenir au tirage au sort » : supprime le personnage du projet et l'agent reprend le nom tiré au sort ; en accès local uniquement. |
|
|
1022
|
+
| `GET /api/sessions/recent` | Historique : sessions des 7 derniers jours de tous les comptes (jusqu'à 150) ; en accès local uniquement. |
|
|
1023
|
+
| `GET /api/sessions/:conta/:sessionId/terminal` | SSE de la conversation d'une session de l'historique (même protocole que le terminal) ; en accès local uniquement. |
|
|
1024
|
+
| `GET /api/stats?day=AAAA-MM-DD` | Statistiques de Ma journée (temps par statut, projets, comptes, heures, attentes, tokens et coût). |
|
|
1025
|
+
| `GET /api/stats/days` | Jours avec des statistiques (les 30 derniers). |
|
|
1026
|
+
| `GET /api/timeline/days` | Jours enregistrés pour le timelapse, avec la taille et l'heure du premier et du dernier enregistrement. |
|
|
1027
|
+
| `GET /api/timeline/:dia` | Chronologie d'un jour (`AAAA-MM-DD`), en JSONL (avec gzip). |
|
|
1028
|
+
| `GET /api/health` | Santé : version, démonstration, Docker, terminal, réponse et envoi de messages depuis le bureau, sources et statut de l'utilisation de chaque compte. |
|
|
1029
|
+
| `POST /api/demo` | `{"enabled": true \| false}` active ou désactive les agents simulés. |
|
|
1030
|
+
| `POST /api/rooms/rename` | `{"id": sala, "name": nome}` renomme la salle (vide = retour au nom du dossier) ; le nom est enregistré dans `rooms.json`, dans le dossier de données. En accès local uniquement. |
|
|
1031
|
+
| `GET /api/mod/summary` | Pour le mod de Claude Code : version, nombre d'agents, combien travaillent et qui a besoin de vous (sans la démo et, avec `?account=&session=`, sans la session elle-même). |
|
|
1032
|
+
| `/api/permissions…` | Répondre depuis le bureau : le hook de permission enregistre la demande (permission ou question) et attend ; la page récupère le détail et décide ou répond. En accès local uniquement. |
|
|
1033
|
+
| `/api/messages…` et `/api/mod/inbox…` | Envoyer des messages : la page met le message en file et suit sa remise ; le plugin `busybits-messages` le récupère, le remet à la session et confirme. En accès local uniquement. |
|
|
1034
|
+
| `POST /api/codex/events` | Événements des hooks de Codex (session ouverte, outil, validation, fin du tour). En accès local uniquement. |
|
|
1035
|
+
| `/api/codex/bridge/poll` et `/ack` | `npm run codex:bridge` récupère les messages pour Codex et confirme leur remise. En accès local uniquement. |
|
|
1036
|
+
|
|
1037
|
+
Plus de détails sur le serveur dans [`server/README.md`](server/README.md).
|
|
1038
|
+
|
|
1039
|
+
</details>
|
|
1040
|
+
|
|
1041
|
+
<details>
|
|
1042
|
+
<summary><b>Ce que Docker monte et pourquoi</b></summary>
|
|
1043
|
+
|
|
1044
|
+
| Hôte | Conteneur | À quoi ça sert |
|
|
1045
|
+
| --- | --- | --- |
|
|
1046
|
+
| `<conta>/sessions/` | `/claude/<conta>/sessions` (lecture seule) | Sessions ouvertes et leurs statuts. |
|
|
1047
|
+
| `<conta>/projects/` | `/claude/<conta>/projects` (lecture seule) | Transcripts des sessions et des sous-agents. |
|
|
1048
|
+
| `~/.habblaud/usage/` | `/usage` (lecture seule) | Utilisation capturée par le mod (ou par la dérivation de statusline). |
|
|
1049
|
+
| volume `habblaud-data` | `/data` | Données propres à Busybits (noms des personnages, chronologie du timelapse et statistiques de Ma journée). |
|
|
1050
|
+
| `~/.habblaud/remote-tls/server/` | `/remote-tls` (lecture seule) | Seulement après `npm run remote:setup` : le certificat et la clé du serveur du [téléphone avec connexion](#téléphone-avec-connexion-et-https-valider-les-demandes) (jamais la clé de la CA). |
|
|
1051
|
+
|
|
1052
|
+
Le dossier du compte n'est **jamais** monté en entier (il contient les identifiants et les configurations). Le conteneur
|
|
1053
|
+
tourne avec un utilisateur sans privilèges, un système de fichiers en lecture seule, sans capabilities supplémentaires et
|
|
1054
|
+
avec `no-new-privileges`. Les métadonnées des comptes (lettre, e-mail, organisation) sont lues sur l'hôte par
|
|
1055
|
+
`docker:up` et transmises au conteneur.
|
|
1056
|
+
|
|
1057
|
+
</details>
|
|
1058
|
+
|
|
1059
|
+
## Confidentialité et sécurité
|
|
1060
|
+
|
|
1061
|
+
- **Lecture seule :** Busybits n'écrit jamais dans les dossiers de Claude Code. Les exceptions sont les installateurs,
|
|
1062
|
+
que vous lancez vous-même : `npm run mod:install` / `mod:uninstall` utilise `claude plugin` lui-même (qui enregistre le
|
|
1063
|
+
marketplace et les plugins dans le `settings.json` et dans `<conta>/plugins/`) et, à l'installation, retire l'ancienne
|
|
1064
|
+
dérivation et l'ancien hook avec sauvegarde ; avec l'ancienne méthode, `npm run usage:install` / `usage:uninstall` ne
|
|
1065
|
+
modifie que le `statusLine.command` du `settings.json`, et `npm run hooks:install` / `hooks:uninstall`, que la liste
|
|
1066
|
+
`hooks.PermissionRequest` — toujours avec une sauvegarde préalable.
|
|
1067
|
+
- **Le mod :** il tourne dans chaque session de Claude Code, avec vos permissions (comme tout mod), et ne fait que ce qui
|
|
1068
|
+
est listé dans [`mod/README.md`](mod/README.md) — `claude plugin validate mod/habblaud` affiche les événements et les
|
|
1069
|
+
appels, sans rien exécuter. Il n'enregistre que les pourcentages d'utilisation sur 5 heures et sur la semaine (et le
|
|
1070
|
+
moment où ils se réinitialisent) dans `~/.habblaud/usage/<conta>.json` ; pour la ligne « a besoin de vous » et
|
|
1071
|
+
`/busybits`, il ne parle à Busybits que sur `127.0.0.1`. Il ne lit pas la conversation, n'appelle pas le modèle et
|
|
1072
|
+
n'envoie rien hors de l'ordinateur. Il est lu depuis ce dossier : ce qui s'y trouve (y compris après un `git pull`)
|
|
1073
|
+
est ce qui s'exécute. Le plugin de messages (`busybits-messages`) est séparé justement parce qu'il agit : il tape dans
|
|
1074
|
+
la session ce que vous avez envoyé depuis le bureau.
|
|
1075
|
+
- **Local uniquement, par défaut :** le serveur n'accepte que les connexions venant de l'ordinateur lui-même ; ouvrir
|
|
1076
|
+
l'accès au réseau local est facultatif. Il n'y a pas de télémétrie. Le seul appel externe est la vérification de
|
|
1077
|
+
nouvelle version : activée par défaut sur les installations empaquetées (désactivée pour clone et Docker ;
|
|
1078
|
+
`HABBLAUD_UPDATE_CHECK=1` ou `0` la change), toutes les 6 heures, une requête anonyme, sans token, au registre npm
|
|
1079
|
+
(`registry.npmjs.org/busybits`). Elle n'envoie rien sur vos sessions ; npm ne voit que votre IP. Avec
|
|
1080
|
+
`HABBLAUD_UPDATE_CHECK=0` (ou sur un clone sans `=1`), aucune requête.
|
|
1081
|
+
[Habblaud World](#habblaud-world) (désactivé par défaut dans Busybits ; `HABBLAUD_WORLD=1` l'active) n'envoie quelque
|
|
1082
|
+
chose au serveur du monde qu'après la création du compte et l'ouverture de session, et seulement ce qui figure dans
|
|
1083
|
+
[ce qui sort](docs/world/privacidade.md) (en portugais).
|
|
1084
|
+
Le [téléphone avec connexion](#téléphone-avec-connexion-et-https-valider-les-demandes) aussi : il n'existe qu'après `npm run remote:setup`.
|
|
1085
|
+
- **Sans identifiants :** Busybits ne lit ni mots de passe ni tokens d'accès. Du `.claude.json` de chaque compte, il
|
|
1086
|
+
n'utilise que l'e-mail, l'organisation et le cache de `/usage` ; l'utilisation en direct vient du mod (ou de la
|
|
1087
|
+
dérivation de statusline).
|
|
1088
|
+
- **Secrets masqués :** les tokens et mots de passe au format connu (`Bearer`, `-u usuário:senha`, `TOKEN=`, clés
|
|
1089
|
+
`sk-…`, `ghp_…`, `AKIA…`, JWT, mots de passe dans les URL) deviennent `***` avant d'arriver au navigateur.
|
|
1090
|
+
- **Protégé contre les sites malveillants :** le serveur refuse les adresses qui ne sont pas `localhost`/IP (DNS
|
|
1091
|
+
rebinding) et les `POST` venant d'autres origines (CSRF), et empêche l'intégration de la page dans d'autres sites.
|
|
1092
|
+
- **Terminal local uniquement :** la conversation complète des sessions (et l'historique des sessions terminées, avec
|
|
1093
|
+
leurs titres) ne sort du serveur que si Busybits est accessible uniquement depuis l'ordinateur lui-même
|
|
1094
|
+
(`HABBLAUD_HOST` local en Node ; `HABBLAUD_BIND` local dans Docker) — impossible de
|
|
1095
|
+
l'activer avec le port exposé — et chaque requête doit passer par `localhost`/`127.0.0.1` : les IP du réseau et les
|
|
1096
|
+
noms de `HABBLAUD_ALLOWED_HOSTS` (proxys, tunnels) sont refusés. Les secrets sont masqués et les textes longs tronqués
|
|
1097
|
+
avant d'arriver au navigateur ; en mode démonstration, la conversation est fictive. `HABBLAUD_TERMINAL=0` le désactive complètement.
|
|
1098
|
+
Seule exception : le [téléphone avec connexion](#téléphone-avec-connexion-et-https-valider-les-demandes), et seulement avec `terminal` dans `HABBLAUD_REMOTE_ALLOW`.
|
|
1099
|
+
- **Chronologie du timelapse :** uniquement les résumés déjà affichés à l'écran (activité sur une ligne, statut, titres,
|
|
1100
|
+
utilisation des comptes, sans e-mails, commandes complètes ni conversations), enregistrés dans `~/.habblaud/timeline/`
|
|
1101
|
+
et supprimés au bout de 7 jours. `HABBLAUD_TIMELINE=0` désactive l'enregistrement.
|
|
1102
|
+
- **Répondre depuis le bureau, en local uniquement :** valider ou refuser agit sur les sessions, cela suit donc le même
|
|
1103
|
+
verrou que le terminal (bind local, `Host` local, pas de proxys ni de tunnels) et n'existe qu'avec le hook de
|
|
1104
|
+
permission (celui du plugin `busybits-permissions` ou celui de l'ancienne méthode) installé par vous. Les réponses
|
|
1105
|
+
exigent du JSON et une origine locale (un site ouvert dans le navigateur ne peut pas les envoyer), le hook ne parle
|
|
1106
|
+
qu'à `127.0.0.1` et, dans le doute — Busybits hors service, erreur, délai écoulé —, il se termine sans décider : c'est
|
|
1107
|
+
le terminal qui compte. La commande complète ou le diff ne sortent du serveur que pour qui a ouvert la page depuis
|
|
1108
|
+
l'ordinateur lui-même. « Toujours autoriser » n'applique qu'une règle que Claude Code lui-même a proposée pour cette
|
|
1109
|
+
demande. Attention : tout programme ou toute personne capable d'ouvrir `http://localhost:4747` sur cette machine peut
|
|
1110
|
+
aussi répondre ; sur des ordinateurs partagés avec d'autres utilisateurs, n'installez pas le hook
|
|
1111
|
+
(`npm run mod:install -- --sem-permissoes`).
|
|
1112
|
+
Exception : le [téléphone avec connexion](#téléphone-avec-connexion-et-https-valider-les-demandes) répond aussi (c'est son réglage par défaut) et voit la même commande ou le même diff.
|
|
1113
|
+
- **Envoyer des messages, en local uniquement — avec un avertissement :** le message entre dans la session comme si vous
|
|
1114
|
+
l'aviez tapé, donc tout ce que l'agent peut faire à votre demande s'applique. Cela suit le même verrou (bind local,
|
|
1115
|
+
`Host` local, JSON et origine locale, si bien qu'un site ouvert dans le navigateur ne peut pas en envoyer), mais
|
|
1116
|
+
**n'importe quel programme de cette machine** qui parle à `http://localhost:4747` — y compris un agent qui exécute une
|
|
1117
|
+
commande — peut déposer un message pour une autre session qui a le plugin. Si cela ne vous convient pas (ordinateur
|
|
1118
|
+
partagé, agents qui tournent sans supervision), n'installez pas le plugin (`npm run mod:install -- --sem-mensagens`)
|
|
1119
|
+
ou désactivez-le avec `HABBLAUD_MENSAGENS=0`. Le texte des messages n'est pas enregistré : il disparaît du serveur dès
|
|
1120
|
+
qu'il est remis.
|
|
1121
|
+
Depuis le [téléphone avec connexion](#téléphone-avec-connexion-et-https-valider-les-demandes), seulement avec `messages` dans `HABBLAUD_REMOTE_ALLOW`.
|
|
1122
|
+
- **Terminal interactif, sur activation — avec un avertissement :** avec `HABBLAUD_PTY=1`, le bureau ouvre Claude Code
|
|
1123
|
+
dans n'importe quel dossier, y tape (y compris `!comando`, qui s'exécute dans le shell) et ferme ou reprend des
|
|
1124
|
+
sessions ouvertes dans d'autres terminaux. Cela suit le même verrou que le terminal (bind local, `Host` local, pas de
|
|
1125
|
+
proxys ni de tunnels) et chaque requête doit venir de l'ordinateur lui-même, avec une origine locale (un site ouvert
|
|
1126
|
+
dans le navigateur ne peut pas en envoyer). Malgré tout, **n'importe quel programme de cette machine** qui parle à
|
|
1127
|
+
`http://localhost:4747` — y compris un agent qui exécute une commande — obtient ce pouvoir. Avant de mettre fin à un
|
|
1128
|
+
processus externe, Busybits vérifie dans le registre des sessions et dans le système que ce PID correspond toujours à
|
|
1129
|
+
ce Claude Code (même démarrage et même exécutable). Sur des ordinateurs partagés ou avec des agents qui tournent sans
|
|
1130
|
+
supervision, laissez-le désactivé.
|
|
1131
|
+
- **Téléphone avec connexion, sur activation :** n'existe qu'après `npm run remote:setup`. Un second port avec HTTPS
|
|
1132
|
+
(une CA locale qui ne signe que les noms `.local`, `localhost`, votre propre adresse et les IP privées), un
|
|
1133
|
+
identifiant et un mot de passe (seul le hash scrypt est conservé) ; la session est un cookie `HttpOnly`,
|
|
1134
|
+
`SameSite=Strict` et `Secure` signé avec HMAC. Sur ce port, ce qui est autorisé vient de `HABBLAUD_REMOTE_ALLOW` (par
|
|
1135
|
+
défaut, seulement répondre aux demandes de permission), jamais de l'en-tête Host ; les routes des hooks, des plugins
|
|
1136
|
+
et de l'auxiliaire de l'hôte, le terminal interactif, l'éditeur de personnage et le renommage des salles ne
|
|
1137
|
+
fonctionnent jamais par ce port. Qui a le mot de passe obtient ce que vous avez autorisé : choisissez-en un robuste
|
|
1138
|
+
et n'autorisez que le nécessaire. La clé de la CA reste dans `~/.habblaud/remote-tls/ca` et n'entre jamais dans le
|
|
1139
|
+
conteneur.
|
|
1140
|
+
- **Nouvel agent, sur activation :** avec `HABBLAUD_PTY=1`, le bureau lance des sessions Claude Code avec la demande
|
|
1141
|
+
que vous avez écrite, dans le dossier que vous choisissez — le même avertissement que pour le terminal interactif
|
|
1142
|
+
s'applique. Les pièces jointes sont écrites dans `~/.habblaud/attachments/` (dossier 700, fichiers 600). Dans Docker,
|
|
1143
|
+
c'est l'auxiliaire de l'hôte (`npm run codex:bridge`) qui lance les sessions ; il ne lit les fichiers des livraisons
|
|
1144
|
+
que dans les dossiers de projet connus (ceux que Claude Code a dans `<conta>/projects`), le dossier temporaire et les
|
|
1145
|
+
pièces jointes.
|
|
1146
|
+
- **Éditeur de personnage, en local uniquement :** enregistrer ou revenir au tirage au sort modifie le bureau et écrit
|
|
1147
|
+
dans `names.json`, cela suit donc le même verrou que le terminal (bind local, `Host` local, pas de proxys ni de
|
|
1148
|
+
tunnels) : sans lui, le crayon n'apparaît pas et le serveur répond `403`. Les modifications exigent du JSON et une
|
|
1149
|
+
origine locale. `HABBLAUD_TERMINAL=0` le désactive aussi.
|
|
1150
|
+
- **Statistiques de Ma journée :** uniquement des chiffres agrégés (temps par statut, comptages, tokens, coût) avec les
|
|
1151
|
+
noms de projet, de compte et d'agent, conservés dans `HABBLAUD_DATA_DIR/stats/` pendant 30 jours — rien de la conversation.
|
|
1152
|
+
- **Codex :** Busybits ne lit que les conversations (`sessions/`, `archived_sessions/`) et les verrous des sessions
|
|
1153
|
+
ouvertes (`thread-writer-locks/`) ; dans Docker, seuls ces trois dossiers sont montés, en lecture seule. Il ne lit
|
|
1154
|
+
jamais `auth.json`, `config.toml`, l'environnement du shell (`shell_snapshots/`), l'historique des prompts, les
|
|
1155
|
+
journaux ni les bases de données de Codex, et n'affiche pas les identifiants du compte ChatGPT. `npm run codex:install`
|
|
1156
|
+
ne fait qu'ajouter des groupes dans `hooks.json` (avec sauvegarde ; ceux des autres applis restent à leur place) et
|
|
1157
|
+
écrit `~/.habblaud/codex-hook.json` ; la validation des hooks vous revient toujours, dans `/hooks`. Les hooks ne
|
|
1158
|
+
parlent qu'à `127.0.0.1`. Les messages à Codex appellent le même avertissement que ceux de Claude Code : n'importe
|
|
1159
|
+
quel programme de cette machine qui parle à Busybits peut déposer un message dans la file d'une session.
|
|
1160
|
+
- **Ce qui apparaît à l'écran :** des résumés des activités (outil, fichier, commande ou requête), les titres des
|
|
1161
|
+
sessions, les tâches et les statistiques (et, dans le terminal, la conversation). N'exposez pas le port sur des réseaux
|
|
1162
|
+
auxquels vous ne faites pas confiance.
|
|
1163
|
+
|
|
1164
|
+
## Développement
|
|
1165
|
+
|
|
1166
|
+
| Commande | Ce qu'elle fait |
|
|
1167
|
+
| --- | --- |
|
|
1168
|
+
| `npm run dev` | Serveur + Vite sur http://localhost:4747, avec rechargement automatique. |
|
|
1169
|
+
| `npm run dev:client` | Vite seul, sur http://localhost:5173 (ouvrez avec `?mock=1` ; `/api` est redirigé vers le port 4747). |
|
|
1170
|
+
| `npm run demo` | `npm run dev` avec le mode démonstration activé. |
|
|
1171
|
+
| `npm run build` / `npm start` | Compile et lance la version de production. |
|
|
1172
|
+
| `npm test` | Tests (Vitest). |
|
|
1173
|
+
| `npm run typecheck` | Vérification des types du client, du serveur et des scripts. |
|
|
1174
|
+
| `claude plugin test mod/habblaud` | Tests du mod (sans session, compte ni réseau) ; idem pour `mod/habblaud-mensagens`. |
|
|
1175
|
+
| `claude plugin validate .` | Valide le marketplace (`.claude-plugin/marketplace.json`) ; avec `mod/habblaud`, `mod/habblaud-permissoes` ou `mod/habblaud-mensagens`, valide le plugin et liste les événements et les appels du mod. |
|
|
1176
|
+
| `claude --plugin-dir mod/habblaud` | Ouvre une session avec le mod de ce dossier, sans l'installer (modifiez-le puis lancez `/reload-plugins`). |
|
|
1177
|
+
| `npm run mod:status` | Affiche, par compte, le marketplace, les plugins et les versions installées. |
|
|
1178
|
+
| `npm run demo:timeline` | Génère une chronologie fictive (simulateur du mode démonstration) pour le timelapse. |
|
|
1179
|
+
| `npm run release` | Publie la version du `package.json` sur GitHub (tag et release avec les notes du `CHANGELOG.md`). |
|
|
1180
|
+
|
|
1181
|
+
Pour prendre des captures d'écran sans ouvrir votre navigateur, `scripts/shot.mjs` utilise un Chromium headless isolé
|
|
1182
|
+
(Playwright). La première fois, téléchargez le navigateur (une seule fois suffit) : `npx playwright-core install chromium-headless-shell`.
|
|
1183
|
+
|
|
1184
|
+
```bash
|
|
1185
|
+
node scripts/shot.mjs 'http://localhost:4747/?mock=1&speed=3' /tmp/habblaud.png --size 1400x900 --wait 4000
|
|
1186
|
+
```
|
|
1187
|
+
|
|
1188
|
+
Dans la console du navigateur, `habblaud.world.debug` propose des outils pour tester des scènes (ex. :
|
|
1189
|
+
`habblaud.world.debug.setHour(21)` pour voir la nuit). Pour fixer l'heure dès l'ouverture, utilisez `?hora=21:30` dans l'URL.
|
|
1190
|
+
|
|
1191
|
+
**Timelapse avec des données fictives uniquement** (ex. : pour enregistrer un GIF) : `npm run demo:timeline` lance le
|
|
1192
|
+
simulateur du mode démonstration hors ligne et enregistre une journée entière (par défaut, hier de 9 h à 19 h, avec une
|
|
1193
|
+
matinée chargée, un déjeuner plus calme et un pic l'après-midi) dans `<tmp>/habblaud-demo/timeline/`. Lancez ensuite un
|
|
1194
|
+
Busybits qui ne lit que ce dossier et n'affiche pas vos sessions, puis ouvrez le Timelapse :
|
|
1195
|
+
|
|
1196
|
+
```bash
|
|
1197
|
+
npm run demo:timeline -- --data-dir /tmp/habblaud-demo # opções: --date, --start 8:30, --hours, --sessions, --seed
|
|
1198
|
+
mkdir -p /tmp/habblaud-demo/vazio
|
|
1199
|
+
HABBLAUD_DATA_DIR=/tmp/habblaud-demo HABBLAUD_TIMELINE=0 HABBLAUD_CLAUDE_DIRS=/tmp/habblaud-demo/vazio \
|
|
1200
|
+
HABBLAUD_PORT=4848 npm start # depois de npm run build; abra http://localhost:4848
|
|
1201
|
+
```
|
|
1202
|
+
|
|
1203
|
+
`HABBLAUD_TIMELINE=0` évite d'écrire dans ce dossier ; avec l'enregistrement activé, les jours de plus de 7 jours sont supprimés.
|
|
1204
|
+
|
|
1205
|
+
**Publier une version :** chaque version a sa section dans [`CHANGELOG.md`](CHANGELOG.md), avec ce qu'elle apporte.
|
|
1206
|
+
Pendant le travail, notez les changements sous « Não lançado » (non publié). Pour publier :
|
|
1207
|
+
|
|
1208
|
+
1. Augmentez le numéro avec `npm version minor --no-git-tag-version` (ou `patch`, pour une version qui ne contient que des corrections).
|
|
1209
|
+
2. Remplacez « Não lançado » par la version et la date (`## [0.3.0] - AAAA-MM-DD`), laissez un « Não lançado » vide
|
|
1210
|
+
au-dessus et mettez à jour les liens de la fin. `npm test` échoue si la version du `package.json` n'a pas de section.
|
|
1211
|
+
3. Faites le merge dans `main` et lancez `npm run release` (nécessite [`gh`](https://cli.github.com/) authentifié ; `-- --dry-run`
|
|
1212
|
+
affiche seulement les notes). Le script crée le tag `v0.3.0` et la release avec le texte de la section. À partir de
|
|
1213
|
+
là, les utilisateurs de Busybits voient le badge **Nouvelle version**.
|
|
1214
|
+
|
|
1215
|
+
## Dépannage
|
|
1216
|
+
|
|
1217
|
+
<details>
|
|
1218
|
+
<summary><b>Le bureau est vide</b></summary>
|
|
1219
|
+
|
|
1220
|
+
Seules les sessions **ouvertes** de Claude Code apparaissent. Vérifiez qu'il y en a une en cours et que le compte a été
|
|
1221
|
+
détecté dans `http://localhost:4747/api/health`. Si les dossiers des comptes se trouvent ailleurs, utilisez
|
|
1222
|
+
`HABBLAUD_CLAUDE_DIRS=/caminho/conta1,/caminho/conta2`.
|
|
1223
|
+
|
|
1224
|
+
</details>
|
|
1225
|
+
|
|
1226
|
+
<details>
|
|
1227
|
+
<summary><b>L'utilisation s'affiche comme « pas de données » ou « pas à jour »</b></summary>
|
|
1228
|
+
|
|
1229
|
+
Lancez `npm run mod:install` (ou, avec Claude Code antérieur à 2.1.287, `npm run usage:install`) et vérifiez avec
|
|
1230
|
+
`npm run mod:status` (ou `npm run usage:status`). Les chiffres arrivent après la prochaine réponse dans une session ouverte
|
|
1231
|
+
de ce compte ; dans une session ouverte avant l'installation, lancez `/reload-plugins` ou rouvrez la session. Un **—** à
|
|
1232
|
+
la place du pourcentage signifie que la fenêtre s'est réinitialisée depuis la dernière collecte.
|
|
1233
|
+
|
|
1234
|
+
</details>
|
|
1235
|
+
|
|
1236
|
+
<details>
|
|
1237
|
+
<summary><b>Le mod ne se charge pas dans une session</b></summary>
|
|
1238
|
+
|
|
1239
|
+
Lancez `npm run mod:status` : il affiche la version de Claude Code (le mod nécessite la 2.1.287 ou plus récente) et, par
|
|
1240
|
+
compte, si le marketplace pointe vers ce dossier et si les plugins sont installés et activés. Dans une session ouverte
|
|
1241
|
+
avant l'installation, lancez `/reload-plugins` ; `/plugin` affiche, sous les onglets, les mods chargés (ex. :
|
|
1242
|
+
`1 mod active · habblaud`). Les mods ne tournent pas avec `"disableAllHooks": true` dans le `settings.json` du compte ni avec
|
|
1243
|
+
`claude --safe-mode`.
|
|
1244
|
+
|
|
1245
|
+
</details>
|
|
1246
|
+
|
|
1247
|
+
<details>
|
|
1248
|
+
<summary><b>« Le port 4747 est déjà utilisé »</b></summary>
|
|
1249
|
+
|
|
1250
|
+
Un autre Busybits (Node ou Docker) tourne déjà. Arrêtez-le (`npm run docker:down`, ou Ctrl+C dans le terminal de
|
|
1251
|
+
`npm start`) ou utilisez un autre port : `HABBLAUD_PORT=4848 npm run docker:up` (Docker) ou `HABBLAUD_PORT=4848 npm start`
|
|
1252
|
+
(Node).
|
|
1253
|
+
|
|
1254
|
+
</details>
|
|
1255
|
+
|
|
1256
|
+
<details>
|
|
1257
|
+
<summary><b>Ça ne s'ouvre pas sur le téléphone</b></summary>
|
|
1258
|
+
|
|
1259
|
+
Vérifiez que vous avez créé le `.env` avec `HABBLAUD_BIND=0.0.0.0` et recréé le conteneur (`npm run docker:up -- --no-build`), que
|
|
1260
|
+
le téléphone est sur le même Wi-Fi et que le pare-feu de l'ordinateur autorise les connexions sur le port 4747. Par IP,
|
|
1261
|
+
ça marche directement ; pour l'ouvrir par un nom (ex. : `meu-mac.local`), ajoutez `HABBLAUD_ALLOWED_HOSTS=meu-mac.local`
|
|
1262
|
+
(dans Docker, dans le même `.env`).
|
|
1263
|
+
|
|
1264
|
+
</details>
|
|
1265
|
+
|
|
1266
|
+
<details>
|
|
1267
|
+
<summary><b>Le terminal ne s'ouvre pas</b></summary>
|
|
1268
|
+
|
|
1269
|
+
Le terminal n'existe que si Busybits est accessible uniquement depuis l'ordinateur lui-même. Vérifiez que le `.env` ne
|
|
1270
|
+
contient pas `HABBLAUD_BIND=0.0.0.0` (ou, en mode Node, que vous n'avez pas utilisé `HABBLAUD_HOST=0.0.0.0`) ni
|
|
1271
|
+
`HABBLAUD_TERMINAL=0`, et ouvrez via `http://localhost:4747` (par l'IP du réseau ou par un nom de `HABBLAUD_ALLOWED_HOSTS`,
|
|
1272
|
+
il est refusé). Dans Docker, un conteneur créé avant l'arrivée de cette fonction doit être recréé : `npm run docker:up`.
|
|
1273
|
+
Le journal de démarrage (`npm run docker:logs`) indique si le terminal est activé et, s'il ne l'est pas, pourquoi.
|
|
1274
|
+
|
|
1275
|
+
</details>
|
|
1276
|
+
|
|
1277
|
+
<details>
|
|
1278
|
+
<summary><b>La demande de permission (ou la question) n'apparaît pas dans le bureau</b></summary>
|
|
1279
|
+
|
|
1280
|
+
Lancez `npm run mod:status` : il indique, par compte, si le plugin `busybits-permissions` est installé et activé (et s'il
|
|
1281
|
+
reste l'ancien hook à côté, ce qui ferait répondre deux mécanismes) et si Busybits traite les demandes. Avec l'ancienne
|
|
1282
|
+
méthode, `npm run hooks:status` indique si le hook est installé et pointe vers ce dossier. La demande n'est détournée
|
|
1283
|
+
qu'avec une page de Busybits ouverte via `http://localhost` (ou `127.0.0.1`) et avec le terminal activé (même verrou).
|
|
1284
|
+
Les sessions ouvertes avant l'installation chargent le plugin avec `/reload-plugins` (ou à leur réouverture). Avec
|
|
1285
|
+
l'ancienne méthode, si Busybits utilise un autre port, réinstallez avec `npm run hooks:install -- --port <porta>`. Pour
|
|
1286
|
+
les questions de l'agent, le plugin doit être celui de la 0.6.0 ou plus récent : lancez `npm run mod:install` après la
|
|
1287
|
+
mise à jour.
|
|
1288
|
+
|
|
1289
|
+
</details>
|
|
1290
|
+
|
|
1291
|
+
<details>
|
|
1292
|
+
<summary><b>Codex n'apparaît pas dans le bureau (ou apparaît avec du retard)</b></summary>
|
|
1293
|
+
|
|
1294
|
+
Le journal de démarrage (`npm run docker:logs`) indique combien de comptes Codex Busybits a trouvés ; s'il n'en a trouvé
|
|
1295
|
+
aucun, indiquez le dossier avec `HABBLAUD_CODEX_DIRS` (et relancez `npm run docker:up` : dans Docker, seuls les dossiers
|
|
1296
|
+
qui existaient au moment du `docker:up` sont montés). Sans les hooks, Codex apparaît via ses fichiers, qui ne sont écrits
|
|
1297
|
+
qu'après chaque étape : lancez `npm run codex:install`, **validez les hooks dans `/hooks` dans Codex** et vérifiez avec
|
|
1298
|
+
`npm run codex:status`. Codex lance les hooks via le shell de connexion, qui peut avoir un vieux Node ; `codex:install`
|
|
1299
|
+
choisit un Node 22+ et indique lequel (ou utilisez `--node <caminho>`). Une session de CLI tout juste ouverte n'apparaît
|
|
1300
|
+
qu'au **premier message** : avant cela, Codex n'indique pas dans quel dossier elle se trouve (il crée seulement le verrou
|
|
1301
|
+
de la session), et sans dossier, pas de salle.
|
|
1302
|
+
|
|
1303
|
+
</details>
|
|
1304
|
+
|
|
1305
|
+
<details>
|
|
1306
|
+
<summary><b>La zone de message n'apparaît pas (ou reste en file)</b></summary>
|
|
1307
|
+
|
|
1308
|
+
La zone n'apparaît que pour les agents principaux dont la session a le plugin `busybits-messages` connecté : lancez
|
|
1309
|
+
`npm run mod:status` (il indique, par compte, si le plugin est installé et si Busybits a les messages activés) et, dans
|
|
1310
|
+
les sessions ouvertes avant l'installation, `/reload-plugins`. Sans le plugin, les détails de l'agent affichent l'astuce
|
|
1311
|
+
d'installation. Les messages suivent le verrou du terminal et `HABBLAUD_MENSAGENS=0` les désactive ; le journal de
|
|
1312
|
+
démarrage (`npm run docker:logs`) indique s'ils sont activés et, sinon, pourquoi. Un message qui reste **en file** puis
|
|
1313
|
+
échoue avec « la session n'a pas récupéré le message » signifie que la session a cessé d'interroger Busybits (elle a été
|
|
1314
|
+
fermée, ou le plugin a été désactivé).
|
|
1315
|
+
|
|
1316
|
+
</details>
|
|
1317
|
+
|
|
1318
|
+
<details>
|
|
1319
|
+
<summary><b>Dans Docker, une session fermée reste dans le bureau</b></summary>
|
|
1320
|
+
|
|
1321
|
+
Cela arrive si Claude Code a été arrêté de force sans supprimer sa propre entrée dans `sessions/` (dans Docker, impossible
|
|
1322
|
+
de vérifier si le processus existe encore). En lançant avec Node (`npm start`), Busybits vérifie les processus et cela
|
|
1323
|
+
n'arrive pas.
|
|
1324
|
+
|
|
1325
|
+
</details>
|
|
1326
|
+
|
|
1327
|
+
<details>
|
|
1328
|
+
<summary><b>Dans Docker, un compte situé hors de /Users n'apparaît pas</b></summary>
|
|
1329
|
+
|
|
1330
|
+
Docker Desktop ne partage que certains dossiers du Mac avec les conteneurs (par défaut `/Users`, `/Volumes`, `/private` et
|
|
1331
|
+
`/tmp`). Ajoutez le dossier dans *Settings › Resources › File sharing*.
|
|
1332
|
+
|
|
1333
|
+
</details>
|
|
1334
|
+
|
|
1335
|
+
<details>
|
|
1336
|
+
<summary><b>Je veux repartir de zéro</b></summary>
|
|
1337
|
+
|
|
1338
|
+
`npm run docker:down`, puis `docker volume rm habblaud_habblaud-data` (supprime les noms enregistrés) et
|
|
1339
|
+
`npm run docker:up`.
|
|
1340
|
+
|
|
1341
|
+
</details>
|
|
1342
|
+
|
|
1343
|
+
## Avertissement
|
|
1344
|
+
|
|
1345
|
+
Busybits est un projet indépendant, **ni affilié à Anthropic, ni sponsorisé ou approuvé par elle**. « Claude » et
|
|
1346
|
+
« Claude Code » sont des marques d'Anthropic, utilisées ici uniquement pour décrire ce avec quoi le projet fonctionne.
|
|
1347
|
+
|
|
1348
|
+
Pour afficher les agents, Busybits lit uniquement des fichiers locaux que Claude Code écrit lui-même sur votre machine
|
|
1349
|
+
(registres des sessions ouvertes, transcripts et configurations des comptes). Ce format n'est pas documenté et peut changer d'une version de Claude Code à l'autre :
|
|
1350
|
+
après une mise à jour, Busybits peut cesser de fonctionner, totalement ou partiellement, jusqu'à ce qu'il soit adapté.
|
|
1351
|
+
|
|
1352
|
+
## Licence
|
|
1353
|
+
|
|
1354
|
+
[MIT](LICENSE). Les images de `client/public/assets` (logo, illustrations, tableaux et affiches) ont été générées par
|
|
1355
|
+
IA pour ce projet et converties en pixel art par les scripts de `scripts/assets/`.
|
|
1356
|
+
|
|
1357
|
+
## Vie sociale
|
|
1358
|
+
|
|
1359
|
+
Quand deux agents ou plus n'ont rien à faire — inactifs, ou en attente d'un shell depuis plus de 40 secondes —, ils
|
|
1360
|
+
arrêtent de se promener seuls et se retrouvent. Personne ne se concerte : chaque personnage a une **personnalité**, des
|
|
1361
|
+
**amis** et des **rivaux**, et c'est ce qui décide ce qu'il préfère faire, avec qui et ce qu'il dit. Celui qui attend un
|
|
1362
|
+
shell ne quitte son bureau que pour rejoindre un groupe (seul, il reste devant son pop-corn) et emporte son sablier ;
|
|
1363
|
+
quand la commande se termine — ou quand vous envoyez une nouvelle demande à quelqu'un —, il prévient la bande (« Oups,
|
|
1364
|
+
on m'appelle ! 🏃 ») et retourne en courant à son bureau.
|
|
1365
|
+
|
|
1366
|
+
<p align="center">
|
|
1367
|
+
<img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-lounge.gif" width="816" alt="Le salon de Busybits avec trois groupes en même temps : trois collègues sur le canapé regardent le foot à la télé (l'écran fait clignoter GOL), une partie de ping-pong avec des supporters et un duel sur les bornes d'arcade avec des provocations dans les bulles" />
|
|
1368
|
+
</p>
|
|
1369
|
+
|
|
1370
|
+
### Les activités de groupe
|
|
1371
|
+
|
|
1372
|
+
| | Activité | Ce qui se passe |
|
|
1373
|
+
| --- | --- | --- |
|
|
1374
|
+
| 📺 | **Télé au salon** | Foot, feuilleton ou dessin animé, avec du pop-corn sur le canapé. Pendant le foot, les supporters fêtent le « GOL » qui clignote à l'écran (ou se lamentent du but adverse) ; pendant le feuilleton, petits cœurs et « J'y crois pas ! 😱 ». Les amateurs de siestes finissent par s'endormir sur le canapé. |
|
|
1375
|
+
| 🎮 | **Jeux vidéo** | Deux sur le canapé, manette en main, la télé en écran partagé (course ou combat), en deux manches gagnantes, avec des provocations (« C'est quoi ce lag ?! ») et des supporters. |
|
|
1376
|
+
| 👾 | **Arcade** | Duel sur les deux bornes du salon, en une seule partie. |
|
|
1377
|
+
| 🏓 | **Ping-pong** | En 5 points, avec la balle qui va et vient, le score dans les bulles (« 3 × 2 🏓 ») et des supporters derrière la table. |
|
|
1378
|
+
| ☕ | **Pause à la cuisine** | Chacun prend un café (ou de l'eau) et s'assoit à table : potins avec le nom des collègues (« Vous avez vu le commit de Rafaela ? 👀 »), blagues (tout le groupe éclate de rire), boulot (« Déployer un vendredi ? 😈 ») et sujets liés au jour et à l'heure (« C'est vendredi ! 🎉 »). |
|
|
1379
|
+
| 💬 | **Discussion** | Deux collègues debout dans un coin de l'accueil, de la cuisine ou du salon. |
|
|
1380
|
+
| ✊ | **Chifoumi avec mise** | « Chi… fou… mi ! », les gestes apparaissent au-dessus des têtes, le gagnant fête ça et les pièces volent de l'un à l'autre ; le perdant fait la tête et, s'il a l'esprit de compétition, demande une revanche. En cas d'égalité, on rejoue. Ceux qui passent peuvent s'arrêter pour regarder. |
|
|
1381
|
+
| 💄 | **Miroir des toilettes** | Rouge à lèvres ou peigne, avec le visage reflété dans le miroir et un éclat à la fin. Seul ou à deux (« Tu me prêtes ton peigne ? »). |
|
|
1382
|
+
|
|
1383
|
+
<table>
|
|
1384
|
+
<tr>
|
|
1385
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-rps.png" alt="Chifoumi à l'accueil : Lia fête ça avec une pièce au-dessus de la tête et la bulle « Gagné ! », des pièces volent de Bruna (dépitée, avec l'icône de la pierre) vers elle, « +20 » et « −20 » flottent, et Iara regarde derrière" /></td>
|
|
1386
|
+
<td width="50%"><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-kitchen.png" alt="Pause à la cuisine : quatre collègues assis à la longue table avec du café, avec les bulles « Ça va marcher ! » et « Hahaha »" /></td>
|
|
1387
|
+
</tr>
|
|
1388
|
+
<tr>
|
|
1389
|
+
<td><b>Chifoumi avec des pièces en jeu.</b> La mise dépend de la personnalité (les amateurs de paris misent gros, les radins misent peu) et ne dépasse jamais le solde de celui qui en a le moins.</td>
|
|
1390
|
+
<td><b>Pause à la cuisine.</b> Ceux qui parlent le plus sont les plus sociables ; les réactions dépendent du sujet (fou rire pour une blague, 👀 pour un potin).</td>
|
|
1391
|
+
</tr>
|
|
1392
|
+
<tr>
|
|
1393
|
+
<td><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-mirror.png" alt="Deux collègues devant les lavabos des toilettes en train de se préparer, avec leurs visages reflétés dans les miroirs et la bulle « Tu assures ! »" /></td>
|
|
1394
|
+
<td><img src="https://raw.githubusercontent.com/Midnightgb/busybits-assets/main/docs/screenshots/social-drawer.png" alt="Section Vie sociale dans les détails de l'agent : « Regarde une série à la télé avec Bruna et Iara », 115 pièces, 1 victoire et 0 défaite, les traits Coquetterie et Économie, la réplique culte, les amitiés, les rivalités avec le score et le relevé" /></td>
|
|
1395
|
+
</tr>
|
|
1396
|
+
<tr>
|
|
1397
|
+
<td><b>Au miroir.</b> Les coquets passent aux toilettes dès qu'ils le peuvent — et apparaissent dans le reflet.</td>
|
|
1398
|
+
<td><b>Dans les détails de l'agent.</b> Ce qu'il fait, son porte-monnaie, son score, sa personnalité, ses amitiés et ses rivalités (avec le bilan) et son relevé.</td>
|
|
1399
|
+
</tr>
|
|
1400
|
+
</table>
|
|
1401
|
+
|
|
1402
|
+
### Personnalités
|
|
1403
|
+
|
|
1404
|
+
Chaque agent a 2 ou 3 traits, tirés au sort à partir de sa graine (c'est toujours la même personne, dans n'importe quel navigateur) :
|
|
1405
|
+
|
|
1406
|
+
🏆 Compétition · 🎲 Paris · 🎮 Jeux vidéo · 📺 Séries et télé · 🗣️ Commérages · 💄 Coquetterie · ☕ Caféine · 😂 Blagues · 🏓 Sport ·
|
|
1407
|
+
🙈 Timidité · 💰 Économie · 😴 Siestes · 🧘 Calme · 📚 Lecture
|
|
1408
|
+
|
|
1409
|
+
Les traits changent ce que chacun choisit (l'amateur de séries allume la télé, le sportif propose un ping-pong), qui il
|
|
1410
|
+
invite (les amis se cherchent ; les rivaux se défient aux jeux), ce qu'il dit et même qui joue le mieux. Chacun a aussi
|
|
1411
|
+
une réplique culte (« C'est fait ! », « Au code ! »). Survolez un trait dans les détails de l'agent pour voir son effet.
|
|
1412
|
+
|
|
1413
|
+
### Pièces
|
|
1414
|
+
|
|
1415
|
+
Des pièces fictives (🪙), juste pour pimenter les paris :
|
|
1416
|
+
|
|
1417
|
+
| | |
|
|
1418
|
+
| --- | --- |
|
|
1419
|
+
| **Arrivée au bureau** | 🪙100 (sous-agents, 🪙30) |
|
|
1420
|
+
| **Tâche terminée** (élément de la liste de tâches) | +🪙10 |
|
|
1421
|
+
| **Demande traitée** (fin de tour) | +🪙5 |
|
|
1422
|
+
| **Sous-agent qui a remis son résultat** | +🪙15 |
|
|
1423
|
+
| **Paris** (chifoumi ; parties entre rivaux ou avec un amateur de paris) | ce que l'un perd va au gagnant |
|
|
1424
|
+
|
|
1425
|
+
Chaque gain apparaît sous la forme « +🪙10 » au-dessus de la tête ; les parties et les paris entrent dans le fil
|
|
1426
|
+
d'activité. Le solde, le score et le relevé sont enregistrés dans le navigateur (chaque navigateur a sa propre économie :
|
|
1427
|
+
c'est là que les paris sont tirés au sort) et sont oubliés trois jours après le départ de l'agent.
|
|
1428
|
+
|
|
1429
|
+
> Tout cela n'est que de la mise en scène de Busybits : rien ne change pour les agents Claude Code, qui continuent de travailler normalement.
|
|
1430
|
+
|
|
1431
|
+
---
|
|
1432
|
+
|
|
1433
|
+
<p align="center">
|
|
1434
|
+
Fait avec ☕ et beaucoup d'agents <a href="https://code.claude.com">Claude Code</a>.
|
|
1435
|
+
</p>
|