Bromure Sidecar para Windows

O Bromure Sidecar transforma um PC Windows numa máquina nativa para o Bromure Agentic Coding. As máquinas do seu Mac são VMs Linux. Uma máquina Sidecar é um PC Windows verdadeiro, que executa agentes de programação — Claude Code, Codex, Grok Build, Kimi Code, Oh My Pi — diretamente no Windows, na sua própria conta do Windows.

Assim que o PC tem sessão iniciada na mesma conta bromure.io que o seu Mac e está associado a ele, aparece no Bromure Agentic Coding como mais uma máquina. As suas sessões aparecem no Mac ao lado das que correm em VMs: pode iniciá-las a partir do Mac, acompanhá-las, conversar com elas e delegar-lhes trabalho. Também pode iniciar sessões no próprio PC, a partir do ícone do Sidecar na área de notificação.

O PC e o Mac comunicam ponto a ponto através do bromure.io. O PC só faz ligações de saída, por isso não há portas a reencaminhar, nem VPN, nem endereços a escrever.

Nota: Como os agentes de um Sidecar correm diretamente no PC, não passam pela fronteira de rede de uma máquina. O Squelch, a injeção de credenciais, o rastreio e a política de sandbox são funcionalidades das máquinas (as VMs Linux) e não se aplicam a uma máquina nativa. Um agente Sidecar tem os acessos da sua conta do Windows; escolha o nível de aprovação em conformidade (consulte Níveis de aprovação).

Este capítulo cobre a instalação do Sidecar, o início de sessão e a associação, a instalação de agentes, as sessões, as definições, as atualizações, a desinstalação, a linha de comandos e a resolução de problemas. Para o lado do Mac do acesso remoto, consulte Acesso remoto e clientes.

Requisitos

WindowsWindows 10 versão 1809 ou posterior, ou Windows 11. 64 bits, em Intel/AMD (x64) ou ARM (ARM64).
Git for WindowsObrigatório: os agentes e os comandos do Bromure Agentic Coding correm no Git Bash. O instalador oferece-se para o instalar se faltar.
Microsoft Edge WebView2 RuntimeObrigatório para a janela do Sidecar. Vem incluído no Windows 11; o instalador oferece-o se faltar.
Uma contaUma conta bromure.io — aquela em que o Bromure Agentic Coding do seu Mac tem sessão iniciada.
Direitos de administradorNão são necessários. Tudo é instalado na sua própria conta.

No Windows 11 versão 22H2 e posteriores, as janelas do Sidecar usam o estilo translúcido do Windows 11; nas versões mais antigas têm um aspeto simples, mas funcionam da mesma forma.

Instalação

Transfira o instalador para o seu PC:

PCTransferência
Intel ou AMD (a maioria dos PCs)BromureSidecar-x64.exe
ARM (por exemplo, portáteis Snapdragon)BromureSidecar-arm64.exe

Estas ligações apontam sempre para a versão mais recente. Não sabe qual precisa? Abra Definições → Sistema → Acerca de e veja Tipo de sistema: "processador baseado em x64" significa x64, "processador baseado em ARM" significa ARM64. O instalador ARM64 recusa-se a correr num PC x64 e di-lo.

Execute o instalador. Está assinado pela Seclio LLC, por isso o Windows mostra esse editor. Depois:

  1. Se faltar o Git for Windows ou o WebView2 Runtime, o instalador apresenta-os como componentes. Deixe-os assinalados para os instalar também: o Git vem do winget, e o WebView2 da Microsoft. Quando ambos já existem, esta página é ignorada.
  2. O instalador copia o Bromure Sidecar para %LOCALAPPDATA%\Programs\Bromure Sidecar.
  3. Na última página, deixe Start Bromure Sidecar assinalado.

O instalador também:

  • adiciona um atalho Bromure Sidecar ao menu Iniciar;
  • faz o Sidecar arrancar quando inicia sessão no Windows;
  • regista o tipo de ligação bromure-agent-host:// que o bromure.io usa para devolver o início de sessão ao PC;
  • adiciona uma entrada em Definições → Aplicações → Aplicações instaladas, para a desinstalação.

O ícone na área de notificação e o painel

O Bromure Sidecar vive na área de notificação da barra de tarefas. Se não vir o ícone, clique na seta ^; pode arrastar o ícone para a barra de tarefas para o manter visível.

O ícone mostra o estado num relance:

ÍconeSignificado
CinzentoO Sidecar não está a correr, ou o PC não está associado a nenhum Bromure Agentic Coding.
ColoridoAssociado. Passe o cursor por cima para ver o nome do Mac a que está associado.
Com um pontoUm agente precisa de si: está à espera de uma resposta ou de uma aprovação.

