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.
- package/.claude-plugin/marketplace.json +26 -0
- package/CHANGELOG.md +675 -0
- package/LICENSE +21 -0
- package/README.es.md +1457 -0
- package/README.fr.md +1435 -0
- package/README.md +1605 -2
- package/README.pt-BR.md +1373 -0
- package/dist/build.json +5 -0
- package/dist/cli/busybits.js +14708 -0
- package/dist/client/assets/art/framed/painting-abstract.png +0 -0
- package/dist/client/assets/art/framed/painting-beach.png +0 -0
- package/dist/client/assets/art/framed/painting-cat.png +0 -0
- package/dist/client/assets/art/framed/painting-city-night.png +0 -0
- package/dist/client/assets/art/framed/painting-mountains.png +0 -0
- package/dist/client/assets/art/framed/painting-rio.png +0 -0
- package/dist/client/assets/art/framed/painting-sunflowers.png +0 -0
- package/dist/client/assets/art/framed/painting-wave.png +0 -0
- package/dist/client/assets/art/framed/painting-wide-aurora.png +0 -0
- package/dist/client/assets/art/framed/painting-wide-color-fields.png +0 -0
- package/dist/client/assets/art/framed/painting-wide-forest-lake.png +0 -0
- package/dist/client/assets/art/painting-abstract.png +0 -0
- package/dist/client/assets/art/painting-beach.png +0 -0
- package/dist/client/assets/art/painting-cat.png +0 -0
- package/dist/client/assets/art/painting-city-night.png +0 -0
- package/dist/client/assets/art/painting-mountains.png +0 -0
- package/dist/client/assets/art/painting-rio.png +0 -0
- package/dist/client/assets/art/painting-sunflowers.png +0 -0
- package/dist/client/assets/art/painting-wave.png +0 -0
- package/dist/client/assets/art/painting-wide-aurora.png +0 -0
- package/dist/client/assets/art/painting-wide-color-fields.png +0 -0
- package/dist/client/assets/art/painting-wide-forest-lake.png +0 -0
- package/dist/client/assets/art/poster-bug.png +0 -0
- package/dist/client/assets/art/poster-cat.png +0 -0
- package/dist/client/assets/art/poster-code.png +0 -0
- package/dist/client/assets/art/poster-coffee.png +0 -0
- package/dist/client/assets/art/poster-rocket.png +0 -0
- package/dist/client/assets/art/poster-ship-it.png +0 -0
- package/dist/client/assets/brand/apple-touch-icon.png +0 -0
- package/dist/client/assets/brand/favicon-16.png +0 -0
- package/dist/client/assets/brand/favicon-32.png +0 -0
- package/dist/client/assets/brand/icon-192.png +0 -0
- package/dist/client/assets/brand/icon-512.png +0 -0
- package/dist/client/assets/brand/logo-detailed.png +0 -0
- package/dist/client/assets/brand/logo-mark.png +0 -0
- package/dist/client/assets/brand/logo-mark@4x.png +0 -0
- package/dist/client/assets/brand/signage.png +0 -0
- package/dist/client/assets/brand/signage@4x.png +0 -0
- package/dist/client/assets/emoji/LICENSE-SerenityOS.txt +28 -0
- package/dist/client/assets/emoji/sheet.png +0 -0
- package/dist/client/assets/illustrations/empty-office.png +0 -0
- package/dist/client/assets/manifest.json +260 -0
- package/dist/client/assets/og-image.png +0 -0
- package/dist/client/bundle/app-AwZeKIeu.js +24 -0
- package/dist/client/bundle/app-CoDOLwxe.css +1 -0
- package/dist/client/bundle/city-DPTwQLdi.css +1 -0
- package/dist/client/bundle/city-YoIG0FsX.js +1 -0
- package/dist/client/bundle/daystats-DGzYOP8l.js +1 -0
- package/dist/client/bundle/dom-D2vx0KTo.js +1 -0
- package/dist/client/bundle/en-DBfNt5uV.js +169 -0
- package/dist/client/bundle/es-pnWdszTE.js +169 -0
- package/dist/client/bundle/format-C7qb6Cn-.js +1 -0
- package/dist/client/bundle/fr-CY8q9pj4.js +169 -0
- package/dist/client/bundle/main-DktU0GfB.js +2 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-Ckz2YJkH.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-400-normal-DfOZNMlW.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-500-normal--wrb4dVK.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-500-normal-CR9SIKMr.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-B3EuUOZG.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-600-normal-BhqNJYOZ.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-BrZTw8tu.woff +0 -0
- package/dist/client/bundle/pixelify-sans-cyrillic-700-normal-CYtG5Rfp.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-400-normal-DLrIX9QE.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-400-normal-JapMNN6Z.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-500-normal-Bq6pAlou.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-500-normal-DC052d-m.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-600-normal-BNlgYbDL.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-600-normal-Dd_Dy7u5.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-700-normal-BctWAS0u.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-700-normal-D3Xxx3QE.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-BkfTUL4s.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-400-normal-DdH6zlBQ.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-BHT4w5qI.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-500-normal-Bkr-oq6R.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-CDaIumwU.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-600-normal-Dha6RiOG.woff2 +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-BadXkHzZ.woff +0 -0
- package/dist/client/bundle/pixelify-sans-latin-ext-700-normal-ClyJstAh.woff2 +0 -0
- package/dist/client/bundle/ptypane-BrP-ENHg.css +1 -0
- package/dist/client/bundle/ptypane-NIZ2Y8QM.js +16 -0
- package/dist/client/bundle/room-name-CFJfHE5L.js +1 -0
- package/dist/client/bundle/simulator-BnBPS_Ws.js +7 -0
- package/dist/client/bundle/world-model-BIYmgAWC.js +1 -0
- package/dist/client/bundle/world-stream-BRkL9Eme.js +1 -0
- package/dist/client/index.html +41 -0
- package/dist/client/manifest.webmanifest +17 -0
- package/dist/server/index.js +40327 -0
- package/mod/README.md +193 -0
- package/mod/habblaud/.claude-plugin/plugin.json +11 -0
- package/mod/habblaud/hooks/hooks.json +4 -0
- package/mod/habblaud/hooks/register.ts +517 -0
- package/mod/habblaud-codex/hook.mjs +274 -0
- package/mod/habblaud-mensagens/.claude-plugin/plugin.json +11 -0
- package/mod/habblaud-mensagens/hooks/hooks.json +4 -0
- package/mod/habblaud-mensagens/hooks/register.ts +384 -0
- package/mod/habblaud-permissoes/.claude-plugin/plugin.json +11 -0
- package/mod/habblaud-permissoes/hooks/hooks.json +18 -0
- package/mod/habblaud-permissoes/hooks/permission-hook.mjs +265 -0
- package/mod/habblaud-pi/core.ts +325 -0
- package/mod/habblaud-pi/extension.ts +119 -0
- package/mod/habblaud-pi/package.json +12 -0
- package/package.json +96 -4
package/README.pt-BR.md
ADDED
|
@@ -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
|
+

|
|
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
|
+
|  |  |  |  |
|
|
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>
|