Documentação

Tudo o que você precisa para colocar o Miblo para funcionar e tirar o máximo dele.

Começando

O Miblo funciona com o Claude Code no seu computador: no terminal (claude), na aba Code do app desktop do Claude e nas extensões de VS Code, Cursor e JetBrains. Funciona no macOS, no Linux e no Windows, inclusive WSL.

Ligue o Miblo numa fonte USB de 5 V / 1 A. A tela mostra um QR code e o nome de rede Miblo-Setup-XXXX.
Escaneie o QR code com o celular (ou entre nessa rede). A página de configuração abre sozinha.
Escolha a sua rede Wi-Fi e digite a senha. Ela precisa ser de 2,4 GHz, com WPA2, e a mesma do seu computador.
Quando conectar, a tela mostra “Wi-Fi conectado”, um código de 4 dígitos e o IP do Miblo.
No computador, rode o instalador (abaixo). Ele instala o plugin e pareia o Miblo.

macOS ou Linux (Terminal)

curl -fsSL https://miblo.ai/dl/install.sh | sh

Windows (PowerShell)

irm https://miblo.ai/dl/install.ps1 | iex

Quando o instalador disser que o Miblo foi pareado, abra o Claude Code. Se ele já estava aberto, reinicie. As sessões começam a aparecer na próxima atividade.

O Miblo precisa do Node.js 20 ou mais novo, e você não precisa instalar nada: ele usa o Node que você já tem ou baixa a versão oficial uma vez, conferida por SHA-256.

Pareamento

Parear liga um computador a um Miblo. O instalador já faz isso: ele procura o Miblo na rede (se houver vários, você escolhe pelo número) e pede o código de 4 dígitos da tela.

Para parear à mão, rode /miblo:pair no Claude Code. Se a busca não achar o Miblo, passe o IP que aparece no rodapé da tela: /miblo:pair 192.168.0.42.
O /miblo:pair também pergunta como chamar o Miblo (até 20 caracteres) e se ele pode saber seu primeiro nome e seu aniversário, para dar bom-dia.
Para ver os limites de uso, permita a ligação com a status line (o /miblo:pair pergunta; depois do instalador, rode /miblo:link-statusline). A sua status line continua exatamente igual, e /miblo:unlink-statusline desfaz.
Um Miblo aceita até 4 computadores, e um computador pode parear com vários Miblos.
Cinco códigos errados seguidos travam o pareamento por 60 segundos, e o tempo dobra a cada nova série de erros.

A página de ajustes abre em http://miblo.local, de qualquer celular ou computador na mesma rede, ou com /miblo:settings. Mudar um ajuste pede o código mostrado na tela, a prova de que é você quem está na frente dele.

Comandos

Todos os comandos rodam dentro do Claude Code. Com um só Miblo pareado, o id é opcional; o /miblo:status mostra os ids. Os comandos do dia a dia vão para todos os Miblos pareados; use --id <id> para mandar a um só.

/miblo:pair[ip]: Acha o Miblo na rede, pede o código da tela e pareia. Depois pergunta o nome e oferece ligar a status line.
/miblo:status: Mostra o bridge, a status line, cada Miblo pareado, as sessões ativas, os limites e o resumo do dia.
/miblo:modeoverview | limits | sessions: Escolhe o modo de tela.
/miblo:rotateon | off: Na visão geral, alterna para a tela de limites de tempos em tempos.
/miblo:focus[foco [pausa [rodadas]]] | stop: Começa um foco (Pomodoro): 25 minutos de foco e 5 de pausa, 4 rodadas por padrão.
/miblo:meeting[minutos] | off: Modo reunião: nenhum nome de projeto, comando ou ferramenta na tela.
/miblo:say<texto> | off: Um recado para quem passa pela sua mesa, por 30 minutos ou o tempo que você quiser.
/miblo:remind<minutos | HH:MM> <texto>: Lembretes e alarmes diários ou de dias úteis.
/miblo:timer<minutos> | stop: Uma contagem regressiva grande na tela.
/miblo:countdown<rótulo> <DD/MM> | off: Contagem de dias até uma data, na mesa e na plaquinha do pet.
/miblo:limits: Os limites de 5 horas e da semana, quando zeram e a previsão de quando acabam.
/miblo:today: O resumo do dia no terminal: respostas, tempo, custo e limites.
/miblo:blue[on | off] [HH:MM HH:MM] [força%]: Filtro de luz azul, sempre ou num horário, de 1% a 100%.
/miblo:nighton | off [HH:MM HH:MM] [brilho%]: Diminui o brilho entre duas horas.
/miblo:find: Faz o Miblo piscar e acenar com o QR code da página de ajustes, para achar um entre vários.
/miblo:demo[minutos | stop]: Com dois ou mais Miblos, põe todos no modo pet agora para ver as visitas.
/miblo:rename[id] [nome]: Dá um nome ao Miblo (até 20 caracteres).
/miblo:owner--name <nome> --birthday <DD/MM>: Conta ao Miblo seu primeiro nome e seu aniversário. Os dois ficam só no aparelho.
/miblo:settings[id]: Abre a página de ajustes no navegador.
/miblo:update[id]: Atualiza o plugin e depois o firmware de cada Miblo, com o código da tela.
/miblo:link-statusline: Liga a status line do Claude Code ao Miblo, para os limites aparecerem.
/miblo:unlink-statusline: Devolve a sua status line original. Rode antes de desinstalar o plugin.
/miblo:reset<id>: Restaura o Miblo de fábrica: apaga Wi-Fi, pareamentos e ajustes. Pede confirmação.

Solução de problemas

O que acontece	O que fazer
O instalador ou o /miblo:pair não acha o Miblo	Confira se a tela mostra um código de pareamento e se o Miblo está na mesma rede do computador. VPNs, WSL2 e redes corporativas costumam bloquear a busca: digite o IP que aparece na tela quando o instalador pedir, ou rode /miblo:pair <ip>.
A tela diz “Senha errada”	Escaneie o QR code de novo e digite a senha outra vez.
A tela diz “Rede não encontrada”	O Miblo só enxerga redes de 2,4 GHz. Ligue a banda de 2,4 GHz no roteador ou crie uma rede só para ela, e chegue mais perto do roteador.
A tela diz “Conexão recusada”	Confira a senha. Se o roteador estiver em WPA3 ou no modo misto WPA2/WPA3, mude para WPA2.
Não aparecem limites	Rode /miblo:status para ver se a status line está ligada; se não estiver, rode /miblo:link-statusline. Os limites aparecem depois da próxima resposta e só existem nos planos Pro e Max.
O Miblo diz “Desconectado”	Ele não recebe nada há 30 segundos. O bridge volta na próxima atividade do Claude Code; confira com /miblo:status.
Um Miblo aparece como não autorizado	Ele foi restaurado ou pareado com outra coisa. Rode /miblo:pair de novo.
Nada chega pelo app desktop ou pela IDE	Rode /miblo:update ali: ele confere o Node.js primeiro e diz o que falta.
Status line em branco depois de desinstalar	Reinstale o plugin, rode /miblo:unlink-statusline e desinstale de novo. Da próxima vez, rode o unlink antes.

Para restaurar de fábrica sem computador, ligue o Miblo 6 vezes seguidas, rapidamente. Uma contagem na tela deixa você cancelar.