Um clique esquerdo no ícone abre o painel do Sidecar. Clique noutro sítio, ou prima Esc, para o fechar. Um clique direito abre um menu com Open Bromure Sidecar, Coding Agents… e Quit Bromure Sidecar.

O painel mostra, de cima para baixo:

  • O cabeçalho: "Bromure Sidecar" e uma linha de estado, como "Not signed in to bromure.io", "Signed in as nome-do-pc" ou "Attached to Mac as nome-do-pc". Os seus dois botões abrem Coding agents e Settings.
  • Faixas, quando se aplicam: "Git for Windows is needed", com um botão Install, ou "Bromure Sidecar versão is available", com um botão Update.
  • O cartão de ligação: iniciar sessão, ou associar a um Mac.
  • Sessions: os agentes que correm neste PC.
  • O rodapé: Coding Agents e Quit.

Iniciar sessão no bromure.io

O cartão de ligação do painel mostra Reach this PC from Bromure AC.

  1. Clique em Sign in to bromure.io. O navegador abre a página de início de sessão do bromure.io.
  2. Inicie sessão com a conta que o seu Mac usa e aprove a adição deste PC.
  3. O bromure.io devolve o início de sessão ao Sidecar através de uma ligação bromure-agent-host://; o navegador pode perguntar se deve abrir o Bromure Sidecar. Permita.

A linha de estado muda para "Signing in…" e depois para "Signed in as nome-do-pc".

Se o navegador não conseguir abrir o Sidecar (por exemplo, porque concluiu o início de sessão noutro computador), copie a ligação bromure-agent-host:// da página e clique em Paste link no painel.

Segurança: O Sidecar só aceita o início de sessão que ele próprio iniciou. Uma ligação bromure-agent-host:// tem de trazer o código do início de sessão que começou com Sign in to bromure.io, quer chegue do navegador quer seja colada; tudo o resto é recusado com "that sign-in link wasn't started here — sign in again from the menu". Isto impede que uma página web ou uma mensagem meta este PC na conta de outra pessoa. Se vir essa mensagem, clique de novo em Sign in to bromure.io e conclua esse início de sessão.

O nome da máquina é o nome com que o Bromure Agentic Coding lista este PC. Por predefinição, é o nome do computador seguido de -native; pode alterá-lo nas definições.

Associar ao Bromure Agentic Coding

Com a sessão iniciada, o cartão de ligação lista os servidores da sua conta: os Macs cujo Bromure Agentic Coding está online, cada um com Online ou Offline e um botão Attach. Se não aparecer nenhum, "No Bromure AC server is online in your account": abra o Bromure Agentic Coding no seu Mac (com sessão iniciada na mesma conta e o acesso remoto através do bromure.io ligado — consulte Acesso remoto e clientes).

Clique em Attach junto ao seu Mac:

  1. O cartão mostra Connecting.
  2. Da primeira vez, mostra Waiting for approval: "Allow this PC in Bromure AC's fleet dialog on Mac." No Mac, aprove o PC quando o Bromure Agentic Coding o pedir.
  3. O cartão mostra Attached, e o ícone na área de notificação passa de cinzento a colorido.

O PC aparece agora entre as máquinas do Mac, em Native Machines. A associação sobrevive aos reinícios: o Sidecar volta a ligar-se sozinho da próxima vez que arrancar. Clique em Detach para parar; o Mac esquece então este PC até o associar de novo.

Se a associação falhar, o cartão diz porquê:

  • "Can't reach Mac" — o Mac está offline ou inacessível.
  • "Mac didn't accept this machine (is it up to date?)" — atualize o Bromure Agentic Coding no Mac.
  • "Mac refused this machine" — o PC foi recusado no Mac; o Sidecar tenta de novo ao fim de dois minutos.

Agentes de programação

O Sidecar não traz nenhum agente. Abra Coding Agents (o botão no painel, ou Coding Agents… no menu do ícone) para escolher os que este PC executa:

AgenteFabricanteNotas
Claude CodeAnthropicTotalmente integrado: estado em direto, chat e delegação no Bromure Agentic Coding.
CodexOpenAI
Grok BuildxAI
Kimi CodeMoonshot AI
Oh My PiCódigo aberto

Cada cartão mostra o estado do agente (Installed · versão, Not installed, Installing, Queued, Failed) e o comando exato que o seu instalador executa, com um botão de cópia.

  • Install / Update executa o instalador do próprio agente, transferido do fabricante, na sua conta, sem direitos de administrador. O Bromure não inclui nem aloja nenhum deles. As instalações correm uma de cada vez. A maioria dos agentes mantém-se atualizada sozinha a partir daí.
  • Sign in… inicia a sessão do agente no seu fornecedor. O Sidecar mostra um código de utilização única com Copy e Open sign-in page; para o Claude Code, cole de volta o código que a página mostra e clique em Submit. "Agent: signed in" confirma-o. (O Oh My Pi não tem passo de início de sessão aqui.)
  • Check again volta a verificar o que está instalado, por exemplo depois de ter instalado um agente por si.

