busybits 0.0.0-stage → 2.0.0

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.
Files changed (111) hide show
  1. package/.claude-plugin/marketplace.json +26 -0
  2. package/CHANGELOG.md +675 -0
  3. package/LICENSE +21 -0
  4. package/README.es.md +1457 -0
  5. package/README.fr.md +1435 -0
  6. package/README.md +1605 -2
  7. package/README.pt-BR.md +1373 -0
  8. package/dist/build.json +5 -0
  9. package/dist/cli/busybits.js +14708 -0
  10. package/dist/client/assets/art/framed/painting-abstract.png +0 -0
  11. package/dist/client/assets/art/framed/painting-beach.png +0 -0
  12. package/dist/client/assets/art/framed/painting-cat.png +0 -0
  13. package/dist/client/assets/art/framed/painting-city-night.png +0 -0
  14. package/dist/client/assets/art/framed/painting-mountains.png +0 -0
  15. package/dist/client/assets/art/framed/painting-rio.png +0 -0
  16. package/dist/client/assets/art/framed/painting-sunflowers.png +0 -0
  17. package/dist/client/assets/art/framed/painting-wave.png +0 -0
  18. package/dist/client/assets/art/framed/painting-wide-aurora.png +0 -0
  19. package/dist/client/assets/art/framed/painting-wide-color-fields.png +0 -0
  20. package/dist/client/assets/art/framed/painting-wide-forest-lake.png +0 -0
  21. package/dist/client/assets/art/painting-abstract.png +0 -0
  22. package/dist/client/assets/art/painting-beach.png +0 -0
  23. package/dist/client/assets/art/painting-cat.png +0 -0
  24. package/dist/client/assets/art/painting-city-night.png +0 -0
  25. package/dist/client/assets/art/painting-mountains.png +0 -0
  26. package/dist/client/assets/art/painting-rio.png +0 -0
  27. package/dist/client/assets/art/painting-sunflowers.png +0 -0
  28. package/dist/client/assets/art/painting-wave.png +0 -0
  29. package/dist/client/assets/art/painting-wide-aurora.png +0 -0
  30. package/dist/client/assets/art/painting-wide-color-fields.png +0 -0
  31. package/dist/client/assets/art/painting-wide-forest-lake.png +0 -0
  32. package/dist/client/assets/art/poster-bug.png +0 -0
  33. package/dist/client/assets/art/poster-cat.png +0 -0
  34. package/dist/client/assets/art/poster-code.png +0 -0
  35. package/dist/client/assets/art/poster-coffee.png +0 -0
  36. package/dist/client/assets/art/poster-rocket.png +0 -0
  37. package/dist/client/assets/art/poster-ship-it.png +0 -0
  38. package/dist/client/assets/brand/apple-touch-icon.png +0 -0
  39. package/dist/client/assets/brand/favicon-16.png +0 -0
  40. package/dist/client/assets/brand/favicon-32.png +0 -0
  41. package/dist/client/assets/brand/icon-192.png +0 -0
  42. package/dist/client/assets/brand/icon-512.png +0 -0
  43. package/dist/client/assets/brand/logo-detailed.png +0 -0
  44. package/dist/client/assets/brand/logo-mark.png +0 -0
  45. package/dist/client/assets/brand/logo-mark@4x.png +0 -0
  46. package/dist/client/assets/brand/signage.png +0 -0
  47. package/dist/client/assets/brand/signage@4x.png +0 -0
  48. package/dist/client/assets/emoji/LICENSE-SerenityOS.txt +28 -0
  49. package/dist/client/assets/emoji/sheet.png +0 -0
  50. package/dist/client/assets/illustrations/empty-office.png +0 -0
  51. package/dist/client/assets/manifest.json +260 -0
  52. package/dist/client/assets/og-image.png +0 -0
  53. package/dist/client/bundle/app-AwZeKIeu.js +24 -0
  54. package/dist/client/bundle/app-CoDOLwxe.css +1 -0
  55. package/dist/client/bundle/city-DPTwQLdi.css +1 -0
  56. package/dist/client/bundle/city-YoIG0FsX.js +1 -0
  57. package/dist/client/bundle/daystats-DGzYOP8l.js +1 -0
  58. package/dist/client/bundle/dom-D2vx0KTo.js +1 -0
  59. package/dist/client/bundle/en-DBfNt5uV.js +169 -0
  60. package/dist/client/bundle/es-pnWdszTE.js +169 -0
  61. package/dist/client/bundle/format-C7qb6Cn-.js +1 -0
  62. package/dist/client/bundle/fr-CY8q9pj4.js +169 -0
  63. package/dist/client/bundle/main-DktU0GfB.js +2 -0
  64. package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-Ckz2YJkH.woff2 +0 -0
  65. package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-DfOZNMlW.woff +0 -0
  66. package/dist/client/bundle/pixelify-sans-cyrillic-500-normal--wrb4dVK.woff2 +0 -0
  67. package/dist/client/bundle/pixelify-sans-cyrillic-500-normal-CR9SIKMr.woff +0 -0
  68. package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-B3EuUOZG.woff +0 -0
  69. package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-BhqNJYOZ.woff2 +0 -0
  70. package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-BrZTw8tu.woff +0 -0
  71. package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-CYtG5Rfp.woff2 +0 -0
  72. package/dist/client/bundle/pixelify-sans-latin-400-normal-DLrIX9QE.woff2 +0 -0
  73. package/dist/client/bundle/pixelify-sans-latin-400-normal-JapMNN6Z.woff +0 -0
  74. package/dist/client/bundle/pixelify-sans-latin-500-normal-Bq6pAlou.woff +0 -0
  75. package/dist/client/bundle/pixelify-sans-latin-500-normal-DC052d-m.woff2 +0 -0
  76. package/dist/client/bundle/pixelify-sans-latin-600-normal-BNlgYbDL.woff +0 -0
  77. package/dist/client/bundle/pixelify-sans-latin-600-normal-Dd_Dy7u5.woff2 +0 -0
  78. package/dist/client/bundle/pixelify-sans-latin-700-normal-BctWAS0u.woff +0 -0
  79. package/dist/client/bundle/pixelify-sans-latin-700-normal-D3Xxx3QE.woff2 +0 -0
  80. package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-BkfTUL4s.woff +0 -0
  81. package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-DdH6zlBQ.woff2 +0 -0
  82. package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-BHT4w5qI.woff2 +0 -0
  83. package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-Bkr-oq6R.woff +0 -0
  84. package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-CDaIumwU.woff +0 -0
  85. package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-Dha6RiOG.woff2 +0 -0
  86. package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-BadXkHzZ.woff +0 -0
  87. package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-ClyJstAh.woff2 +0 -0
  88. package/dist/client/bundle/ptypane-BrP-ENHg.css +1 -0
  89. package/dist/client/bundle/ptypane-NIZ2Y8QM.js +16 -0
  90. package/dist/client/bundle/room-name-CFJfHE5L.js +1 -0
  91. package/dist/client/bundle/simulator-BnBPS_Ws.js +7 -0
  92. package/dist/client/bundle/world-model-BIYmgAWC.js +1 -0
  93. package/dist/client/bundle/world-stream-BRkL9Eme.js +1 -0
  94. package/dist/client/index.html +41 -0
  95. package/dist/client/manifest.webmanifest +17 -0
  96. package/dist/server/index.js +40327 -0
  97. package/mod/README.md +193 -0
  98. package/mod/habblaud/.claude-plugin/plugin.json +11 -0
  99. package/mod/habblaud/hooks/hooks.json +4 -0
  100. package/mod/habblaud/hooks/register.ts +517 -0
  101. package/mod/habblaud-codex/hook.mjs +274 -0
  102. package/mod/habblaud-mensagens/.claude-plugin/plugin.json +11 -0
  103. package/mod/habblaud-mensagens/hooks/hooks.json +4 -0
  104. package/mod/habblaud-mensagens/hooks/register.ts +384 -0
  105. package/mod/habblaud-permissoes/.claude-plugin/plugin.json +11 -0
  106. package/mod/habblaud-permissoes/hooks/hooks.json +18 -0
  107. package/mod/habblaud-permissoes/hooks/permission-hook.mjs +265 -0
  108. package/mod/habblaud-pi/core.ts +325 -0
  109. package/mod/habblaud-pi/extension.ts +119 -0
  110. package/mod/habblaud-pi/package.json +12 -0
  111. package/package.json +96 -4