Níveis de aprovação

Cada cartão de agente tem uma definição de aprovação. Aplica-se às sessões novas e retomadas:

NívelO que o agente faz
AskPergunta antes de agir — a predefinição do próprio agente.
AutoSó pergunta quando uma ação é arriscada. No Codex: nunca pergunta, mas mantém a sandbox do próprio Codex. No Kimi Code: só pergunta quando é preciso.
FullNunca pergunta, sem limites.

O Oh My Pi só oferece Ask e Full.

Aviso: Num Sidecar, Full significa que o agente pode fazer tudo o que a sua conta do Windows pode, sem perguntar. Prefira Ask ou Auto, a menos que o PC seja dedicado aos agentes.

Sessões

A lista Sessions do painel mostra todos os agentes que correm neste PC — iniciados a partir do Mac ou do PC — com o título, o agente, a pasta e um estado: Working, Needs you ou Idle. Um terminal simples aparece como Shell.

  • Clique numa sessão para a abrir numa janela de terminal (o Windows Terminal, se estiver instalado). Feche a janela do terminal quando quiser: a sessão continua a correr.
  • New inicia uma sessão no PC: escolha um agente instalado, navegue até à pasta onde deve trabalhar e clique em Start in this folder. Abre-se um terminal nela, e a sessão aparece também no Bromure Agentic Coding no Mac.
  • End this session (o botão de energia que aparece ao passar o cursor por uma linha) termina-a.

A partir do Mac, uma máquina Sidecar funciona como qualquer outra: inicie nela uma sessão, abra o terminal, converse com uma sessão do Claude Code ou delegue-lhe trabalho. Os caminhos aparecem à maneira do Linux: a sua pasta de perfil do Windows é /home/ubuntu, e D:\src é /d/src.

Os agentes sobrevivem ao Sidecar. Correm num processo em segundo plano separado: sair do Bromure Sidecar, ou instalar uma atualização, não os para. Enquanto o Sidecar estiver fechado, porém, o Mac não os consegue alcançar; o Sidecar avisa-o quando sai com agentes a correr. Reiniciar o Windows, terminar a sessão no Windows ou desinstalar para-os de facto.

Definições

Abra Settings a partir do cabeçalho do painel:

  • Start at login — arranca o Sidecar quando inicia sessão no Windows, para que os agentes continuem acessíveis depois de um reinício. Ligado por predefinição.
  • Machine name — o nome com que o Bromure Agentic Coding lista este PC. Apague-o para voltar à predefinição (nome-do-computador-native).
  • SSH host key — a impressão digital da chave de anfitrião SSH deste PC, com um botão de cópia, para a confirmar a partir do Mac.
  • bromure.io account — a conta com que o PC tem sessão iniciada, e Sign out. Terminar a sessão também desassocia o PC e remove dele as chaves da conta.

O rodapé mostra a versão do Sidecar e o endereço do seu servidor SSH (consulte Segurança).

Atualizações

O Sidecar procura uma nova versão dois minutos depois de arrancar e depois a cada 12 horas. Quando há uma, o painel mostra "Bromure Sidecar versão is available — Agents keep running while it installs." Clique em Update: o Sidecar transfere o novo instalador, verifica-o e instala-o em silêncio. O Sidecar reinicia sozinho alguns segundos depois; os agentes em execução não são interrompidos.

Nada é atualizado sem que clique em Update. Também pode instalar uma nova versão a qualquer momento executando o instalador mais recente das ligações de transferência por cima do existente.

Desinstalação

Abra Definições → Aplicações → Aplicações instaladas, encontre Bromure Sidecar e escolha Desinstalar. Se ainda houver agentes a correr, o desinstalador pergunta primeiro: "Agents are still running in Bromure Sidecar. Uninstalling stops them. Continue?"

A desinstalação remove o programa, o atalho do menu Iniciar, a entrada de arranque com a sessão e o tipo de ligação bromure-agent-host://. Mantém a sua pasta de dados, %LOCALAPPDATA%\BromureSidecar (início de sessão, definições, registos): apague também essa pasta para começar do zero. Para remover também o PC da sua conta bromure.io, termine a sessão (nas definições) antes de desinstalar.

Segurança

  • Só ligações de saída. O PC não abre nenhuma porta para a rede. O seu servidor SSH só escuta em 127.0.0.1 (porta 2223), e o Mac chega a ele através do relay do bromure.io a que o próprio PC se liga.
  • Chaves, não palavras-passe. Os inícios de sessão SSH são só por chave, e só para o seu próprio nome de utilizador do Windows. As chaves vêm dos dispositivos da sua conta bromure.io; o Sidecar sincroniza-as a cada três minutos e remove-as quando termina a sessão.
  • Aprovação no Mac. Um Mac só deixa um Sidecar associar-se depois de o aprovar lá.
  • Os seus dados continuam seus. A pasta do Sidecar só pode ser lida pela sua conta e pelo próprio Windows.
  • Software assinado. O instalador e todos os programas que contém estão assinados pela Seclio LLC e com carimbo temporal; as atualizações são verificadas contra o SHA-256 publicado antes de correrem.
  • Sem fronteira de rede. Como indicado no início, as máquinas nativas não têm as proteções de gateway das VMs Linux. Trate um Sidecar como o seu próprio terminal e escolha os níveis de aprovação dos agentes em conformidade.

A linha de comandos

bromure-sidecar.exe, na pasta de instalação, é a ferramenta de linha de comandos do Sidecar. O seu comando ctl fala com o Sidecar em execução:

ComandoO que faz
bromure-sidecar ctl healthO Sidecar está a correr?
bromure-sidecar ctl statusVersão, nome da máquina, conta, associação, porta e impressão digital SSH, agentes em execução.
bromure-sidecar ctl signinAbre a página de início de sessão do bromure.io.
bromure-sidecar ctl enroll <code-or-link>Inicia sessão com um código ou uma ligação que copiou (como Paste link).
bromure-sidecar ctl signoutTermina a sessão no bromure.io (também desassocia).
bromure-sidecar ctl serversLista os servidores da conta.
bromure-sidecar ctl attach {"id":"<server-id>"}Associa a um servidor.
bromure-sidecar ctl detachDesassocia.
bromure-sidecar ctl machine-name <name>Muda o nome do PC.
bromure-sidecar ctl install-stateO estado de instalação dos agentes.
bromure-sidecar ctl quitPara o Sidecar (os agentes continuam a correr).
bromure-sidecar claudeInicia o Claude Code na pasta atual como sessão Sidecar e liga-se a ela aqui. Prima Ctrl-B e depois D para a deixar a correr.
bromure-sidecar versionMostra a versão.

No PowerShell, ponha os argumentos JSON entre plicas: bromure-sidecar ctl attach '{"id":"<server-id>"}'.

Ficheiros e pastas

CaminhoO que lá está
%LOCALAPPDATA%\Programs\Bromure SidecarOs programas.
%LOCALAPPDATA%\BromureSidecarOs seus dados: início de sessão, definições, sessões, chaves SSH.
%LOCALAPPDATA%\BromureSidecar\settings.jsonAs definições, incluindo algumas sem botão: sshPort (2223 por predefinição) e updateFeed (defina-o como "" para desligar a procura de atualizações). Saia e volte a arrancar o Sidecar depois de o editar.
%LOCALAPPDATA%\BromureSidecar\logs\bromure-sidecar.logO registo.

Resolução de problemas

ProblemaO que fazer
"Bromure Sidecar isn't running"Arranque o Bromure Sidecar a partir do menu Iniciar. Os seus agentes não foram parados.
Faixa "Git for Windows is needed", ou comandos que falham com "Git for Windows isn't installed on this machine"Clique em Install na faixa (executa winget install --id Git.Git -e --scope user), ou instale o Git for Windows por si, e tente de novo.
"WebView2 isn't available"Instale o Microsoft Edge WebView2 Runtime e volte a arrancar o Sidecar.
"that sign-in link wasn't started here — sign in again from the menu"Clique em Sign in to bromure.io e conclua esse início de sessão; consulte Iniciar sessão.
"This machine was removed from your bromure.io account."O PC foi removido no bromure.io. Inicie sessão de novo.
"Enrolled without the agent-host capability…"Termine a sessão em Settings e inicie-a de novo com Sign in to bromure.io.
"No Bromure AC server is online in your account."Arranque o Bromure Agentic Coding no Mac, com sessão iniciada na mesma conta e o acesso remoto através do bromure.io ligado.
Preso em Waiting for approvalAprove o PC no Mac, no Bromure Agentic Coding.
Um agente diz que não está instaladoInstale-o a partir de Coding Agents. Se o instalador terminou mas o agente continua sem ser encontrado, clique em Check again, ou termine a sessão no Windows e volte a iniciá-la.
A vista Settings mostra "Couldn't start the SSH server"Outro programa usa a porta 2223. Defina outro sshPort em settings.json, depois saia e volte a arrancar o Sidecar.
Qualquer outra coisaSaia e volte a arrancar o Sidecar a partir do menu do ícone (os agentes continuam a correr), e consulte o ficheiro de registo. bromure-sidecar ctl status mostra o estado do Sidecar de uma só vez.