@@ -0,0 +1,1373 @@
1
+ <p align="center">
2
+ <img src="client/public/assets/brand/logo-mark@4x.png" width="96" alt="Logo do Busybits: um ladrilho de pequenos blocos em pixel art" />
3
+ </p>
4
+
5
+ <h1 align="center">Busybits</h1>
6
+
7
+ <p align="center">
8
+ <b>O escritório virtual dos seus agentes do Claude Code (e do Codex).</b><br />
9
+ Cada projeto vira uma sala, cada agente vira um personagem em pixel art que mostra, em tempo real, o que está fazendo.
10
+ </p>
11
+
12
+ <p align="center"><a href="README.md">English</a> · <b>Português</b> · <a href="README.es.md">Español</a> · <a href="README.fr.md">Français</a></p>
13
+
14
+ <p align="center"><sub>Baseado no <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-pronto-2496ed?logo=docker&logoColor=white" />
20
+ <img alt="Zero dependências de runtime" src="https://img.shields.io/badge/depend%C3%AAncias%20de%20runtime-0-f08a3c" />
21
+ <img alt="Interface em português, inglês, espanhol e francês" 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="docs/screenshots/office.gif" width="820" alt="Animação de uma sala do Busybits: personagens digitando nas mesas, subagentes com crachá e balões de atividade" />
26
+ </p>
27
+
28
+ ---
29
+
30
+ Você abre o Claude Code em vários projetos, dispara subagentes, deixa tarefas rodando… e perde a noção de quem está
31
+ fazendo o quê. O **Busybits** transforma isso num escritório que dá para entender de relance: quem está digitando,
32
+ quem levantou a mão porque **precisa de você**, quem entregou o trabalho e foi embora, quem foi tomar um café
33
+ enquanto espera a próxima instrução — e quanto de cada conta você já gastou na sessão de 5 horas e na semana.
34
+
35
+ E quando dois ou mais agentes estão à toa, o escritório ganha **vida social**: cada um tem personalidade própria, e
36
+ eles veem futebol juntos no lounge, jogam videogame e ping-pong, fofocam na copa, se arrumam no espelho e apostam
37
+ moedinhas no jokenpô. Veja em [Vida social](#vida-social).
38
+
39
+ Tudo roda na sua máquina, lendo os arquivos que o próprio Claude Code já grava (e só as linhas `alias` do seu shell,
40
+ para dar a letra de cada conta). Nada sai do computador: o Busybits não lê credenciais nem faz chamadas externas.
41
+
42
+ ## Sumário
43
+
44
+ - [Como é](#como-é)
45
+ - [Instalação](#instalação)
46
+ - [Como usar](#como-usar)
47
+ - [Contas e uso (5 horas e semanal)](#contas-e-uso-5-horas-e-semanal)
48
+ - [Configuração](#configuração)
49
+ - [Habblaud World](#habblaud-world)
50
+ - [Como funciona](#como-funciona)
51
+ - [Privacidade e segurança](#privacidade-e-segurança)
52
+ - [Desenvolvimento](#desenvolvimento)
53
+ - [Solução de problemas](#solução-de-problemas)
54
+ - [Aviso](#aviso)
55
+ - [Licença](#licença)
56
+ - [Vida social](#vida-social)
57
+
58
+ ## Como é
59
+
60
+ **Visão geral.** O prédio tem recepção com elevadores, copa, banheiros e lounge; cada projeto com uma sessão aberta
61
+ ganha a sua sala ao longo do corredor. No topo, os contadores e o uso de cada conta; à esquerda, as salas e os
62
+ agentes; embaixo, o feed de atividade.
63
+
64
+ ![Visão geral do Busybits: prédio com recepção, copa, banheiros, lounge e salas de projeto; barra lateral com salas e agentes; uso das contas no topo; feed de atividade embaixo](docs/screenshots/overview.png)
65
+
66
+ <table>
67
+ <tr>
68
+ <td width="50%"><img src="docs/screenshots/agent-details.png" alt="Gaveta de detalhes de um agente com tarefas, subagentes, linha do tempo e estatísticas" /></td>
69
+ <td width="50%"><img src="docs/screenshots/night.png" alt="O escritório à noite, com postes acesos e salas iluminadas" /></td>
70
+ </tr>
71
+ <tr>
72
+ <td><b>Detalhes do agente:</b> atividade atual, tarefas com progresso, subagentes, linha do tempo e estatísticas.</td>
73
+ <td><b>Dia e noite:</b> o céu nas janelas e a iluminação seguem a hora local.</td>
74
+ </tr>
75
+ </table>
76
+
77
+ <table>
78
+ <tr>
79
+ <td width="42%"><img src="docs/screenshots/collab.png" alt="Subagente entregando o resultado ao agente principal enquanto outra agente pede permissão" /></td>
80
+ <td width="58%">
81
+ <b>Colaboração à vista.</b> Subagentes são colegas com nome próprio e crachá: chegam pelo elevador, trabalham na
82
+ sala do projeto e, ao terminar, vão até o agente que os chamou entregar o resultado (📦) antes de ir embora.<br /><br />
83
+ <b>Precisa de você.</b> Quando um agente espera uma permissão ou resposta no terminal, ele corre para a mesa e
84
+ levanta a mão, com um alerta piscando — e um aviso aparece na tela (opcionalmente com som e notificação do navegador).
85
+ Dá para aprovar, responder a pergunta ou mandar a próxima instrução dali mesmo.
86
+ </td>
87
+ </tr>
88
+ </table>
89
+
90
+ <table>
91
+ <tr>
92
+ <td width="58%">
93
+ <b>Esperando o shell.</b> Quando o agente termina o turno mas deixa um comando rodando (testes, build,
94
+ deploy…), ele não sai para passear: fica na mesa com uma ampulheta virando sobre a cabeça, o terminal mostrando
95
+ o progresso e um balão com o comando e o tempo. E a espera vira comédia: primeiro ele come pipoca assistindo ao
96
+ terminal; depois de 3 min cruza os braços e gira na cadeira; depois de 10 min junta teia de aranha; depois de
97
+ 25 min cochila. Quando o comando termina, levanta e comemora com confete — ou ganha uma nuvem de chuva, se
98
+ falhou. Na lista lateral e nos detalhes, um cronômetro mostra há quanto tempo cada comando está rodando.
99
+ </td>
100
+ <td width="42%"><img src="docs/screenshots/shell-wait.png" alt="Agente comendo pipoca na mesa, com uma ampulheta sobre a cabeça e o balão 'Rodar a suíte de testes · 1 min'; na fileira da frente, uma colega espera há mais tempo, com teia de aranha na cadeira e o terminal mostrando o progresso" /></td>
101
+ </tr>
102
+ </table>
103
+
104
+ **A luz apaga.** Quando você fecha a última sessão de um projeto, o último personagem vai até o interruptor,
105
+ apaga a luz, sai pelo elevador — e a sala é desmontada, virando jardim até um novo projeto chegar. Se o jardim
106
+ ficou entre duas salas, a sala mais distante se muda para lá: é montada no lugar vago, o pessoal vai andando até
107
+ ela, e o endereço antigo apaga e é desmontado. Assim o prédio não fica com buracos e encolhe sozinho.
108
+
109
+ | 1. A sala é montada, ainda apagada | 2. Alguém acende a luz e todos trabalham | 3. O último sai e apaga a luz | 4. A sala vira jardim |
110
+ | --- | --- | --- | --- |
111
+ | ![Sala sendo montada, com os móveis aparecendo e a luz apagada](docs/screenshots/lifecycle-1.png) | ![Sala acesa com três agentes trabalhando nas mesas](docs/screenshots/lifecycle-2.png) | ![Sala com a luz apagada e os móveis ainda no lugar, depois que todos saíram](docs/screenshots/lifecycle-3.png) | ![O lote da sala transformado em jardim](docs/screenshots/lifecycle-4.png) |
112
+
113
+ <table>
114
+ <tr>
115
+ <td width="34%"><img src="docs/screenshots/mobile.png" alt="Busybits no celular, com o uso das contas no topo" /></td>
116
+ <td>
117
+ <b>Também no celular.</b> A interface se adapta a telas pequenas: o uso das contas fica no topo, a lista de
118
+ salas vira uma gaveta e os detalhes abrem de baixo para cima. Veja como liberar o acesso pela rede local em
119
+ <a href="#abrir-no-celular-opcional">Abrir no celular</a>.
120
+ </td>
121
+ </tr>
122
+ </table>
123
+
124
+ > As imagens acima usam o **modo demonstração** (projetos, pessoas e contas fictícios).
125
+
126
+ ## Instalação
127
+
128
+ ### Instalar (npm)
129
+
130
+ Precisa do **Node.js 22.12+** e do npm. Sem clonar e sem compilar:
131
+
132
+ ```bash
133
+ npx busybits setup --service
134
+ # ou, para deixar o comando instalado:
135
+ npm i -g busybits && busybits setup --service
136
+ ```
137
+
138
+ O `busybits setup` instala a versão empacotada em `~/.busybits`, instala o mod do Claude Code, a extensão do Pi e os
139
+ hooks do Codex (cada um só se a ferramenta existir) e, com `--service`, um serviço de usuário sempre ligado
140
+ (`busybits.service` no Linux, `com.busybits.server` no macOS). Depois abra **http://localhost:4747**. Opções do setup:
141
+ `--service`, `--port <n>`, `--no-claude`, `--no-pi`, `--no-codex`, `--dry-run`, `--ignore-node`.
142
+
143
+ | Comando | O que faz |
144
+ | --- | --- |
145
+ | `busybits status` | mostra a instalação e o estado do serviço |
146
+ | `busybits start` | roda o servidor em primeiro plano |
147
+ | `busybits update` | atualiza para a versão mais recente (veja [Atualizar](#atualizar)) |
148
+ | `busybits update --rollback` | volta para a versão anterior |
149
+ | `busybits uninstall` | remove extensões e serviços (`--purge` apaga também os dados) |
150
+ | `busybits pair` | emparelha esta máquina como satélite de um Busybits central |
151
+
152
+ **Onde fica cada coisa**
153
+
154
+ - `~/.busybits` (`BUSYBITS_HOME` muda isso): as versões instaladas, os shims do comando e o marketplace.
155
+ - Os dados continuam em `~/.habblaud` e o arquivo de ambiente em `~/.config/habblaud/env`, como antes; uma instalação
156
+ a partir de um clone é assumida no lugar e mantém o pareamento e o estado do TLS.
157
+ - `habblaud.service` / `com.habblaud.server` viram `busybits.service` / `com.busybits.server` (o setup remove os antigos).
158
+
159
+ **Bom saber**
160
+
161
+ - **Codex:** depois da primeira tomada de controle, aprove de novo os hooks do Busybits em `/hooks` do Codex.
162
+ - **Linux:** o `node-pty` (tomada de controle do terminal) só compila com ferramentas de build (uma toolchain C/C++ e Python, para o node-gyp);
163
+ sem elas a instalação funciona e a tomada de controle fica desligada.
164
+ - **Node e o serviço:** o serviço empacotado inicia por um shim que procura o Node a cada início, então trocar de versão
165
+ do Node é seguro. Um serviço instalado **a partir de um clone** fixa o Node que rodou o `npm run setup`; rode o setup
166
+ de novo depois de trocar o Node.
167
+ - **Windows:** `busybits setup`, `update` e `uninstall` recusam e apontam para `scripts/windows/install-satellite.ps1`
168
+ (a partir de um clone).
169
+
170
+ A partir de um clone (desenvolvimento), veja os passos abaixo.
171
+
172
+ ### Requisitos
173
+
174
+ - **macOS** (testado) ou Linux.
175
+ - **[Claude Code](https://code.claude.com)** instalado, com uma ou mais contas (2.1.287 ou mais novo para o mod).
176
+ - **Node.js 22.12+** e **npm** (desenvolvido com o Node 24; o Docker já usa o Node 24).
177
+ - **Docker Desktop** (ou Docker Engine com Compose v2), se for rodar em container.
178
+
179
+ ### 1. Baixe o projeto
180
+
181
+ ```bash
182
+ git clone https://github.com/marmottajr/habblaud.git
183
+ cd habblaud
184
+ npm install
185
+ ```
186
+
187
+ > O `npm install` só baixa ferramentas de compilação (Vite, TypeScript, tsx…). O servidor do Busybits não tem
188
+ > dependências de runtime: usa só módulos nativos do Node.
189
+
190
+ ### 2. Suba o Busybits
191
+
192
+ **Opção A — Docker (recomendado para deixar sempre ligado)**
193
+
194
+ ```bash
195
+ npm run docker:up
196
+ ```
197
+
198
+ O script detecta as suas contas do Claude Code, monta só as pastas necessárias (em modo somente leitura), constrói
199
+ a imagem e sobe o container — que reinicia sozinho junto com o Docker. Abra **http://localhost:4747**.
200
+
201
+ **Opção B — Node, sem Docker**
202
+
203
+ ```bash
204
+ npm run build
205
+ npm start
206
+ ```
207
+
208
+ Abra **http://localhost:4747**. Para desenvolver, use `npm run dev` (servidor + Vite com recarga automática).
209
+
210
+ Agora abra o Claude Code em qualquer projeto e veja o seu agente chegar pelo elevador. 🎉
211
+
212
+ ### 3. Instale o mod do Busybits no Claude Code (recomendado)
213
+
214
+ ```bash
215
+ npm run mod:install # o mod e os plugins de permissões e de mensagens, em cada conta
216
+ npm run mod:install -- --sem-permissoes # sem responder permissões e perguntas pelo escritório
217
+ npm run mod:install -- --sem-mensagens # sem mandar mensagens aos agentes pelo escritório
218
+ ```
219
+
220
+ O Busybits traz um [mod](https://code.claude.com/docs/en/plugins/mods/overview) (um plugin que roda dentro do
221
+ Claude Code) e o instala em cada conta, pelo próprio `claude plugin`, a partir desta pasta. Com ele:
222
+
223
+ - o **uso de 5 horas e semanal** de cada conta aparece ao vivo no Busybits;
224
+ - o terminal mostra uma linha quando **outra sessão precisa de você** (permissão ou resposta);
225
+ - o comando **`/busybits`** passa a existir no Claude Code;
226
+ - dá para **aprovar ou recusar pelo escritório** os pedidos de permissão ("Do you want to…") e **responder as
227
+ perguntas** do agente, com o plugin `busybits-permissions` (veja [Responder pelo escritório](#responder-pelo-escritório));
228
+ - dá para **mandar mensagens** ao agente pelo escritório, como se você digitasse no terminal dele, com o plugin
229
+ `busybits-messages` (veja [Mandar mensagens](#mandar-mensagens)).
230
+
231
+ Precisa do **Claude Code 2.1.287 ou mais novo** (`claude --version`). O mod roda dentro de cada sessão, com as suas
232
+ permissões, e acessa só o que está listado em [`mod/README.md`](mod/README.md); para conferir sem rodar nada,
233
+ `claude plugin validate mod/habblaud` mostra os eventos que ele trata e as chamadas que faz. Sessões já abertas
234
+ carregam o mod com `/reload-plugins` (ou ao reabrir). Se a conta tinha o jeito antigo (abaixo), o `mod:install` tira o
235
+ tap e o hook do `settings.json` (com backup), porque o mod faz o mesmo. Confira com `npm run mod:status`; para
236
+ desfazer: `npm run mod:uninstall`.
237
+
238
+ > O mod é lido desta pasta. Se mover a pasta, rode `npm run mod:install` de novo.
239
+
240
+ <details>
241
+ <summary><b>Claude Code anterior ao 2.1.287: o jeito antigo</b></summary>
242
+
243
+ Sem mods, o uso ao vivo e o responder pelo escritório vêm de dois instaladores que editam o `settings.json` de cada
244
+ conta (com backup antes):
245
+
246
+ ```bash
247
+ npm run usage:install # põe um "tap" na frente do statusline de cada conta, que captura o uso de 5h/semanal
248
+ npm run hooks:install # acrescenta o hook PermissionRequest, para responder permissões pelo escritório
249
+ ```
250
+
251
+ O seu statusline continua aparecendo igual. Para desfazer: `npm run usage:uninstall` e `npm run hooks:uninstall`.
252
+ Os dois apontam para esta pasta: se mover a pasta, rode-os de novo (até lá, o statusline das contas mostra erro).
253
+ Quando atualizar o Claude Code, troque pelo mod: o `npm run mod:install` tira o tap e o hook antigos (com backup) para
254
+ não ficarem dois capturando o uso ou respondendo o mesmo pedido.
255
+
256
+ </details>
257
+
258
+ ### 4. Codex no escritório (opcional)
259
+
260
+ Se você também usa o **Codex** da OpenAI (a CLI `codex` ou o app), as sessões dele entram no mesmo escritório: cada
261
+ projeto é uma sala — a mesma sala do Claude Code, quando os dois estão abertos no mesmo projeto — e cada sessão, um
262
+ personagem com o selo **CODEX**. O Busybits acha sozinho a pasta do Codex (`~/.codex`, `CODEX_HOME` ou `~/.codex*`) e
263
+ lê as conversas, sem instalar nada. Para ver o Codex **ao vivo** (o que está fazendo agora, quem precisa de você) e
264
+ aprovar comandos pelo escritório, instale os hooks:
265
+
266
+ ```bash
267
+ npm run codex:install # acrescenta os hooks do Busybits em ~/.codex/hooks.json (backup antes; os outros ficam)
268
+ npm run codex:status # confere
269
+ ```
270
+
271
+ Depois, **abra o Codex e aprove os hooks do Busybits em `/hooks`**: o Codex só roda um hook novo depois que você o
272
+ aprova (o Busybits nunca grava essa aprovação). Com o Busybits no Docker, para mandar mensagens às sessões do Codex
273
+ deixe também `npm run codex:bridge` rodando no Mac (veja [Codex](#codex)).
274
+
275
+ ### Abrir no celular (opcional)
276
+
277
+ Por padrão o Busybits só aceita conexões do próprio computador. Para abrir no celular (no mesmo Wi-Fi), com Docker:
278
+
279
+ ```bash
280
+ printf 'HABBLAUD_BIND=0.0.0.0\n' > .env
281
+ npm run docker:up -- --no-build
282
+ ```
283
+
284
+ Depois abra `http://<ip-do-computador>:4747` no celular (no macOS: `ipconfig getifaddr en0`; se vier vazio,
285
+ `ipconfig getifaddr en1`). No modo Node, use `HABBLAUD_HOST=0.0.0.0 npm start`.
286
+
287
+ > ⚠️ Com isso, qualquer aparelho da rede vê a atividade dos agentes (comandos, arquivos, títulos das sessões). Use
288
+ > só em redes de confiança. O [terminal](#terminal) (e com ele responder e mandar mensagens pelo escritório) fica
289
+ > desligado enquanto a porta estiver exposta. Para voltar: apague o `.env` e rode `npm run docker:up -- --no-build`.
290
+
291
+ #### Celular com login e HTTPS (aprovando pedidos)
292
+
293
+ Em vez de expor a porta principal, abra uma **segunda porta com usuário, senha e HTTPS**. A 4747 continua só no
294
+ computador (hooks, plugins e o seu navegador seguem sem login); a porta remota vai para a rede e toda requisição nela
295
+ exige login. Quem separa as duas é a porta em que a conexão chegou, nunca o cabeçalho Host. Nada disso existe antes do
296
+ setup: sem ele, nenhuma porta a mais é publicada.
297
+
298
+ ```bash
299
+ npm run remote:setup # usuário, senha, nome do endereço e (opcional) um endereço próprio
300
+ npm run docker:up
301
+ ```
302
+
303
+ O `remote:setup` grava no `.env` só o **hash** da senha (scrypt), cria uma CA local e o certificado do servidor em
304
+ `~/.habblaud/remote-tls` e deixa um serviço anunciando `<nome>.local` na rede (mDNS; LaunchAgent no macOS, systemd no
305
+ Linux). Abra `https://<nome>.local` no celular (com `:4748` se a porta 443 estava ocupada). Na primeira vez, aceite o
306
+ aviso, toque em **Instale o certificado do Busybits** e confie nele (iPhone: Ajustes › Perfil Baixado › Instalar e
307
+ depois Ajustes › Geral › Sobre › Ajustes de Confiança de Certificados; Android: Segurança › Criptografia e
308
+ credenciais › Instalar certificado › Certificado de CA), conferindo a impressão digital que o setup mostrou.
309
+
310
+ - **CA restrita:** ela só assina `localhost`, nomes `.local`, o endereço próprio e IPs de rede privada. Mesmo que a
311
+ chave vaze, um certificado para qualquer outro site é recusado pelo celular que confia nela. Trocar o endereço
312
+ próprio cria uma CA nova (instale o certificado de novo no celular). A chave da CA nunca vai para o container.
313
+ - **Endereço próprio** (ex.: `meuclaude.home`): entra no certificado, mas o celular só o encontra com uma entrada no
314
+ DNS do roteador apontando para o IP do computador. O `<nome>.local` funciona sem configurar nada.
315
+ - **O que o celular pode fazer:** por padrão, aprovar e recusar pedidos de permissão. `HABBLAUD_REMOTE_ALLOW` no
316
+ `.env` aceita `permissions`, `messages`, `terminal` e `spawn`, separados por vírgula, ou `none` (só ver). O
317
+ terminal interativo nunca funciona pelo celular.
318
+ - **Entregas** (celular, com `terminal` liberado): o botão da caixinha no topo lista o que cada agente terminou, com
319
+ resumo e anexos (prints, PDFs, arquivos que ele mandou) que abrem com um toque.
320
+ - **Novo agente** (botão **+**): começa uma sessão do Claude Code em segundo plano no computador (`claude --bg`, na
321
+ pasta escolhida), que aparece no escritório e recebe mensagens e pedidos de permissão pelo Busybits. Numa pasta que
322
+ o Claude Code ainda não conhece, abre a tela de sessão nova do app do Claude preenchida, e você aperta Enter lá.
323
+ **Vem desligado:** precisa de `HABBLAUD_PTY=1` (a mesma liberação do
324
+ [terminal interativo](#terminal-interativo-assumir-nova-sessão-e-encerrar); no Docker, ponha no `.env` e deixe o
325
+ `npm run codex:bridge` rodando no computador) e, pelo celular, também de `spawn` no `HABBLAUD_REMOTE_ALLOW`.
326
+ - **Novo agente no herdr:** a janela oferece os provedores instalados no computador (Claude Code, Gentle Shell e
327
+ Codex) e onde abrir a sessão: em segundo plano (só Claude Code, como acima), numa aba nova do herdr num workspace à
328
+ sua escolha, ou numa divisão à direita ou abaixo de um painel existente do herdr. A divisão sempre cria um painel
329
+ novo e nunca mexe no escolhido; a pasta escolhida na janela vale mais que a do painel. Precisa do herdr aberto no
330
+ computador, do Habblaud fora do Docker e da sessão `default` do herdr; sem isso essas opções aparecem desligadas,
331
+ com uma dica. **Assumir daqui** numa sessão aberta lá foca o painel dela no herdr. Se o herdr traz essas sessões
332
+ de volta depois de reiniciar **ainda não foi verificado** para nenhum dos três provedores (veja
333
+ [`docs/herdr-resume-verification.md`](docs/herdr-resume-verification.md)). No Gentle Shell, o herdr só registra a
334
+ sessão pela integração pi: `herdr integration install pi` é o jeito de ligar a retomada, também sem verificação.
335
+ Com o herdr aberto e nada escolhido antes, a janela já marca uma aba nova do herdr, também para o Claude Code, para
336
+ que as sessões novas fiquem onde o herdr pode trazê-las de volta; o último provedor e destino usados são lembrados.
337
+ - **Ditado** (no Novo agente e na caixa de mensagem): precisa de `whisper-cli` e `ffmpeg` (`brew install whisper-cpp
338
+ ffmpeg`) e de um modelo multilíngue em `~/.local/share/whisper/` (`ggml-small.bin` acerta mais que o
339
+ `ggml-base.bin`; os `.en` só entendem inglês). Sem eles o botão Ditar não aparece. A voz não sai do computador.
340
+ `HABBLAUD_WHISPER_BIN`, `HABBLAUD_FFMPEG_BIN`, `HABBLAUD_WHISPER_MODEL` e `HABBLAUD_DICTATION_LANGS` (padrão
341
+ `pt,en`) ajustam.
342
+ - **Fora de casa (Tailscale):** com o Tailscale no computador e no celular, `tailscale serve --bg --https=443
343
+ https+insecure://127.0.0.1:443` publica a porta remota (com login) só para os seus aparelhos, com certificado válido
344
+ em `https://<computador>.<tailnet>.ts.net`; ponha esse nome em `HABBLAUD_ALLOWED_HOSTS`. Aponte sempre para a porta
345
+ remota, nunca para a 4747 (que não pede login).
346
+ - **Sessão:** 30 dias; trocar a senha (rodar o setup de novo) derruba todas, e **Configurações › Acesso pelo celular ›
347
+ Sair** encerra a daquele aparelho. Depois de 5 senhas erradas seguidas, cada nova tentativa espera de 1 s até 5 min.
348
+ - **IP mudou?** O `docker:up` refaz o certificado do servidor quando falta o IP novo ou quando faltam 30 dias para
349
+ vencer, com a mesma CA (o celular segue confiando); o servidor troca o certificado sem reiniciar.
350
+ - **Desligar:** `npm run remote:setup -- --off` e `npm run docker:up`.
351
+
352
+ Sem HTTPS a porta remota não sobe; `HABBLAUD_REMOTE_INSECURE_HTTP=1` força HTTP puro (senha e cookie à vista na
353
+ rede). No modo Node: `HABBLAUD_REMOTE_PORT` e `HABBLAUD_REMOTE_HOST` (padrão `0.0.0.0:4748`) e
354
+ `HABBLAUD_REMOTE_TLS_DIR` (padrão `~/.habblaud/remote-tls/server`).
355
+
356
+ ### Atualizar
357
+
358
+ A versão em uso aparece na barra superior, ao lado de "Conectado", e em **Configurações › Sobre**. Numa instalação
359
+ empacotada, o Busybits consulta o npm a cada 6 horas por padrão (clone e Docker: desligado; `HABBLAUD_UPDATE_CHECK=1` ou
360
+ `0` muda isso). Quando sai uma versão nova, o selo verde **Nova versão** aparece no lugar do número. **Sobre** tem o
361
+ link do que mudou (também no [`CHANGELOG.md`](CHANGELOG.md)), o botão **Verificar agora** e, numa instalação empacotada,
362
+ **Atualizar agora**, que roda `busybits update` fora do serviço. Pelo terminal:
363
+
364
+ ```bash
365
+ busybits update # para a versão mais recente
366
+ busybits update --check # só mostra a versão atual e a mais recente
367
+ busybits update --to 1.2.0 # para uma versão específica
368
+ busybits update --global # atualiza também o comando busybits global
369
+ busybits update --rollback # volta para a versão anterior
370
+ ```
371
+
372
+ - Recusa começar enquanto outra atualização roda (arquivo de bloqueio `~/.busybits/update.lock`; se nenhuma estiver
373
+ rodando de verdade, apague-o).
374
+ - Se a versão nova falhar no setup ou não responder em `/api/health` em 30 s, volta para a anterior (a checagem de `/api/health` e a volta só acontecem quando há um serviço em segundo plano instalado; falha no setup sempre volta).
375
+ - Interrompê-la com Ctrl-C durante a espera de saúde costuma deixar a versão **nova** ativa: rode
376
+ `busybits update --rollback` para voltar.
377
+ - Windows: `busybits update` não está disponível; veja a seção de instalação.
378
+
379
+ **A partir de um clone** (ou Docker):
380
+
381
+ ```bash
382
+ git pull
383
+ npm install
384
+ npm run docker:up # ou: npm run build && npm start (e depois npm run mod:install)
385
+ ```
386
+
387
+ > Se o `git pull` parar com "Your local changes to the following files would be overwritten by merge:
388
+ > package-lock.json", rode `git checkout -- package-lock.json` e repita: até a 0.4.0, o `npm install` alterava esse
389
+ > arquivo.
390
+
391
+ O `docker:up` também atualiza o mod nas contas em que ele já está instalado (nunca instala sozinho) e avisa:
392
+ "Mod atualizado para 0.3.0 na Conta D; sessões abertas: /reload-plugins". No modo Node, rode `npm run mod:install`
393
+ depois de atualizar. Para o Busybits consultar o npm, use `HABBLAUD_UPDATE_CHECK=1` (no `.env`, para o Docker).
394
+
395
+ #### Vindo do CodeTown
396
+
397
+ O Busybits se chamava **CodeTown** até a 0.3.2. Depois do `git pull`, rode uma vez:
398
+
399
+ ```bash
400
+ npm install
401
+ npm run mod:install # troca o marketplace e os plugins codetown pelos habblaud, em cada conta
402
+ npm run docker:up # tira o container codetown e copia os dados do volume antigo para o novo
403
+ ```
404
+
405
+ - **Mod:** até o `mod:install`, o Claude Code das contas reclama do marketplace `codetown` (as pastas
406
+ `mod/codetown*` mudaram de nome). O `docker:up` avisa, mas não troca sozinho.
407
+ - **Docker:** o volume antigo (`codetown_codetown-data`) fica intacto. Depois de conferir que os nomes dos personagens
408
+ vieram, apague-o com `docker volume rm codetown_codetown-data`, e a imagem antiga com `docker image rm codetown:local`.
409
+ - **Pasta local:** `~/.codetown` vira `~/.habblaud` sozinha (no servidor, no `docker:up` e no `mod:install`).
410
+ - **Navegador:** preferências e moedinhas passam para as chaves novas na primeira vez que a página abre.
411
+ - **Variáveis:** as `CODETOWN_*` não valem mais; renomeie para `HABBLAUD_*` no `.env` (ex.: `HABBLAUD_BIND`). O
412
+ servidor e o `docker:up` avisam quando acham uma antiga.
413
+ - **Repositório:** agora é `github.com/marmottajr/habblaud` (o GitHub redireciona o endereço antigo). Para acertar o
414
+ clone: `git remote set-url origin https://github.com/marmottajr/habblaud.git`. A pasta local pode continuar com o
415
+ nome antigo.
416
+ - Backups do `settings.json` feitos antes da troca continuam com o nome `settings.json.codetown-backup-<data>`.
417
+
418
+ ### Desinstalar
419
+
420
+ ```bash
421
+ busybits uninstall --dry-run # mostra o que seria removido
422
+ busybits uninstall # remove o serviço, a extensão do Pi, os hooks do Codex e o mod
423
+ busybits uninstall --purge # apaga também os dados do Busybits
424
+ npm rm -g busybits # só se você instalou globalmente
425
+ ```
426
+
427
+ **A partir de um clone** (ou Docker):
428
+
429
+ ```bash
430
+ npm run mod:uninstall # tira o mod, os plugins de permissões e de mensagens e o marketplace
431
+ npm run codex:uninstall # tira os hooks do Busybits do Codex (os outros ficam)
432
+ npm run docker:down # para o container
433
+ docker volume rm habblaud_habblaud-data # apaga os dados do container (nomes, salas, linha do tempo e estatísticas)
434
+ docker image rm habblaud:local # apaga a imagem
435
+ rm -rf ~/.habblaud # apaga os dados locais (uso capturado, nomes, salas, linha do tempo e estatísticas)
436
+ ```
437
+
438
+ Depois é só apagar a pasta do projeto — rode o `mod:uninstall` **antes**, senão o Claude Code das contas passa a
439
+ reclamar do marketplace que sumiu. Se você usou o jeito antigo, rode também `npm run usage:uninstall` (devolve o
440
+ statusline original) e `npm run hooks:uninstall` (tira o hook de permissão); sem eles, o statusline das contas passa
441
+ a dar erro (e o hook, a falhar em silêncio). O `mod:install`, que tira o tap e o hook antigos, e os instaladores e
442
+ desinstaladores antigos deixam cópias `settings.json.habblaud-backup-<data>` na pasta de cada conta (ex.:
443
+ `~/.claude/`); apague-as se não precisar mais.
444
+
445
+ ## Como usar
446
+
447
+ ### O que cada personagem está fazendo
448
+
449
+ | Estado | O que você vê |
450
+ | --- | --- |
451
+ | **Trabalhando** | Na mesa, digitando. O monitor e um balão mostram a atividade: 📖 lendo, ✏️ editando, 💻 terminal, 🧪 testes, 🌐 pesquisando… |
452
+ | **Precisa de você** | Corre para a mesa e levanta a mão, com alerta piscando: está esperando uma permissão ou resposta no terminal. |
453
+ | **Esperando o shell** | Terminou o turno mas deixou um comando rodando (testes, build, deploy…), então fica na mesa com uma ampulheta virando sobre a cabeça e o terminal em progresso: come pipoca assistindo, depois de 3 min cruza os braços e gira na cadeira, depois de 10 min junta teia de aranha e depois de 25 min cochila; quando o comando termina, levanta e comemora com confete (ou ganha uma nuvem de chuva, se falhou). Depois de 40 s, se houver colegas à toa, pode sair para uma roda — com a ampulheta na cabeça. |
454
+ | **Ocioso** | Terminou o turno e passeia: café na copa, bebedouro, banheiro, sofá do lounge, celular no puff, espelho. Com colegas à toa, entra numa roda: TV, videogame, ping-pong, papo na copa, jokenpô (veja [Vida social](#vida-social)). Depois de 10 min parado, cochila — mas um colega pode acordá-lo para uma roda. |
455
+ | **Subagente concluído** | Vai até o agente que o chamou, entrega o resultado e sai pelo elevador. |
456
+ | **Sessão encerrada** | Vai embora; se era o último da sala, apaga a luz antes de sair. |
457
+
458
+ Cada personagem tem um **nome brasileiro único** (Marina, Henrique, Luan…) que se mantém enquanto a sessão existir, e
459
+ um **chip colorido com a letra da conta** (C, D…).
460
+
461
+ ### Interface
462
+
463
+ - **Topo:** contadores (salas, agentes, trabalhando, subagentes, shells rodando, precisam de você) e um cartão de
464
+ **uso por conta**. O de shells só aparece enquanto algum comando está rodando; clique nele para ir até quem espera.
465
+ Embaixo do logo ficam a conexão e a versão em uso, que vira o selo **Nova versão** quando sai uma versão nova (veja
466
+ [Atualizar](#atualizar)).
467
+ - **Painel lateral:** busca, filtro por conta e a lista de salas com seus agentes e subagentes.
468
+ - **Gaveta de detalhes:** clique num personagem (no prédio ou na lista) para ver atividade, tarefas, subagentes,
469
+ linha do tempo e estatísticas (ferramentas, tokens, custo, linhas alteradas, modelo, branch).
470
+ - **Feed:** as últimas atividades de todo o escritório.
471
+ - **Configurações (⚙):** nomes, balões, quanto os ociosos passeiam, ciclo dia/noite, sons, notificações do navegador,
472
+ limite de FPS (60/30/15 FPS) e pausa quando a aba está oculta, modo demonstração e **Sobre** (versão em uso e versão nova). **Ajuda (?):** legenda completa e atalhos.
473
+ - **Painel de Desempenho:** o ícone de medidor na barra superior abre o uso de recursos em tempo real por máquina (central e satélites: CPU, memória RSS/heap, event loop p99, tempo de atividade, contadores de trabalho e sparklines de 10 minutos) e no navegador (FPS, tempo de quadro p50/p95 como indicador de GPU, tarefas longas, heap JS, nós do DOM e teto de FPS). Polling ativo apenas enquanto o painel estiver aberto e visível.
474
+ - **Meu dia (📊):** para onde foi o tempo do dia (veja [Meu dia](#meu-dia)). **Timelapse** e **Histórico** (os relógios
475
+ da barra superior): veja [Timelapse do dia](#timelapse-do-dia) e [Terminal](#terminal).
476
+
477
+ **Câmera:** arraste para mover, role para dar zoom, clique duplo num personagem para segui-lo.
478
+
479
+ **Atalhos:** `/` busca · `F` seguir o selecionado · `T` terminal · `L` timelapse · `M` meu dia · `P` próximo pedido
480
+ (permissão ou pergunta) · `O` ou `0` visão geral · `Esc` limpar seleção · `[` painel lateral · `]` feed · setas/`WASD` mover ·
481
+ `+` `-` zoom · `?` ajuda.
482
+
483
+ ### Temas do escritório
484
+
485
+ Em **Configurações → Aparência → Tema do escritório**, escolha:
486
+
487
+ - **Automático** (padrão): segue o calendário, na hora local. Halloween de 1º a 31 de outubro, Natal de 1º de
488
+ novembro a 26 de dezembro e, no resto do ano, o visual original.
489
+ - **Nenhum**: sempre o visual original.
490
+ - **Natal**: guirlandas, luzes quentes, árvores com presentes, tapetes natalinos, neve nas janelas e gorros nos personagens.
491
+ - **Halloween**: abóboras, fantasmas decorativos, teias, morcegos, luzes roxas, tapetes temáticos e acessórios de fantasia.
492
+
493
+ A troca é imediata e a escolha fica salva neste navegador. Os temas preservam os caminhos,
494
+ as atividades e as animações dos agentes. O ciclo dia/noite continua sendo uma opção independente.
495
+
496
+ <table>
497
+ <tr>
498
+ <td width="50%"><img src="docs/screenshots/seasonal-christmas.png" alt="Escritório no tema Natal: árvores com presentes nos cantos das salas, guirlandas e luzes nas paredes, tapetes vermelhos e personagens de gorro" /></td>
499
+ <td width="50%"><img src="docs/screenshots/seasonal-halloween.png" alt="Escritório no tema Halloween: abóboras e fantasmas no lugar das plantas, teias e morcegos nas paredes, tapetes roxos e personagens fantasiados" /></td>
500
+ </tr>
501
+ </table>
502
+
503
+ ### Idiomas
504
+
505
+ A interface está em **português, inglês, espanhol e francês**. Ela segue o idioma do navegador; em
506
+ **Configurações › Idioma** dá para fixar um (a escolha fica salva neste navegador). Os textos que o servidor monta
507
+ (atividades, avisos, terminal, logs e os scripts de instalação) seguem `HABBLAUD_LANG` e, sem ele, o idioma do
508
+ sistema e, sem nenhum dos dois, o inglês. Para outro idioma, defina `HABBLAUD_LANG` (`pt-BR`, `en`, `es` ou `fr`; no
509
+ Docker, no `.env`), por exemplo `HABBLAUD_LANG=es`. Um texto sem tradução aparece em
510
+ português.
511
+
512
+ ### Dia, noite e sons
513
+
514
+ O escritório acompanha a **hora local**: de madrugada e à noite o gramado e a rua ficam azulados e escuros, os postes,
515
+ os abajures, as máquinas e os monitores ligados acendem halos de luz, as salas com gente ficam iluminadas (a luz que
516
+ apaga quando a sala esvazia continua valendo), os carros passam de farol aceso e aparecem vaga-lumes no jardim. No
517
+ amanhecer (~5–7 h) e no entardecer (~17–19 h) tudo ganha um tom quente, e durante o dia o sol entra pelas janelas e
518
+ desenha faixas de luz no piso — curtas ao meio-dia, longas e alaranjadas no fim da tarde. Em **Configurações › Ciclo
519
+ dia/noite** dá para escolher automático, sempre dia ou sempre noite; para testar um horário, use `?hora=21:30` na URL.
520
+
521
+ Os **sons** vêm desligados. Ligados em **Configurações › Sons**, são sintetizados no próprio navegador (sem arquivos
522
+ de áudio) e baixinhos: o teclado de quem trabalha nas salas à vista, o "ding" do elevador quando alguém chega ou vai
523
+ embora, o sino quando alguém precisa de você, o estalo de tarefa concluída e o pingue-pongue e o fliperama das rodas.
524
+ Há volume geral e cada categoria liga e desliga à parte. Com a aba oculta, só o sino toca.
525
+
526
+ ### Terminal
527
+
528
+ Clique num agente e use **Abrir terminal** para ver a conversa da sessão como o Claude Code mostra: os prompts, as
529
+ respostas, cada ferramenta chamada (com o comando ou o diff) e o resultado, atualizados ao vivo. Vale para agentes
530
+ principais e subagentes; no modo demonstração, a conversa é fictícia.
531
+
532
+ No rodapé, para agentes principais, dá para **digitar**: `Enter` manda e `Shift+Enter` quebra a linha. O texto entra
533
+ na sessão como se você tivesse digitado no terminal dele (veja [Mandar mensagens](#mandar-mensagens)); se o agente
534
+ estiver ocupado, entra quando ele terminar o que está fazendo. Subagentes e sessões do histórico continuam só para ler.
535
+
536
+ - **Busca:** com o terminal em foco, `Ctrl+F` (`⌘F` no Mac) ou a lupa do cabeçalho abre a busca na conversa, sem
537
+ diferenciar maiúsculas nem acentos. O contador mostra a posição ("3/17"); `Enter` e `Shift+Enter` vão para o próximo
538
+ e o anterior, abrindo os blocos recolhidos ("… +N linhas") onde o termo estiver. A busca continua valendo enquanto
539
+ chegam mensagens novas. `Esc` fecha a busca; o seguinte fecha o terminal.
540
+ - **Filtro:** **Tudo**, **Só prompts** (os seus prompts e as respostas finais do agente, sem os passos intermediários)
541
+ ou **Sem ferramentas**.
542
+ - **Copiar:** passe o mouse (ou o foco) sobre um prompt, uma resposta, um comando ou um resultado para copiá-lo.
543
+ - **Histórico:** o relógio da barra superior lista as sessões dos últimos 7 dias de todas as contas (até 150), agrupadas
544
+ por dia, com busca por título, projeto ou conta. Uma sessão encerrada abre no terminal com projeto, título e data no
545
+ cabeçalho e "Sessão encerrada às …" no rodapé; uma sessão ainda aberta abre o terminal ao vivo do agente.
546
+
547
+ Como o terminal (e o histórico) mostra a conversa inteira, ele só existe quando o Busybits está acessível **apenas pelo
548
+ próprio computador** (o padrão) e só abre por `http://localhost` ou `http://127.0.0.1`. Com a porta liberada para a rede
549
+ (`HABBLAUD_BIND=0.0.0.0` ou `HABBLAUD_HOST=0.0.0.0`), ele fica desligado. Detalhes em
550
+ [Privacidade e segurança](#privacidade-e-segurança).
551
+
552
+ ### Terminal interativo (assumir, nova sessão e encerrar)
553
+
554
+ Com `HABBLAUD_PTY=1` e rodando com `npm start` (fora do Docker), a janela de terminal de cada agente principal é
555
+ interativa: o botão **Abrir terminal** da gaveta, o atalho ao lado de cada agente na lista lateral ou a tecla `T`
556
+ abrem a mesma janela, com abas para os outros agentes do mesmo projeto.
557
+
558
+ - Sessão aberta aqui: é o Claude Code de verdade (digitar, responder; Esc interrompe o agente, como no terminal).
559
+ - Sessão aberta noutro terminal: **Assumir daqui** (no topo da janela) encerra a sessão lá e continua a **mesma
560
+ conversa** aqui (`claude --resume <sessão>`, na mesma pasta e conta). O personagem mantém o nome. No Windows, o
561
+ terminal de onde a sessão saiu volta ao normal (o Busybits desliga os modos de mouse/teclado que o Claude ligou).
562
+ - **Encerrar** fecha a sessão, esteja ela aqui ou noutro terminal (a conversa fica salva).
563
+ - **Nova sessão** (na gaveta da sala) abre um Claude Code novo na pasta do projeto.
564
+
565
+ Assumir e encerrar pedem um segundo clique; fechar a janela não encerra a sessão. A janela (e a gaveta do
566
+ agente) pode ser arrastada pela barra e redimensionada pelo canto; duplo clique na barra devolve ao lugar.
567
+ **Vem desligado:** ligue com `HABBLAUD_PTY=1` (leia antes o aviso em [Privacidade e segurança](#privacidade-e-segurança)).
568
+ Usa o `node-pty`, o `@xterm/headless` (dependências opcionais) e o `claude` do PATH (`HABBLAUD_CLAUDE_BIN` para
569
+ outro); só aceita pedidos do próprio computador. Ao iniciar, o Busybits abre um terminal de teste: se o `node-pty` ou
570
+ o `claude` não funcionarem, o recurso fica desligado e o log diz o motivo. **Reiniciar o Busybits encerra as sessões
571
+ abertas por ele.**
572
+ O terminal ao vivo continua no histórico de sessões, para subagentes e quando o interativo está desligado.
573
+
574
+ ### Timelapse do dia
575
+
576
+ O botão **Timelapse** (relógio com a seta de voltar, ou a tecla `L`) reproduz o dia em alta velocidade: salas
577
+ acendendo e apagando, agentes chegando, trabalhando, esperando você, indo para as rodas, subagentes entrando e saindo.
578
+ A barra de reprodução tem o dia, play/pausa, a velocidade (60×, 180× ou 600×: um dia de 10 h em 10, 3⅓ ou 1 min),
579
+ a linha do tempo arrastável com o gráfico de quem estava presente e trabalhando, as marcas dos picos (clique para
580
+ pular até lá) e **Voltar ao vivo**. Enquanto isso, o escritório fica levemente sépia, com o selo **REPLAY 14:32**, e o
581
+ feed continua mostrando o que acontece agora.
582
+
583
+ O servidor grava a linha do tempo **a partir do momento em que está ligado** (não dá para reconstruir o passado):
584
+ resumos do que o escritório mostra, sem conversas, em `~/.habblaud/timeline/` (no Docker, no volume de dados), com
585
+ limite de tamanho por dia e os últimos **7 dias** guardados. Para não gravar: `HABBLAUD_TIMELINE=0`. Detalhes em
586
+ [`server/README.md`](server/README.md#linha-do-tempo-timelapse).
587
+
588
+ Os personagens andam mais rápido no replay, mas nas velocidades altas quem fica pouco tempo no escritório quase não
589
+ chega à mesa; pular para outro ponto mostra todos já no lugar.
590
+ ### Responder pelo escritório
591
+
592
+ Com o plugin de permissões instalado (`npm run mod:install`, que o instala junto com o mod; no Claude Code anterior
593
+ ao 2.1.287, `npm run hooks:install`), quando um agente pede permissão — rodar um comando, editar um arquivo, abrir
594
+ uma página — o pedido aparece no escritório: o personagem levanta a mão, um aviso com **Responder**
595
+ surge na tela e, nos detalhes do agente, o cartão **Pede permissão** mostra o comando (ou o diff da edição) com os
596
+ botões:
597
+
598
+ - **Aprovar** — e, quando o Claude Code sugere, **Aprovar e não perguntar de novo** (a mesma regra que o terminal
599
+ ofereceria, por exemplo `Bash(npm test:*)` neste projeto);
600
+ - **Recusar** — com um motivo opcional, que vai para o agente, e a opção de interrompê-lo;
601
+ - **Responder no terminal** — o Busybits deixa o pedido de lado.
602
+
603
+ O diálogo continua aparecendo no terminal ao mesmo tempo, e vale o que você responder primeiro: respondeu no
604
+ terminal, o pedido some do escritório sozinho. O contador **precisam de você** (e a tecla `P`) leva até cada pedido.
605
+
606
+ **Perguntas do agente** (`AskUserQuestion`) também: o cartão de perguntas mostra cada pergunta com as
607
+ opções e as descrições, como o terminal mostraria. Escolha uma opção (ou várias, quando a pergunta deixa) ou escreva
608
+ a sua em **Outro**, e use **Responder**; **Recusar…** diz ao agente que você não quer responder, e **Responder no
609
+ terminal** deixa a pergunta lá. A resposta chega ao agente como se você tivesse escolhido no terminal.
610
+
611
+ - O pedido passa por um hook `PermissionRequest` do Claude Code (o do plugin, ou o do jeito antigo), que só o desvia
612
+ quando há **alguma página do Busybits aberta** neste computador; com o Busybits parado ou sem nenhuma página, ele
613
+ sai na hora e o terminal segue normal.
614
+ - Sem resposta pelo escritório em 5 minutos (até 24 h com `HABBLAUD_PERMISSION_TIMEOUT=86400` no `env` do
615
+ `settings.json`), o pedido volta a valer só no terminal (as opções do plugin estão em
616
+ [`mod/README.md`](mod/README.md); no jeito antigo, `npm run hooks:install -- --timeout 120` muda o tempo e
617
+ `--port`, a porta). Em **subagentes em segundo plano** o Claude Code só mostra o diálogo no terminal depois que o
618
+ hook termina: responda pelo escritório ou use **Responder no terminal**. Numa espera maior que 5 minutos, se nenhuma
619
+ página que responda ficar aberta por 5 minutos (e nenhum [celular com login](#celular-com-login-e-https-aprovando-pedidos)
620
+ estiver configurado para responder), o pedido volta ao terminal.
621
+ - Funciona com a mesma trava do terminal: só com o Busybits acessível apenas pelo próprio
622
+ computador e aberto por `http://localhost`. Confira com `npm run mod:status` (ou `npm run hooks:status`, no jeito
623
+ antigo). Também funciona pelo [celular com login](#celular-com-login-e-https-aprovando-pedidos) (lá, é o padrão).
624
+ - No modo demonstração, os agentes fictícios também pedem permissão e fazem perguntas (de mentira), para
625
+ experimentar.
626
+
627
+ ### Mandar mensagens
628
+
629
+ Com o plugin de mensagens instalado (`npm run mod:install`, que o instala junto com o mod; precisa do Claude Code
630
+ 2.1.287 ou mais novo), os detalhes de cada agente principal ganham a seção **Mandar mensagem**, e o rodapé do
631
+ [terminal](#terminal) vira uma caixa de digitação. Escreva e aperte `Enter` (`Shift+Enter` quebra a linha): o texto
632
+ entra na sessão **como se você tivesse digitado no terminal dela**. Dá para responder quando o agente termina o turno
633
+ e espera o próximo pedido, dar uma instrução nova ou corrigir o rumo, sem procurar a janela certa.
634
+
635
+ - A caixa mostra a situação: **na fila** (a sessão busca as mensagens a cada 2 segundos), **entregue** ou **não
636
+ entregue**, com o motivo. Com o agente ocupado, a mensagem espera e entra quando ele terminar o turno, como um
637
+ prompt digitado com o agente trabalhando.
638
+ - O plugin roda dentro de cada sessão e só fala com o Busybits em `127.0.0.1`. Sem ele (ou numa sessão aberta antes
639
+ da instalação: use `/reload-plugins`), aparece a dica de instalação no lugar da caixa. Subagentes não recebem
640
+ mensagens.
641
+ - Funciona com a mesma trava do terminal (só com acesso local) e pode ser desligado com `HABBLAUD_MENSAGENS=0`.
642
+ Leia o aviso em [Privacidade e segurança](#privacidade-e-segurança).
643
+ Pelo [celular com login](#celular-com-login-e-https-aprovando-pedidos), só com `messages` no `HABBLAUD_REMOTE_ALLOW`.
644
+ - No modo demonstração, os agentes fictícios também recebem mensagens (de mentira).
645
+
646
+ Se a mesma conversa do Claude Code estiver aberta em dois terminais ao mesmo tempo, os dois agentes recebem o selo
647
+ **duplicada** e o prédio dispara um alerta de intrusão: os personagens correm por alguns segundos e a faixa de alarme fica ligada enquanto a conversa seguir duplicada (no máximo 10 minutos). O agente mais novo
648
+ fica marcado na gaveta; as mensagens enviadas a qualquer um dos dois são encaminhadas para ele. Feche o outro terminal
649
+ e mantenha aberta a sessão mais nova. Quando uma das sessões sair, o selo e o alerta desaparecem.
650
+
651
+ ### Editar o personagem
652
+
653
+ Cada sessão chega com um nome e uma aparência sorteados. Para fixar o personagem de um projeto, abra os detalhes do
654
+ agente principal e clique no lápis ao lado do nome (**Editar personagem**). No editor:
655
+
656
+ - **Nome:** até 24 caracteres. Não pode repetir o de alguém que está no escritório nem o escolhido para outro
657
+ projeto.
658
+ - **Sortear:** traz outra aparência.
659
+ - **Peças:** pele, cabelo, barba, olhos, parte de cima, parte de baixo, sapatos e acessório, com a prévia ao lado.
660
+ - **Salvar:** vale para o projeto (a sala). A próxima sessão aberta nele chega com esse personagem. Com duas sessões
661
+ ao mesmo tempo na mesma sala, a segunda recebe um personagem sorteado.
662
+ - **Voltar ao sorteio:** desfaz a escolha.
663
+
664
+ A escolha fica em `~/.habblaud/names.json` e some depois de 60 dias sem uso do projeto. O editor tem a mesma trava do
665
+ terminal: o lápis só aparece com o terminal ligado (sem `HABBLAUD_TERMINAL=0`) e o acesso local, isto
666
+ é, com o Busybits acessível apenas pelo próprio computador e aberto por `http://localhost`.
667
+
668
+ ### Codex
669
+
670
+ As sessões do Codex (CLI ou app) aparecem como as do Claude Code: personagem, sala do projeto, atividade, tarefas,
671
+ subagentes, terminal e histórico, uso de 5 horas e semanal e o **Meu dia** (só tokens: o Codex não informa custo). O
672
+ chip da conta do Codex é vazado e leva o selo **CODEX**.
673
+
674
+ - **Sem instalar nada**, o Busybits lê os arquivos que o próprio Codex grava (as conversas em `~/.codex/sessions` e as
675
+ travas das sessões abertas em `~/.codex/thread-writer-locks`). Só que o Codex grava cada passo **depois** que ele
676
+ termina e nunca grava "esperando você": sem os hooks, o escritório mostra o Codex com atraso e não avisa quando ele
677
+ precisa de você.
678
+ - **Com os hooks** (`npm run codex:install` e aprovar em `/hooks`), o Codex avisa o Busybits a cada passo: a sessão
679
+ aparece na hora, a atividade é a de agora e um pedido de aprovação levanta a mão do personagem.
680
+ - **Aprovar pelo escritório:** com alguma página do Busybits aberta, o pedido de aprovação do Codex espera a sua
681
+ resposta no cartão **Pede permissão** por até **25 segundos** (`npm run codex:install -- --espera <s>`, de 5 a 120):
682
+ **Aprovar** ou **Recusar** (com o motivo). Diferente do Claude Code, o Codex só mostra a aprovação no terminal
683
+ **depois** que o escritório responde ou o prazo acaba — nesse meio-tempo o terminal mostra "Aguardando resposta no
684
+ Busybits…". Não há "sempre permitir" nem "interromper", e o Codex não deixa responder as perguntas dele por fora.
685
+ - **Mandar mensagens:** a caixa **Mandar mensagem** funciona para o Codex também, pelo `codex queue`: a mensagem entra
686
+ na fila da sessão e o Codex a pega quando termina o que está fazendo (até uns 10 segundos depois). No modo Node o
687
+ próprio Busybits roda o comando; **no Docker**, deixe `npm run codex:bridge` rodando no Mac (o container não
688
+ enxerga o seu Codex).
689
+ - **Uso de 5 horas e semanal:** vem dos próprios arquivos do Codex e só se renova enquanto alguma sessão roda; o cartão
690
+ mostra a idade dos números e "sem cota" quando o workspace ficou sem créditos.
691
+ - **Quando a sessão entra:** com a primeira mensagem (é quando o Codex grava a pasta do projeto); uma CLI aberta e
692
+ ainda sem conversa não aparece.
693
+ - **Quando a sessão sai do escritório:** a CLI do Codex roda as sessões num servidor em segundo plano, que as mantém
694
+ carregadas até um minuto depois de ficarem ociosas e sem ninguém olhando; por isso o personagem pode demorar um
695
+ pouco para ir embora depois que você fecha o terminal.
696
+ - Conversas da nuvem do ChatGPT (sem arquivo no computador) não aparecem. `HABBLAUD_CODEX=0` desliga o Codex.
697
+
698
+ ### GitHub no escritório
699
+
700
+ O que os agentes fazem no GitHub anima a sala do projeto, sem token e sem acessar a internet: o Busybits lê nos
701
+ transcripts as chamadas (`gh pr create`, `gh pr merge`, `git push`, `gh run watch`, `gh pr checks`, `gh run view`,
702
+ `gh release create` e as ferramentas do MCP do GitHub) e os resultados delas.
703
+
704
+ | Evento | O que acontece |
705
+ | --- | --- |
706
+ | 🎉 **PR aberto ou mergeado, release publicada** | Confete cai na sala, todos comemoram com pulinhos e uma faixa diz o motivo ("PR #12 mergeado!") por ~12 s. |
707
+ | 🚨 **CI vermelho** | Giroflex piscando nos cantos da sala, chão avermelhado e um balão "!" sobre quem viu a falha, até um CI verde na sala (que vira festa) ou por 10 min. |
708
+ | 🚀 **Push** | Só o aviso e o feed. |
709
+
710
+ <table>
711
+ <tr>
712
+ <td width="50%"><img src="docs/screenshots/github-party.png" alt="Sala app-mobile em festa: confete caindo, a faixa dourada 'PR #12 mergeado!' e Jéssica de pé com os braços para cima e uma estrela sobre a cabeça" /></td>
713
+ <td width="50%"><img src="docs/screenshots/github-alarm.png" alt="Sala data-pipeline em alarme: chão avermelhado, faixa vermelha 'CI falhou (feat/checkout)', giroflex nos cantos de cima e um balão '!' vermelho ao lado de Ícaro" /></td>
714
+ </tr>
715
+ </table>
716
+
717
+ Cada evento também gera um aviso ("🎉 Danilo abriu o PR #12 em habblaud", "🚨 CI falhou em habblaud (feat/x)") e entra
718
+ no feed. Só o que acontece ao vivo anima a sala: o que já estava nos transcripts quando o Busybits abriu vai só para o
719
+ histórico. Com "reduzir movimento" ligado no sistema, nada pisca nem gira. No modo demonstração, PRs, merges e CIs
720
+ fictícios aparecem de tempos em tempos.
721
+ ### Meu dia
722
+
723
+ O botão **Meu dia** (ou a tecla `M`) mostra para onde foi o dia: quanto tempo os agentes passaram trabalhando e,
724
+ em destaque, quanto tempo ficaram **esperando você** (permissão, pergunta ou escolha) — com a maior espera, quem
725
+ esperou, onde e quando. Ao lado, sessões, subagentes, pedidos, tokens e custo (quando o Claude Code grava o custo no
726
+ transcript), e gráficos por hora, por projeto (do que mais esperou você para o que menos esperou) e por conta, além
727
+ do ranking das maiores esperas. Escolha o dia no seletor (o Busybits guarda os últimos 30); aberto no dia de hoje,
728
+ o painel se atualiza a cada 30 s. Cada gráfico tem uma versão em tabela, e a legenda liga e desliga cada status.
729
+
730
+ O tempo é **tempo de agente**: dois agentes trabalhando por uma hora contam duas horas. O Busybits só conta o que
731
+ acontece enquanto ele está rodando, e o dia segue o fuso do seu navegador. Com o modo demonstração ligado, o painel
732
+ mostra números fictícios (com o selo "demonstração") e deixa alternar para os dados reais; os agentes do demo nunca
733
+ entram nas estatísticas de verdade.
734
+
735
+ ### Modo demonstração
736
+
737
+ Quer ver o escritório cheio sem ter sessões abertas?
738
+
739
+ - Acrescente **`?mock=1`** à URL (ex.: http://localhost:4747/?mock=1) para simular tudo no navegador, sem as suas
740
+ sessões reais. Parâmetros: `&speed=3` acelera o tempo e `&sessions=6` muda o número de sessões simuladas.
741
+ - Ou ligue pela interface — **Ver demonstração** (quando o escritório está vazio) ou **Configurações › Modo
742
+ demonstração** —, que coloca agentes fictícios junto com os reais. Com `npm run demo` (ou `HABBLAUD_DEMO=1` no
743
+ `.env` do Docker), esse modo já começa ligado.
744
+
745
+ ## Contas e uso (5 horas e semanal)
746
+
747
+ > As contas do **Codex** entram sozinhas (cada pasta `~/.codex*` ou `CODEX_HOME` é uma conta; a letra vem de um
748
+ > `alias x='CODEX_HOME=… codex'`, se houver) e o uso delas vem dos arquivos do Codex; veja [Codex](#codex). O resto
749
+ > desta seção é sobre o Claude Code.
750
+
751
+ Se você usa mais de uma conta do Claude Code (por exemplo, um atalho `c` com `~/.claude` e um `d` com
752
+ `CLAUDE_CONFIG_DIR=~/.claude-conta2`), o Busybits mostra todas juntas: cada agente leva o chip da sua conta e o topo
753
+ mostra, para cada conta, o **percentual usado** da sessão de 5 horas e da semana e **quando cada limite reinicia**.
754
+
755
+ **Como as contas são reconhecidas.** Cada pasta de configuração do Claude Code é uma conta: `~/.claude` e qualquer
756
+ `~/.claude*` com `projects/` ou `sessions/` (além de `CLAUDE_CONFIG_DIR`). Para dar a letra de cada uma, o Busybits
757
+ lê nos arquivos do shell (`~/.zshrc`, `~/.bashrc`…) **somente** as linhas `alias x='... claude ...'`:
758
+
759
+ ```bash
760
+ alias c='claude'
761
+ alias d='CLAUDE_CONFIG_DIR=~/.claude-conta2 claude'
762
+ ```
763
+
764
+ vira **Conta C** e **Conta D**. Só valem atalhos de até 3 letras; contas sem atalho recebem A, B…
765
+
766
+ **De onde vêm os números.** O jeito recomendado é o mod do Busybits (`npm run mod:install`, Claude Code 2.1.287+):
767
+ dentro de cada sessão, ele recebe do próprio Claude Code os limites do plano e guarda só os percentuais de 5 horas e
768
+ da semana (e quando reiniciam) em `~/.habblaud/usage/<conta>.json`. Os números chegam depois da próxima resposta de
769
+ cada conta. Confira com `npm run mod:status`. Em versões anteriores do Claude Code, o tap de statusline
770
+ (`npm run usage:install`) faz o mesmo pelo comando de statusline, no mesmo arquivo.
771
+
772
+ <details>
773
+ <summary><b>Detalhes do tap e do cache do /usage</b></summary>
774
+
775
+ - O `usage:install` (jeito antigo) altera, em `<conta>/settings.json`, **só** o campo `statusLine.command`: o comando
776
+ original (ex.: `npx -y ccstatusline`) passa a rodar através de `node "<pasta do Busybits>/scripts/statusline-tap.mjs" --
777
+ <comando original>` (no Windows, o comando original roda no Git Bash, como o Claude Code o rodaria). Uma cópia do
778
+ arquivo vai antes para `settings.json.habblaud-backup-<data>`. Se a conta não tinha statusline, é criado um que só
779
+ captura o uso. `npm run usage:install -- --dry-run` mostra o que mudaria sem gravar.
780
+ - O tap repassa o mesmo JSON ao seu statusline (saída e código de saída continuam os dele) e grava **somente**
781
+ `{accountId, configDir, fetchedAt, five_hour, seven_day}` — nada de prompts, custos ou caminhos de projeto. Qualquer
782
+ falha na captura é ignorada: o statusline nunca quebra por causa do Busybits.
783
+
784
+ | Fonte | Como funciona |
785
+ | --- | --- |
786
+ | **Mod do Busybits** (recomendado) | Ao vivo, como descrito acima. Substitui o tap: o `mod:install` tira o tap da conta. |
787
+ | Tap de statusline (Claude Code anterior ao 2.1.287) | Ao vivo, pelo comando de statusline, no mesmo arquivo. |
788
+ | Cache do `/usage` (sempre ligado) | O Claude Code grava o último resultado do comando `/usage`. No modo Node, o Busybits relê a cada 60 s; no Docker, vale o valor lido no último `npm run docker:up`. Só muda quando alguém roda `/usage`. |
789
+
790
+ As fontes são arquivos locais: nenhuma lê senhas ou tokens, nem faz chamadas de rede. Vale sempre a fonte com os
791
+ números mais recentes. Números com mais de 30 minutos aparecem como **desatualizados**; uma janela que já reiniciou
792
+ desde a coleta aparece como **—** até chegarem números novos.
793
+
794
+ </details>
795
+
796
+ ## Configuração
797
+
798
+ Tudo funciona sem configurar nada. Se precisar ajustar, use variáveis de ambiente (no modo Node, cada `HABBLAUD_X`
799
+ também aceita o apelido `BUSYBITS_X`; com as duas definidas, vale a `HABBLAUD_X`):
800
+
801
+ | Variável | Padrão | Para quê |
802
+ | --- | --- | --- |
803
+ | `HABBLAUD_PORT` | `4747` | Porta HTTP (no Docker, a porta publicada no host). |
804
+ | `HABBLAUD_HOST` | `127.0.0.1` | Interface do servidor no modo Node. Fora de `127.0.0.1`/`localhost`, o terminal (e responder e mandar mensagens pelo escritório) fica desligado. |
805
+ | `HABBLAUD_BIND` | `127.0.0.1` | Só Docker (no `.env`): onde a porta é publicada. `0.0.0.0` libera a rede local (e desliga o terminal e o que age sobre as sessões). |
806
+ | `HABBLAUD_CLAUDE_DIRS` | detecção automática | Pastas das contas, separadas por vírgula (ex.: `/caminho/conta1,/caminho/conta2`). |
807
+ | `HABBLAUD_DATA_DIR` | `~/.habblaud` | Onde o Busybits guarda os próprios dados (nomes dos personagens e das salas, linha do tempo do timelapse e estatísticas do Meu dia). |
808
+ | `HABBLAUD_TIMELINE` | ligado | `0` desliga a gravação da linha do tempo (os dias já gravados continuam no timelapse). No Docker fica sempre ligado. |
809
+ | `HABBLAUD_USAGE_DIR` | `~/.habblaud/usage` | Onde o mod (ou o tap de statusline) grava o uso. |
810
+ | `HABBLAUD_DEMO` | desligado | `1` liga o modo demonstração ao iniciar. |
811
+ | `HABBLAUD_ALLOWED_HOSTS` | — | Nomes extras aceitos no endereço (ex.: `meu-mac.local`), além de `localhost` e IPs. |
812
+ | `HABBLAUD_TERMINAL` | ligado (só com acesso local) | `0` desliga o terminal, responder e mandar mensagens pelo escritório e o editor de personagem. Com a porta exposta eles já ficam desligados, sem opção de ligar. |
813
+ | `HABBLAUD_PTY` | desligado | `1` liga o terminal interativo (abrir, assumir e encerrar sessões do Claude Code pelo escritório; só com acesso local e fora do Docker) e o **Novo agente** (também no Docker, pelo `npm run codex:bridge`). Leia o aviso em [Privacidade e segurança](#privacidade-e-segurança). |
814
+ | `HABBLAUD_CLAUDE_BIN` | `claude` do PATH | O executável do Claude Code que o terminal interativo e o Novo agente rodam. |
815
+ | `HABBLAUD_REMOTE_ALLOW` | `permissions` | O que o [celular com login](#celular-com-login-e-https-aprovando-pedidos) pode fazer: `permissions`, `messages`, `terminal`, `spawn` (separados por vírgula) ou `none`. Os outros `HABBLAUD_REMOTE_*` são escritos pelo `npm run remote:setup`. |
816
+ | `HABBLAUD_MENSAGENS` | ligado (com o terminal) | `0` desliga só as mensagens pelo escritório (a caixa no terminal e nos detalhes do agente). |
817
+ | `HABBLAUD_CODEX` | ligado | `0` desliga o Codex no escritório. |
818
+ | `HABBLAUD_CODEX_DIRS` | detecção automática | Pastas do Codex, separadas por vírgula (no lugar de `~/.codex*` e `CODEX_HOME`). |
819
+ | `HABBLAUD_CODEX_BIN` | `codex` do PATH (no Windows, `codex.exe`) | O binário do Codex que entrega as mensagens (`codex queue`), no modo Node ou no `npm run codex:bridge`. |
820
+ | `HABBLAUD_UPDATE_CHECK` | empacotada: ligada; clone/Docker: desligada | `1` liga a verificação de versão nova (uma consulta ao registro do npm a cada 6 h), `0` desliga. |
821
+ | `HABBLAUD_LANG` | idioma do sistema, senão `en` | Idioma dos textos montados pelo servidor (atividades, avisos, logs): `pt-BR`, `en`, `es` ou `fr`. A interface segue o navegador ou a escolha em Configurações › Idioma. Ver [Idiomas](#idiomas). |
822
+ | `HABBLAUD_ACCOUNTS` | — | JSON para personalizar nome, letra ou cor, casado pelo nome da pasta da conta. Ex.: `[{"id":".claude-conta2","name":"Trabalho","short":"T","color":"#5cc97b"}]`. |
823
+
824
+ **No Docker**, valem `HABBLAUD_PORT`, `HABBLAUD_BIND`, `HABBLAUD_ALLOWED_HOSTS`, `HABBLAUD_DEMO`, `HABBLAUD_TERMINAL`,
825
+ `HABBLAUD_MENSAGENS`, `HABBLAUD_CODEX`, `HABBLAUD_UPDATE_CHECK`, `HABBLAUD_LANG`, `HABBLAUD_PTY`, os `HABBLAUD_WORLD*` e os
826
+ `HABBLAUD_REMOTE_*` (no `.env` ou no ambiente) e `HABBLAUD_CLAUDE_DIRS`, `HABBLAUD_CODEX_DIRS`, `HABBLAUD_USAGE_DIR` e
827
+ `HABBLAUD_ACCOUNTS` (lidas pelo `docker:up` no host); as demais ficam fixas dentro do container. Opções: `npm run docker:up -- --no-build` (sobe sem reconstruir),
828
+ `npm run docker:down` (para) e `npm run docker:logs` (acompanha os logs).
829
+
830
+ ## Habblaud World
831
+
832
+ O Habblaud World é uma cidade online em pixel art onde cada escritório do Busybits vira um prédio, aceso ao vivo
833
+ enquanto os agentes trabalham, e cada pessoa passeia com um personagem. **Vem desligado por padrão no Busybits**:
834
+ `HABBLAUD_WORLD=1` liga, apontando para `server.habblaud.com`; mesmo assim, **nada sai do computador até você criar a
835
+ conta** e entrar. O acesso é liberado por lista de espera.
836
+
837
+ **Como configurar.** Ligue com `HABBLAUD_WORLD=1` (no `.env` ou no ambiente); as outras variáveis abaixo são opcionais:
838
+ sem elas, o Busybits aponta para o servidor oficial. A seção aparece na janela **Habblaud World** (o botão de cidade na barra do topo) e só funciona pelo próprio computador (nunca pela porta do celular); a
839
+ conta fica só aqui, em `~/.habblaud/world.json` (permissão 600; no Docker, no volume `/data`).
840
+
841
+ | Variável | Padrão | Para quê |
842
+ | --- | --- | --- |
843
+ | `HABBLAUD_WORLD_URL` | `https://server.habblaud.com` | Endereço do servidor do mundo, só `https://` ou `wss://` (sem caminho). |
844
+ | `HABBLAUD_WORLD` | desligado | `1` liga o World (rotas e interface). Sem definir ou em `0`, não há nada do World e nada sai do computador. |
845
+ | `HABBLAUD_WORLD_DEV` | desligado | `1` aceita um servidor do mundo local sem TLS: `http://127.0.0.1:<porta>` (o `npm run dev` já aceita) ou, de dentro do Docker, `http://host.docker.internal:<porta>`. |
846
+
847
+ **Privacidade.** Nada do seu trabalho sai do computador. Do prédio saem só o tema, um andar por sala aberta (com um
848
+ código aleatório que muda todo dia) e, de cada agente, se é principal ou subagente, a ferramenta, o status, a
849
+ aparência, um nome sorteado e a faixa de tarefas concluídas no dia. Caminhos, nomes de projeto, títulos, comandos,
850
+ mensagens, código, custo, modelo, branch e a sua conta do Claude nunca saem. A lista completa, campo a campo:
851
+ [docs/world/privacidade.md](docs/world/privacidade.md). **Ver o que foi enviado**, no cartão Seu prédio, mostra o JSON
852
+ exato da última remessa, com o tamanho em bytes e a resposta do mundo.
853
+
854
+ **Conta e lista de espera.** Cadastro com e-mail, **nome de jogador** (3 a 20 caracteres, único no mundo: fica reservado
855
+ para você enquanto espera na lista e vira o nome do personagem) e senha (12 caracteres ou mais; senhas que já vazaram
856
+ são recusadas), código de 6 dígitos por e-mail e o aceite dos Termos de Uso e da Política de Privacidade. Toda conta
857
+ entra numa lista de espera, e o acesso é liberado por lotes: o Busybits aberto confere sozinho a cada 30 minutos. Até 3
858
+ computadores por conta (**Dispositivos**, com revogar).
859
+
860
+ **Personagem.** O nome de jogador escolhido no cadastro (dá para trocar depois, uma vez a cada 30 dias), o mesmo editor
861
+ de aparência dos agentes, 2 ou 3 traços de personalidade e uma frase de apresentação da lista (no mundo não há texto
862
+ livre além do nome). Dá para criar ainda na lista de espera.
863
+
864
+ **Prédio.** Com a conta liberada e o personagem criado, o prédio sobe sozinho (por WebSocket) e acompanha o escritório
865
+ ao vivo. O cartão **Seu prédio** mostra a conexão, os andares, os agentes, a última remessa e, quando o mundo recusa uma
866
+ remessa ou para o prédio (versão antiga, outro computador, conta suspensa ou banida), o motivo; conta suspensa ou
867
+ banida ganha **Recorrer por e-mail**. Um prédio marcado como "não verificado" (números fora do plausível, em revisão)
868
+ fica fora de placares e destaques e mostra **Contestar por e-mail**. Quando o mundo está em manutenção, o cartão diz, e
869
+ o Busybits tenta de novo sozinho.
870
+
871
+ **Visibilidade.** Ao vivo (andares, contadores e o status de cada personagem) ou **modo discreto** (só aceso ou apagado
872
+ e o número de andares); fechado a visitas; esconder o país; os **tokens** do prédio só em faixas (até 100 mil, 1
873
+ milhão…), nunca o número nem o custo, e dá para desligar; placar e compactações só se você ligar; bater na porta
874
+ (**Avisar quando baterem na porta**) também só se você ligar.
875
+
876
+ **Cidade.** O botão **Mundo**, na barra do topo, troca o escritório pela cidade: anda-se com setas/WASD ou clicando, o
877
+ cartão de cada prédio mostra andares, agentes e estado, e o minimapa fica no canto; pausado ou fora do mundo, o seu
878
+ prédio fica apagado, mas dá para andar pela cidade. No modo demonstração (`?mock=1&world=approved&scene=city`, só
879
+ prédios e pessoas fictícios): [a cidade](docs/screenshots/world-cidade.png) e
880
+ [o cartão de um prédio](docs/screenshots/world-cartao.png).
881
+
882
+ **Visitas.** Perto da porta de um prédio, **Entrar (E)** leva para dentro: o escritório do dono ao vivo, com as salas de
883
+ nomes fictícios e os agentes no status de agora, só para ver (nada de terminal, mensagens ou permissões, e nada do
884
+ trabalho); prédio fechado a visitas só se vê por fora. No seu, você vê "N visitantes agora" (só a contagem, nunca quem).
885
+ No modo demonstração: [a visita](docs/screenshots/world-visita.png) e
886
+ [o painel da visita](docs/screenshots/world-visita-painel.png).
887
+
888
+ **Social.** Na cidade, sem nenhum texto livre: **L** curte o prédio perto da porta, **G** abre a roda de cumprimentos
889
+ (frases prontas, traduzidas para quem lê) e **K** bate na porta de quem aceita; o cartão de cada pessoa tem
890
+ Cumprimentar, Bloquear e Denunciar, e o minimapa leva a um prédio pelo código ("Ir para HB-XXXX") ou a um prédio aceso
891
+ qualquer. Dentro de um prédio, **Curtir** e **Deixar um carimbo** na portaria (um por prédio por dia). Na praça, o
892
+ termômetro da meta da semana da cidade e, quando ela bate, fogos. No escritório, o chip "❤️ N hoje" e o cartão "Enquanto
893
+ você estava fora" com as visitas, os likes e os carimbos deixados na portaria (nunca quem); quem você bloqueou fica em
894
+ **Bloqueados**, com **Desbloquear**. No modo demonstração: [a roda de cumprimentos](docs/screenshots/world-social.png) e
895
+ [a praça com os fogos](docs/screenshots/world-praca.png).
896
+
897
+ **Pausar, sair, excluir.** **Pausar** apaga o prédio na hora e guarda o lote (com 30 dias pausado, ele some do mapa; 30
898
+ dias depois, é retirado). **Sair do mundo** retira o prédio e libera o lote; a conta e o personagem continuam, e voltar
899
+ cria um prédio novo. **Excluir conta** (em **Conta e dados**, com o código que chega por e-mail) tira o prédio e o
900
+ perfil do mundo na hora, apaga a conta, os likes, os bloqueios, as denúncias feitas e os dispositivos do banco em 7 dias
901
+ (e dos backups em até 30) e apaga o `world.json` deste computador. Sem notícias do Busybits por 7 dias, o prédio some do
902
+ mapa e, 30 dias depois, é retirado; um e-mail avisa 3 dias antes (desligável em **Conta e dados**).
903
+
904
+ **Exportar.** **Baixar meus dados** (em **Conta e dados**) salva `habblaud-world-dados.json` com o que o mundo guarda da
905
+ sua conta: e-mail, datas, personagem, visibilidade, dispositivos, prédio, likes dados, bloqueios e denúncias feitas. Uma
906
+ vez por dia.
907
+
908
+ **Dados verdadeiros.** O World só funciona se os prédios forem de verdade: mudar o Busybits para mandar andares,
909
+ agentes, status, tokens ou personagens inventados ou inflados quebra os Termos de Uso e bane a conta (o servidor confere
910
+ a plausibilidade de cada pacote). Mudar o Busybits para qualquer outra coisa continua livre (MIT). Como o Busybits fala
911
+ com o World: [shared/world/README.md](shared/world/README.md).
912
+
913
+ **Testar com um servidor do mundo local.** Para quem desenvolve o World, com o servidor do mundo rodando no próprio
914
+ computador (por exemplo, em Docker, publicado na porta 4848):
915
+
916
+ - Fora do Docker: `HABBLAUD_WORLD_URL=http://127.0.0.1:4848 npm run dev`.
917
+ - Com o Busybits no Docker: no `.env` desta pasta, `HABBLAUD_WORLD_URL=http://host.docker.internal:4848` e
918
+ `HABBLAUD_WORLD_DEV=1`; depois, `npm run docker:up`, que termina com a linha do World
919
+ (`Habblaud World: ligado: http://host.docker.internal:4848`, ou por que ficou desligado). O `docker-compose.yml` já liga
920
+ `host.docker.internal` ao host (`extra_hosts` com `host-gateway`; no Docker Desktop o nome já existe). No Linux, o
921
+ servidor do mundo precisa escutar numa interface que o container alcança (`0.0.0.0` ou o IP da ponte do Docker): uma
922
+ porta publicada só em `127.0.0.1` do host não responde por `host-gateway`.
923
+ - Sem TLS, só com `HABBLAUD_WORLD_DEV=1` (ou `--dev`) e só para `127.0.0.1` e `host.docker.internal`; fora disso, só
924
+ `https://` ou `wss://`. O servidor do mundo precisa aceitar o nome usado na URL como o host do jogo (senão responde
925
+ `421`).
926
+
927
+ Como a seção fica, no modo demonstração (`?mock=1&world=logged_out`, `waiting` ou `approved`):
928
+ [sem conta](docs/screenshots/world-sem-conta.png), [lista de espera](docs/screenshots/world-lista-de-espera.png),
929
+ [personagem](docs/screenshots/world-personagem.png), [Seu prédio](docs/screenshots/world-predio.png) e
930
+ [o que foi enviado](docs/screenshots/world-enviado.png).
931
+
932
+ ## Como funciona
933
+
934
+ ```
935
+ ~/.claude*/sessions/<pid>.json ─────────────────┐
936
+ ~/.claude*/projects/<projeto>/<sessão>.jsonl ───┼──▶ servidor Node ──▶ modelo do escritório ──▶ SSE ──▶ navegador
937
+ .../<sessão>/subagents/**/agent-*.jsonl ────────┘ (polling de 1 s) (canvas + interface)
938
+ ```
939
+
940
+ - **Quem está no escritório:** enquanto uma sessão está aberta, o Claude Code mantém `sessions/<pid>.json` com o
941
+ projeto e o status (ocupado, ocioso, esperando você ou esperando um shell em segundo plano). É isso que decide
942
+ quem aparece e o que cada um faz.
943
+ - **Shells rodando:** nos transcripts, cada `Bash` em segundo plano (ou comando longo em primeiro plano) vira um
944
+ "shell" com rótulo e cronômetro, até chegar a notificação de que terminou, falhou ou foi interrompido.
945
+ - **Vida social:** as rodas, as personalidades e as moedinhas são simulação do navegador (`client/src/world/social/`),
946
+ sem nenhum efeito nos agentes de verdade. A personalidade sai da semente de cada agente (é a mesma em qualquer
947
+ navegador); as carteiras ficam no `localStorage` do navegador.
948
+ - **O que cada um está fazendo:** o servidor acompanha o fim dos transcripts (`.jsonl`) das sessões abertas e traduz
949
+ cada chamada de ferramenta numa atividade em português, com ícone. Dali também saem tarefas, título, modelo e
950
+ estatísticas.
951
+ - **Subagentes:** os transcripts em `<sessão>/subagents/` (inclusive os de workflows) viram personagens ligados ao
952
+ agente que os chamou.
953
+ - **GitHub:** PRs, pushes, CI e releases saem das mesmas linhas do transcript (o comando e a saída dele, ou o
954
+ `gitOperation` que o próprio Claude Code grava); nada é consultado no GitHub.
955
+ - **O desenho:** o navegador recebe o estado por SSE e desenha tudo num canvas — personagens, móveis, pisos e paredes
956
+ são pixel art **gerada por código**; já o logotipo, as ilustrações e os quadros das paredes foram gerados com IA.
957
+
958
+ <details>
959
+ <summary><b>Estrutura do código e API</b></summary>
960
+
961
+ ```
962
+ shared/ protocolo (types.ts), atividades em PT-BR, nomes, simulador de demonstração
963
+ server/ servidor HTTP + SSE: contas e uso, leitura das sessões e transcripts, modelo do escritório
964
+ client/ Vite: src/art (pixel art procedural), src/world (o escritório no canvas), src/ui (interface)
965
+ scripts/ build do servidor, docker-up, instaladores (mod, tap de statusline e hook de permissão) e screenshots
966
+ mod/ o mod do Busybits e os plugins de permissões e de mensagens (plugins do Claude Code; marketplace em .claude-plugin/)
967
+ ```
968
+
969
+ | Rota | Descrição |
970
+ | --- | --- |
971
+ | `GET /api/stream` | SSE com os eventos `snapshot`, `feed` e `notice` (formato em `shared/types.ts`). |
972
+ | `GET /api/snapshot` | Estado atual do escritório. |
973
+ | `GET /api/agents/:id` | Detalhes de um agente, com até 200 atividades. |
974
+ | `GET /api/agents/:id/terminal` | SSE do terminal (eventos `init` e `append`); só com acesso local. |
975
+ | `PUT /api/agents/:id/character` | Editar o personagem: `{name, seed, parts}` grava o nome e a aparência do agente principal como o personagem do projeto (a sala); só com acesso local. |
976
+ | `DELETE /api/agents/:id/character` | "Voltar ao sorteio": apaga o personagem do projeto e o agente volta ao nome sorteado; só com acesso local. |
977
+ | `GET /api/sessions/recent` | Histórico: sessões dos últimos 7 dias de todas as contas (até 150); só com acesso local. |
978
+ | `GET /api/sessions/:conta/:sessionId/terminal` | SSE da conversa de uma sessão do histórico (mesmo protocolo do terminal); só com acesso local. |
979
+ | `GET /api/stats?day=AAAA-MM-DD` | Estatísticas do Meu dia (tempo por status, projetos, contas, horas, esperas, tokens e custo). |
980
+ | `GET /api/stats/days` | Dias com estatísticas (os últimos 30). |
981
+ | `GET /api/timeline/days` | Dias gravados para o timelapse, com tamanho e horário do primeiro e do último registro. |
982
+ | `GET /api/timeline/:dia` | Linha do tempo de um dia (`AAAA-MM-DD`), em JSONL (com gzip). |
983
+ | `GET /api/health` | Saúde: versão, demonstração, Docker, terminal, responder e mandar mensagens pelo escritório, fontes e status de uso de cada conta. |
984
+ | `POST /api/demo` | `{"enabled": true \| false}` liga ou desliga os agentes simulados. |
985
+ | `POST /api/rooms/rename` | `{"id": sala, "name": nome}` renomeia a sala (vazio volta ao nome da pasta); o nome fica em `rooms.json`, na pasta de dados. Só com acesso local. |
986
+ | `GET /api/mod/summary` | Para o mod do Claude Code: versão, quantos agentes, quantos trabalham e quem precisa de você (sem o demo e, com `?account=&session=`, sem a própria sessão). |
987
+ | `/api/permissions…` | Responder pelo escritório: o hook de permissão registra o pedido (permissão ou pergunta) e espera; a página busca o detalhe e decide ou responde. Só com acesso local. |
988
+ | `/api/messages…` e `/api/mod/inbox…` | Mandar mensagens: a página deixa a mensagem na fila e acompanha a entrega; o plugin `busybits-messages` a busca, entrega à sessão e confirma. Só com acesso local. |
989
+ | `POST /api/codex/events` | Eventos dos hooks do Codex (sessão aberta, ferramenta, aprovação, fim do turno). Só com acesso local. |
990
+ | `/api/codex/bridge/poll` e `/ack` | O `npm run codex:bridge` busca as mensagens para o Codex e confirma a entrega. Só com acesso local. |
991
+
992
+ Mais detalhes do servidor em [`server/README.md`](server/README.md).
993
+
994
+ </details>
995
+
996
+ <details>
997
+ <summary><b>O que o Docker monta e por quê</b></summary>
998
+
999
+ | Host | Container | Para quê |
1000
+ | --- | --- | --- |
1001
+ | `<conta>/sessions/` | `/claude/<conta>/sessions` (somente leitura) | Sessões abertas e seus status. |
1002
+ | `<conta>/projects/` | `/claude/<conta>/projects` (somente leitura) | Transcripts das sessões e dos subagentes. |
1003
+ | `~/.habblaud/usage/` | `/usage` (somente leitura) | Uso capturado pelo mod (ou pelo tap de statusline). |
1004
+ | volume `habblaud-data` | `/data` | Dados do próprio Busybits (nomes dos personagens, linha do tempo do timelapse e estatísticas do Meu dia). |
1005
+ | `~/.habblaud/remote-tls/server/` | `/remote-tls` (somente leitura) | Só depois do `npm run remote:setup`: o certificado e a chave do servidor do [celular com login](#celular-com-login-e-https-aprovando-pedidos) (nunca a chave da CA). |
1006
+
1007
+ A pasta da conta **nunca** é montada inteira (lá ficam credenciais e configurações). O container roda como usuário sem
1008
+ privilégios, com sistema de arquivos somente leitura, sem capabilities extras e com `no-new-privileges`. Os metadados
1009
+ das contas (letra, e-mail, organização) são lidos no host pelo `docker:up` e passados ao container.
1010
+
1011
+ </details>
1012
+
1013
+ ## Privacidade e segurança
1014
+
1015
+ - **Só leitura:** o Busybits nunca grava nas pastas do Claude Code. As exceções são os instaladores, que você roda:
1016
+ o `npm run mod:install` / `mod:uninstall` usa o próprio `claude plugin` (que registra o marketplace e os plugins
1017
+ no `settings.json` e em `<conta>/plugins/`) e, na instalação, tira o tap e o hook antigos com backup; no jeito
1018
+ antigo, o `npm run usage:install` / `usage:uninstall` muda só o `statusLine.command` do `settings.json` e o
1019
+ `npm run hooks:install` / `hooks:uninstall`, só a lista `hooks.PermissionRequest` — sempre com backup antes.
1020
+ - **O mod:** roda dentro de cada sessão do Claude Code, com as suas permissões (como todo mod), e faz só o que está
1021
+ listado em [`mod/README.md`](mod/README.md) — `claude plugin validate mod/habblaud` mostra os eventos e as chamadas,
1022
+ sem rodar nada. Grava só os percentuais de uso de 5 horas e da semana (e quando reiniciam) em
1023
+ `~/.habblaud/usage/<conta>.json`; para a linha de "precisa de você" e o `/busybits`, só fala com o Busybits em
1024
+ `127.0.0.1`. Não lê a conversa, não chama o modelo e não envia nada para fora do computador. Ele é lido desta
1025
+ pasta: o que estiver nela (inclusive depois de um `git pull`) é o que roda. O plugin de mensagens
1026
+ (`busybits-messages`) é separado justamente porque age: digita na sessão o que você mandou pelo escritório.
1027
+ - **Só local, por padrão:** o servidor só aceita conexões do próprio computador; liberar a rede local é opcional.
1028
+ Não há telemetria. A única chamada externa é a verificação de versão nova: ligada por padrão em instalações
1029
+ empacotadas (desligada em clone e Docker; `HABBLAUD_UPDATE_CHECK=1` ou `0` muda isso), a cada 6 horas, uma consulta
1030
+ anônima, sem token, ao registro do npm (`registry.npmjs.org/busybits`). Ela não envia nada sobre as suas sessões; o
1031
+ npm vê só o seu IP. Com `HABBLAUD_UPDATE_CHECK=0` (ou num clone sem `=1`), não há consulta.
1032
+ O [Habblaud World](#habblaud-world) (desligado por padrão no Busybits; `HABBLAUD_WORLD=1` liga) só manda algo ao
1033
+ servidor do mundo depois de você criar a conta e entrar, e só o que está em [o que sai](docs/world/privacidade.md).
1034
+ O [celular com login](#celular-com-login-e-https-aprovando-pedidos) também, e ele só existe depois do `npm run remote:setup`.
1035
+ - **Sem credenciais:** o Busybits não lê senhas nem tokens de acesso. Do `.claude.json` de cada conta aproveita só o
1036
+ e-mail, a organização e o cache do `/usage`; o uso ao vivo vem do mod (ou do tap de statusline).
1037
+ - **Segredos mascarados:** tokens e senhas com formato conhecido (`Bearer`, `-u usuário:senha`, `TOKEN=`, chaves
1038
+ `sk-…`, `ghp_…`, `AKIA…`, JWTs, senhas em URLs) viram `***` antes de chegar ao navegador.
1039
+ - **Protegido contra sites maliciosos:** o servidor recusa endereços que não sejam `localhost`/IP (DNS rebinding) e
1040
+ `POST` vindos de outras origens (CSRF), e não deixa a página ser embutida em outros sites.
1041
+ - **Terminal só local:** a conversa completa das sessões (e o histórico das sessões encerradas, com os
1042
+ títulos) só sai do servidor com o Busybits acessível apenas pelo próprio computador (`HABBLAUD_HOST` local no Node;
1043
+ `HABBLAUD_BIND` local no Docker) — não há como
1044
+ ligá-lo com a porta exposta — e cada pedido precisa vir por `localhost`/`127.0.0.1`: IPs da rede e nomes de
1045
+ `HABBLAUD_ALLOWED_HOSTS` (proxies, túneis) são recusados. Segredos são mascarados e textos longos truncados antes
1046
+ de chegar ao navegador; no modo demonstração, a conversa é fictícia. `HABBLAUD_TERMINAL=0` desliga de vez.
1047
+ A única exceção é o [celular com login](#celular-com-login-e-https-aprovando-pedidos), e só com `terminal` no `HABBLAUD_REMOTE_ALLOW`.
1048
+ - **Linha do tempo do timelapse:** só os resumos que já aparecem na tela (atividade em uma linha, status, títulos,
1049
+ uso das contas, sem e-mails, comandos completos ou conversas), gravados em `~/.habblaud/timeline/` e apagados depois
1050
+ de 7 dias. `HABBLAUD_TIMELINE=0` desliga a gravação.
1051
+ - **Responder pelo escritório, só local:** aprovar ou recusar age sobre as sessões, então segue a mesma trava do
1052
+ terminal (bind local, `Host` local, nada de proxies ou túneis) e só existe com o hook de permissão (o do plugin
1053
+ `busybits-permissions` ou o do jeito antigo) instalado por você. As respostas exigem JSON e origem local (um site
1054
+ aberto no navegador não consegue mandá-las), o hook só fala com `127.0.0.1` e, na dúvida — Busybits fora do ar,
1055
+ erro, tempo esgotado —, sai sem decidir: vale o terminal. O comando completo ou o diff só saem do servidor para
1056
+ quem abriu a página pelo próprio computador. "Sempre permitir" só aplica uma regra que o próprio Claude Code sugeriu
1057
+ para aquele pedido. Atenção: qualquer programa ou pessoa que consiga abrir `http://localhost:4747` nesta máquina
1058
+ também consegue responder; em computadores compartilhados com outros usuários, não instale o hook
1059
+ (`npm run mod:install -- --sem-permissoes`).
1060
+ Exceção: o [celular com login](#celular-com-login-e-https-aprovando-pedidos) também responde (é o padrão dele) e vê o mesmo comando ou diff.
1061
+ - **Mandar mensagens, só local — e com um aviso:** a mensagem entra na sessão como se você a tivesse digitado, então
1062
+ vale o que o agente pode fazer com um pedido seu. Segue a mesma trava (bind local, `Host` local, JSON e origem local,
1063
+ então um site aberto no navegador não consegue mandar), mas **qualquer programa desta máquina** que fale com
1064
+ `http://localhost:4747` — inclusive um agente rodando um comando — consegue deixar uma mensagem para outra sessão
1065
+ que tenha o plugin. Se isso não serve para você (computador compartilhado, agentes rodando sem supervisão), não
1066
+ instale o plugin (`npm run mod:install -- --sem-mensagens`) ou desligue com `HABBLAUD_MENSAGENS=0`. O texto das
1067
+ mensagens não é gravado: some do servidor assim que é entregue.
1068
+ Pelo [celular com login](#celular-com-login-e-https-aprovando-pedidos), só com `messages` no `HABBLAUD_REMOTE_ALLOW`.
1069
+ - **Terminal interativo, opt-in — e com um aviso:** com `HABBLAUD_PTY=1`, o escritório abre o Claude Code em
1070
+ qualquer pasta, digita nele (inclusive `!comando`, que roda no shell) e encerra ou assume sessões abertas noutros
1071
+ terminais. Segue a mesma trava do terminal (bind local, `Host` local, nada de proxies ou túneis) e cada pedido
1072
+ precisa vir do próprio computador, com origem local (um site aberto no navegador não consegue mandar). Mesmo assim,
1073
+ **qualquer programa desta máquina** que fale com `http://localhost:4747` — inclusive um agente rodando um comando —
1074
+ ganha esse poder. Antes de encerrar um processo de fora, o Busybits confere no registro de sessões e no sistema que
1075
+ aquele PID ainda é aquele Claude Code (mesmo início e executável). Em computadores compartilhados ou com agentes
1076
+ rodando sem supervisão, deixe desligado.
1077
+ - **Celular com login, opt-in:** só existe depois do `npm run remote:setup`. Uma segunda porta com HTTPS (uma CA local
1078
+ que só assina nomes `.local`, `localhost`, o endereço próprio e IPs privados), usuário e senha (só o hash scrypt fica
1079
+ guardado); a sessão é um cookie `HttpOnly`, `SameSite=Strict` e `Secure` assinado com HMAC. Nessa porta, o que vale
1080
+ vem do `HABBLAUD_REMOTE_ALLOW` (por padrão, só responder pedidos de permissão), nunca do cabeçalho Host; as rotas
1081
+ dos hooks, dos plugins e do auxiliar do host, o terminal interativo, o editor de personagem e renomear salas nunca
1082
+ valem por ela. Quem tem a senha ganha o que você liberou: escolha uma forte e libere só o que precisa. A chave da CA
1083
+ fica em `~/.habblaud/remote-tls/ca` e nunca vai para o container.
1084
+ - **Novo agente, opt-in:** com `HABBLAUD_PTY=1`, o escritório começa sessões do Claude Code com o pedido que você
1085
+ escreveu, na pasta que você escolher — vale o mesmo aviso do terminal interativo. Os anexos são gravados em
1086
+ `~/.habblaud/attachments/` (pasta 700, arquivos 600). No Docker, quem começa as sessões é o auxiliar do host
1087
+ (`npm run codex:bridge`), que também só lê os arquivos das entregas de pastas de projeto conhecidas (as que o Claude
1088
+ Code tem em `<conta>/projects`), da pasta temporária e dos anexos.
1089
+ - **Editor de personagem, só local:** salvar ou voltar ao sorteio muda o escritório e grava em `names.json`, então
1090
+ segue a mesma trava do terminal (bind local, `Host` local, nada de proxies ou túneis): sem ela, o lápis não aparece
1091
+ e o servidor responde `403`. As mudanças exigem JSON e origem local. `HABBLAUD_TERMINAL=0` desliga junto.
1092
+ - **Estatísticas do Meu dia:** só números agregados (tempo por status, contagens, tokens, custo) com nomes de projeto,
1093
+ conta e agente, guardados em `HABBLAUD_DATA_DIR/stats/` por 30 dias — nada da conversa.
1094
+ - **Codex:** o Busybits lê só as conversas (`sessions/`, `archived_sessions/`) e as travas das sessões abertas
1095
+ (`thread-writer-locks/`); no Docker, só essas três pastas são montadas, somente leitura. Nunca lê o `auth.json`, o
1096
+ `config.toml`, o ambiente do shell (`shell_snapshots/`), o histórico de prompts, os logs nem os bancos do Codex, e não
1097
+ mostra os ids da conta ChatGPT. O `npm run codex:install` só acrescenta grupos no `hooks.json` (com backup; os de
1098
+ outros apps ficam no mesmo lugar) e grava `~/.habblaud/codex-hook.json`; a aprovação dos hooks é sempre sua, em
1099
+ `/hooks`. Os hooks só falam com `127.0.0.1`. As mensagens ao Codex têm o mesmo aviso das do Claude Code: qualquer
1100
+ programa desta máquina que fale com o Busybits consegue deixar uma mensagem na fila de uma sessão.
1101
+ - **O que aparece na tela:** resumos das atividades (ferramenta, arquivo, comando ou consulta), títulos das sessões,
1102
+ tarefas e estatísticas (e, no terminal, a conversa). Não exponha a porta em redes em que você não
1103
+ confia.
1104
+
1105
+ ## Desenvolvimento
1106
+
1107
+ | Comando | O que faz |
1108
+ | --- | --- |
1109
+ | `npm run dev` | Servidor + Vite em http://localhost:4747, com recarga automática. |
1110
+ | `npm run dev:client` | Só o Vite, em http://localhost:5173 (abra com `?mock=1`; `/api` é repassado para a porta 4747). |
1111
+ | `npm run demo` | `npm run dev` com o modo demonstração ligado. |
1112
+ | `npm run build` / `npm start` | Compila e roda a versão de produção. |
1113
+ | `npm test` | Testes (Vitest). |
1114
+ | `npm run typecheck` | Verificação de tipos de cliente, servidor e scripts. |
1115
+ | `claude plugin test mod/habblaud` | Testes do mod (sem sessão, conta nem rede); idem para `mod/habblaud-mensagens`. |
1116
+ | `claude plugin validate .` | Valida o marketplace (`.claude-plugin/marketplace.json`); com `mod/habblaud`, `mod/habblaud-permissoes` ou `mod/habblaud-mensagens`, valida o plugin e lista os eventos e as chamadas do mod. |
1117
+ | `claude --plugin-dir mod/habblaud` | Abre uma sessão com o mod desta pasta, sem instalar (edite e rode `/reload-plugins`). |
1118
+ | `npm run mod:status` | Mostra, por conta, o marketplace, os plugins e as versões instaladas. |
1119
+ | `npm run demo:timeline` | Gera uma linha do tempo fictícia (simulador do modo demonstração) para o timelapse. |
1120
+ | `npm run release` | Publica a versão do `package.json` no GitHub (tag e release com as notas do `CHANGELOG.md`). |
1121
+
1122
+ Para tirar screenshots sem abrir o seu navegador, `scripts/shot.mjs` usa um Chromium headless isolado (Playwright).
1123
+ Na primeira vez, baixe o navegador (uma vez só): `npx playwright-core install chromium-headless-shell`.
1124
+
1125
+ ```bash
1126
+ node scripts/shot.mjs 'http://localhost:4747/?mock=1&speed=3' /tmp/habblaud.png --size 1400x900 --wait 4000
1127
+ ```
1128
+
1129
+ No console do navegador, `habblaud.world.debug` tem ferramentas para testar cenas (ex.:
1130
+ `habblaud.world.debug.setHour(21)` para ver a noite). Para fixar a hora já ao abrir, use `?hora=21:30` na URL.
1131
+
1132
+ **Timelapse só com dados fictícios** (ex.: para gravar um GIF): `npm run demo:timeline` roda o simulador do modo
1133
+ demonstração offline e grava um dia inteiro (por padrão, ontem das 9h às 19h, com manhã cheia, almoço mais vazio e
1134
+ pico à tarde) em `<tmp>/habblaud-demo/timeline/`. Depois suba um Busybits que só leia essa pasta e não mostre as suas
1135
+ sessões, e abra o Timelapse:
1136
+
1137
+ ```bash
1138
+ npm run demo:timeline -- --data-dir /tmp/habblaud-demo # opções: --date, --start 8:30, --hours, --sessions, --seed
1139
+ mkdir -p /tmp/habblaud-demo/vazio
1140
+ HABBLAUD_DATA_DIR=/tmp/habblaud-demo HABBLAUD_TIMELINE=0 HABBLAUD_CLAUDE_DIRS=/tmp/habblaud-demo/vazio \
1141
+ HABBLAUD_PORT=4848 npm start # depois de npm run build; abra http://localhost:4848
1142
+ ```
1143
+
1144
+ `HABBLAUD_TIMELINE=0` evita gravar nessa pasta; com a gravação ligada, dias com mais de 7 dias são apagados.
1145
+
1146
+ **Publicar uma versão:** toda versão tem a sua seção no [`CHANGELOG.md`](CHANGELOG.md), com o que entrou. Durante o
1147
+ trabalho, anote as mudanças em "Não lançado". Para lançar:
1148
+
1149
+ 1. Suba o número com `npm version minor --no-git-tag-version` (ou `patch`, numa versão só de correções).
1150
+ 2. Troque "Não lançado" pela versão e a data (`## [0.3.0] - AAAA-MM-DD`), deixe um "Não lançado" vazio em cima e
1151
+ atualize os links do fim. O `npm test` falha se a versão do `package.json` não tiver seção.
1152
+ 3. Faça o merge na `main` e rode `npm run release` (precisa do [`gh`](https://cli.github.com/) autenticado; `-- --dry-run`
1153
+ só mostra as notas). O script cria a tag `v0.3.0` e a release com o texto da seção. A partir daí, quem usa o
1154
+ Busybits vê o selo **Nova versão**.
1155
+
1156
+ ## Solução de problemas
1157
+
1158
+ <details>
1159
+ <summary><b>O escritório está vazio</b></summary>
1160
+
1161
+ Só aparecem sessões **abertas** do Claude Code. Confira se há alguma rodando e se a conta foi detectada em
1162
+ `http://localhost:4747/api/health`. Se as pastas das contas estiverem em outro lugar, use
1163
+ `HABBLAUD_CLAUDE_DIRS=/caminho/conta1,/caminho/conta2`.
1164
+
1165
+ </details>
1166
+
1167
+ <details>
1168
+ <summary><b>O uso aparece como "sem dados" ou "desatualizado"</b></summary>
1169
+
1170
+ Rode `npm run mod:install` (ou, no Claude Code anterior ao 2.1.287, `npm run usage:install`) e confira com
1171
+ `npm run mod:status` (ou `npm run usage:status`). Os números chegam depois da próxima resposta numa sessão aberta
1172
+ daquela conta; numa sessão aberta antes da instalação, rode `/reload-plugins` ou reabra a sessão. Um **—** no lugar
1173
+ do percentual quer dizer que a janela reiniciou desde a última coleta.
1174
+
1175
+ </details>
1176
+
1177
+ <details>
1178
+ <summary><b>O mod não carrega numa sessão</b></summary>
1179
+
1180
+ Rode `npm run mod:status`: ele mostra a versão do Claude Code (o mod precisa da 2.1.287 ou mais nova) e, por conta,
1181
+ se o marketplace aponta para esta pasta e se os plugins estão instalados e ligados. Numa sessão aberta antes da
1182
+ instalação, rode `/reload-plugins`; o `/plugin` mostra, embaixo das abas, os mods carregados (ex.:
1183
+ `1 mod active · habblaud`). Mods não rodam com `"disableAllHooks": true` no `settings.json` da conta nem com
1184
+ `claude --safe-mode`.
1185
+
1186
+ </details>
1187
+
1188
+ <details>
1189
+ <summary><b>"A porta 4747 já está em uso"</b></summary>
1190
+
1191
+ Outro Busybits (Node ou Docker) já está rodando. Pare-o (`npm run docker:down`, ou Ctrl+C no terminal do
1192
+ `npm start`) ou use outra porta: `HABBLAUD_PORT=4848 npm run docker:up` (Docker) ou `HABBLAUD_PORT=4848 npm start`
1193
+ (Node).
1194
+
1195
+ </details>
1196
+
1197
+ <details>
1198
+ <summary><b>Não abre no celular</b></summary>
1199
+
1200
+ Confira se criou o `.env` com `HABBLAUD_BIND=0.0.0.0` e recriou o container (`npm run docker:up -- --no-build`), se
1201
+ o celular está no mesmo Wi-Fi e se o firewall do computador permite conexões na porta 4747. Por IP funciona direto;
1202
+ para abrir por um nome (ex.: `meu-mac.local`), acrescente `HABBLAUD_ALLOWED_HOSTS=meu-mac.local` (no Docker, no mesmo
1203
+ `.env`).
1204
+
1205
+ </details>
1206
+
1207
+ <details>
1208
+ <summary><b>O terminal não abre</b></summary>
1209
+
1210
+ O terminal só existe com o Busybits acessível apenas pelo próprio computador. Confira se o `.env` não tem
1211
+ `HABBLAUD_BIND=0.0.0.0` (ou, no modo Node, se não usou `HABBLAUD_HOST=0.0.0.0`) nem `HABBLAUD_TERMINAL=0`, e abra por
1212
+ `http://localhost:4747` (pelo IP da rede ou por um nome de `HABBLAUD_ALLOWED_HOSTS` ele é recusado). No Docker, um container
1213
+ criado antes desse recurso precisa ser recriado: `npm run docker:up`. O log de inicialização (`npm run docker:logs`)
1214
+ diz se o terminal está ligado e, se não estiver, por quê.
1215
+
1216
+ </details>
1217
+
1218
+ <details>
1219
+ <summary><b>O pedido de permissão (ou a pergunta) não aparece no escritório</b></summary>
1220
+
1221
+ Rode `npm run mod:status`: ele diz, por conta, se o plugin `busybits-permissions` está instalado e ligado (e se
1222
+ sobrou o hook antigo junto, o que faria dois responderem) e se o Busybits está respondendo pedidos. No jeito antigo,
1223
+ `npm run hooks:status` diz se o hook está instalado e apontando para esta pasta. O pedido só é desviado com alguma
1224
+ página do Busybits aberta por `http://localhost` (ou `127.0.0.1`) e com o terminal ligado (mesma trava). Sessões
1225
+ abertas antes da instalação carregam o plugin com `/reload-plugins` (ou ao reabrir). No jeito antigo, se o Busybits
1226
+ usa outra porta, reinstale com `npm run hooks:install -- --port <porta>`. Para as perguntas do agente, o plugin
1227
+ precisa ser o da 0.6.0 ou mais novo: rode `npm run mod:install` depois de atualizar.
1228
+
1229
+ </details>
1230
+
1231
+ <details>
1232
+ <summary><b>O Codex não aparece no escritório (ou aparece com atraso)</b></summary>
1233
+
1234
+ O log de inicialização (`npm run docker:logs`) diz quantas contas do Codex o Busybits achou; se for nenhuma, aponte a
1235
+ pasta com `HABBLAUD_CODEX_DIRS` (e rode `npm run docker:up` de novo: no Docker, só as pastas que existiam no
1236
+ `docker:up` são montadas). Sem os hooks, o Codex aparece pelos arquivos dele, que só são gravados depois de cada passo:
1237
+ rode `npm run codex:install`, **aprove os hooks em `/hooks` no Codex** e confira com `npm run codex:status`. O Codex roda
1238
+ os hooks pelo shell de login, que pode ter um Node antigo; o `codex:install` escolhe um Node 22+ e diz qual (ou use
1239
+ `--node <caminho>`). Uma sessão da CLI recém-aberta só aparece com a **primeira mensagem**: antes disso o Codex não
1240
+ diz em que pasta ela está (só cria a trava da sessão), e sem a pasta não há sala.
1241
+
1242
+ </details>
1243
+
1244
+ <details>
1245
+ <summary><b>A caixa de mensagem não aparece (ou fica na fila)</b></summary>
1246
+
1247
+ A caixa só aparece para agentes principais cuja sessão tem o plugin `busybits-messages` conectado: rode
1248
+ `npm run mod:status` (diz, por conta, se o plugin está instalado e se o Busybits está com as mensagens ligadas) e, nas
1249
+ sessões abertas antes da instalação, `/reload-plugins`. Sem o plugin, os detalhes do agente mostram a dica de
1250
+ instalação. As mensagens seguem a trava do terminal e `HABBLAUD_MENSAGENS=0` as desliga; o log de inicialização
1251
+ (`npm run docker:logs`) diz se estão ligadas e, se não estiverem, por quê. Uma mensagem que fica **na fila** e falha
1252
+ com "a sessão não buscou a mensagem" quer dizer que a sessão parou de perguntar ao Busybits (fechou, ou o plugin foi
1253
+ desligado).
1254
+
1255
+ </details>
1256
+
1257
+ <details>
1258
+ <summary><b>No Docker, uma sessão fechada continua no escritório</b></summary>
1259
+
1260
+ Acontece se o Claude Code foi encerrado à força sem apagar o próprio registro em `sessions/` (no Docker não dá para
1261
+ conferir se o processo ainda existe). Rodando com Node (`npm start`), o Busybits confere os processos e isso não
1262
+ acontece.
1263
+
1264
+ </details>
1265
+
1266
+ <details>
1267
+ <summary><b>No Docker, uma conta fora de /Users não aparece</b></summary>
1268
+
1269
+ O Docker Desktop só compartilha algumas pastas do Mac com os containers (por padrão `/Users`, `/Volumes`, `/private` e
1270
+ `/tmp`). Adicione a pasta em *Settings › Resources › File sharing*.
1271
+
1272
+ </details>
1273
+
1274
+ <details>
1275
+ <summary><b>Quero começar do zero</b></summary>
1276
+
1277
+ `npm run docker:down`, depois `docker volume rm habblaud_habblaud-data` (apaga os nomes guardados) e
1278
+ `npm run docker:up`.
1279
+
1280
+ </details>
1281
+
1282
+ ## Aviso
1283
+
1284
+ O Busybits é um projeto independente, **não afiliado, patrocinado nem endossado pela Anthropic**. "Claude" e
1285
+ "Claude Code" são marcas da Anthropic, usadas aqui só para descrever com o que o projeto funciona.
1286
+
1287
+ Para mostrar os agentes, o Busybits lê apenas arquivos locais que o próprio Claude Code grava na sua máquina
1288
+ (registros das sessões abertas, transcripts e configurações das contas). Esse formato não é documentado e pode mudar entre versões do Claude Code:
1289
+ depois de uma atualização, o Busybits pode deixar de funcionar, total ou parcialmente, até ser ajustado.
1290
+
1291
+ ## Licença
1292
+
1293
+ [MIT](LICENSE). As imagens em `client/public/assets` (logotipo, ilustrações, quadros e pôsteres) foram geradas com
1294
+ IA para este projeto e convertidas em pixel art pelos scripts de `scripts/assets/`.
1295
+
1296
+ ## Vida social
1297
+
1298
+ Quando dois ou mais agentes estão à toa — ociosos, ou esperando um shell há mais de 40 segundos —, eles param de
1299
+ passear sozinhos e se juntam. Ninguém combina nada: cada personagem tem uma **personalidade**, **amigos** e
1300
+ **rivais**, e isso decide o que ele prefere fazer, com quem e o que fala. Quem está esperando um shell só sai da mesa
1301
+ para uma roda (sozinho, continua na pipoca) e leva a ampulheta junto; quando o comando termina — ou quando você manda
1302
+ um pedido novo para alguém —, ele avisa a turma ("Opa, me chamaram! 🏃") e corre de volta para a mesa.
1303
+
1304
+ <p align="center">
1305
+ <img src="docs/screenshots/social-lounge.gif" width="816" alt="Lounge do Busybits com três rodas ao mesmo tempo: três colegas no sofá vendo futebol na TV (a tela pisca GOL), uma partida de pingue-pongue com torcida e um duelo nos fliperamas com provocações nos balões" />
1306
+ </p>
1307
+
1308
+ ### As rodas
1309
+
1310
+ | | Roda | O que acontece |
1311
+ | --- | --- | --- |
1312
+ | 📺 | **TV no lounge** | Futebol, novela ou desenho, com pipoca no sofá. No futebol a torcida comemora junto com o "GOL" que pisca na tela (ou lamenta o gol do adversário); na novela, coraçõezinhos e "Não acredito! 😱". Quem é de sonecas acaba dormindo no sofá. |
1313
+ | 🎮 | **Videogame** | Dois no sofá com o controle, a TV em tela dividida (corrida ou luta), melhor de 3, provocações ("Que lag é esse?!") e torcida. |
1314
+ | 👾 | **Fliperama** | Duelo nas duas máquinas do lounge, uma partida só. |
1315
+ | 🏓 | **Pingue-pongue** | Até 5 pontos, com a bolinha indo e voltando, placar nos balões ("3 × 2 🏓") e torcida atrás da mesa. |
1316
+ | ☕ | **Papo na copa** | Cada um pega um café (ou água) e senta à mesa: fofoca com o nome dos colegas ("Viram o commit de Rafaela? 👀"), piada (a roda gargalha), trabalho ("Deploy na sexta? 😈") e assuntos do dia e da hora ("Sextou! 🎉"). |
1317
+ | 💬 | **Conversa** | Dois colegas em pé num canto da recepção, da copa ou do lounge. |
1318
+ | ✊ | **Jokenpô valendo** | "Jo… ken… pô!", os gestos aparecem sobre a cabeça, quem ganha comemora e as moedinhas voam de um para o outro; quem perde fica chateado e, se for competitivo, pede revanche. Empate repete. Quem está passando pode parar para assistir. |
1319
+ | 💄 | **Espelho do banheiro** | Batom ou pente, com o rosto refletido no espelho e um brilho no final. Vale sozinho ou em dupla ("Empresta o pente?"). |
1320
+
1321
+ <table>
1322
+ <tr>
1323
+ <td width="50%"><img src="docs/screenshots/social-rps.png" alt="Jokenpô na recepção: Lia comemora com uma moeda sobre a cabeça e o balão 'Ganhei!', moedinhas voam de Bruna (chateada, com o ícone de pedra) para ela, '+20' e '−20' flutuando, e Iara assiste atrás" /></td>
1324
+ <td width="50%"><img src="docs/screenshots/social-kitchen.png" alt="Papo na copa: quatro colegas sentados à mesa comprida com café, com os balões 'Vai dar certo!' e 'Hahaha'" /></td>
1325
+ </tr>
1326
+ <tr>
1327
+ <td><b>Jokenpô valendo moedinhas.</b> A aposta sai da personalidade (quem é de apostas aposta alto, quem é pão-duro aposta pouco) e nunca passa do saldo de quem tem menos.</td>
1328
+ <td><b>Papo na copa.</b> Quem fala mais é quem é mais sociável; as reações dependem do assunto (gargalhada na piada, 👀 na fofoca).</td>
1329
+ </tr>
1330
+ <tr>
1331
+ <td><img src="docs/screenshots/social-mirror.png" alt="Duas colegas diante das pias do banheiro se arrumando, com os rostos refletidos nos espelhos e o balão 'Tá arrasando!'" /></td>
1332
+ <td><img src="docs/screenshots/social-drawer.png" alt="Seção Vida social nos detalhes do agente: 'Vendo novela na TV com Bruna e Iara', 115 moedinhas, 1 vitória e 0 derrotas, os traços Vaidade e Economia, o bordão, amizades, rivalidades com o placar e o extrato" /></td>
1333
+ </tr>
1334
+ <tr>
1335
+ <td><b>No espelho.</b> Quem é de vaidade passa no banheiro sempre que pode — e aparece refletido.</td>
1336
+ <td><b>Nos detalhes do agente.</b> O que está fazendo, a carteira, o placar, a personalidade, amizades e rivalidades (com o retrospecto) e o extrato.</td>
1337
+ </tr>
1338
+ </table>
1339
+
1340
+ ### Personalidades
1341
+
1342
+ Cada agente tem 2 ou 3 traços, sorteados pela semente dele (é sempre a mesma pessoa, em qualquer navegador):
1343
+
1344
+ 🏆 Competição · 🎲 Apostas · 🎮 Games · 📺 Séries e TV · 🗣️ Fofoca · 💄 Vaidade · ☕ Cafeína · 😂 Piadas · 🏓 Esporte ·
1345
+ 🙈 Timidez · 💰 Economia · 😴 Sonecas · 🧘 Calma · 📚 Leitura
1346
+
1347
+ Os traços mudam o que cada um escolhe (quem é de séries liga a TV, quem é de esporte chama para o ping-pong), quem
1348
+ chama (amigos se procuram; rivais se desafiam nos jogos), o que fala e até quem joga melhor. Cada um também tem um
1349
+ bordão ("Tá pago!", "Bora codar!"). Passe o mouse sobre um traço nos detalhes do agente para ver o que ele faz.
1350
+
1351
+ ### Moedinhas
1352
+
1353
+ Moedinhas fictícias (🪙), só para dar graça às apostas:
1354
+
1355
+ | | |
1356
+ | --- | --- |
1357
+ | **Chegou ao escritório** | 🪙100 (subagentes, 🪙30) |
1358
+ | **Tarefa concluída** (item da lista de tarefas) | +🪙10 |
1359
+ | **Pedido atendido** (fim de turno) | +🪙5 |
1360
+ | **Subagente entregou o resultado** | +🪙15 |
1361
+ | **Apostas** (jokenpô; partidas entre rivais ou com quem é de apostas) | o que perder vai para quem ganhar |
1362
+
1363
+ Cada ganho aparece como "+🪙10" sobre a cabeça; as partidas e apostas entram no feed de atividade. O saldo, o placar
1364
+ e o extrato ficam salvos no navegador (cada navegador tem a sua economia: as apostas são sorteadas ali) e são
1365
+ esquecidos três dias depois de o agente sair.
1366
+
1367
+ > Tudo isso é encenação do Busybits: nada muda nos agentes do Claude Code, que continuam trabalhando normalmente.
1368
+
1369
+ ---
1370
+
1371
+ <p align="center">
1372
+ Feito com ☕ e muitos agentes do <a href="https://code.claude.com">Claude Code</a>.
1373
+ </p>