Bromure Sidecar para Windows
Bromure Sidecar convierte un PC con Windows en una máquina nativa para Bromure Agentic Coding. Las máquinas de tu Mac son VM Linux. Una máquina Sidecar es un PC con Windows de verdad, que ejecuta agentes de programación — Claude Code, Codex, Grok Build, Kimi Code, Oh My Pi — directamente en Windows, en tu propia cuenta de Windows.
Cuando el PC ha iniciado sesión en la misma cuenta de bromure.io que tu Mac y está vinculado a él, aparece en Bromure Agentic Coding como una máquina más. Sus sesiones aparecen en el Mac junto a las que se ejecutan en VM: puedes iniciarlas desde el Mac, seguirlas, chatear con ellas y delegarles trabajo. También puedes iniciar sesiones en el propio PC, desde el icono del Sidecar en el área de notificación.
El PC y el Mac se comunican de igual a igual a través de bromure.io. El PC solo hace conexiones salientes, así que no hay que redirigir puertos, ni usar VPN, ni escribir direcciones.
Nota: Como los agentes de un Sidecar se ejecutan directamente en el PC, no pasan por la frontera de red de una máquina. Squelch, la inyección de credenciales, el rastreo y la política de sandbox son funciones de las máquinas (las VM Linux) y no se aplican a una máquina nativa. Un agente Sidecar tiene los accesos de tu cuenta de Windows; elige su nivel de aprobación en consecuencia (consulta Niveles de aprobación).
Este capítulo trata la instalación del Sidecar, el inicio de sesión y la vinculación, la instalación de agentes, las sesiones, los ajustes, las actualizaciones, la desinstalación, la línea de comandos y la solución de problemas. Para el lado del Mac del acceso remoto, consulta Acceso remoto y clientes.
Requisitos
| Windows | Windows 10 versión 1809 o posterior, o Windows 11. 64 bits, en Intel/AMD (x64) o ARM (ARM64). |
| Git for Windows | Obligatorio: los agentes y los comandos de Bromure Agentic Coding se ejecutan en Git Bash. El instalador ofrece instalarlo si falta. |
| Microsoft Edge WebView2 Runtime | Obligatorio para la ventana del Sidecar. Viene incluido en Windows 11; el instalador lo ofrece si falta. |
| Una cuenta | Una cuenta de bromure.io — la misma con la que ha iniciado sesión el Bromure Agentic Coding de tu Mac. |
| Permisos de administrador | No hacen falta. Todo se instala en tu propia cuenta. |
En Windows 11 versión 22H2 y posteriores, las ventanas del Sidecar usan el estilo translúcido de Windows 11; en versiones anteriores se ven más sencillas, pero funcionan igual.
Instalación
Descarga el instalador para tu PC:
| PC | Descarga |
|---|---|
| Intel o AMD (la mayoría de los PC) | BromureSidecar-x64.exe |
| ARM (por ejemplo, portátiles Snapdragon) | BromureSidecar-arm64.exe |
Estos enlaces siempre apuntan a la última versión. ¿No sabes cuál necesitas? Abre Configuración → Sistema → Información y mira Tipo de sistema: «procesador basado en x64» significa x64, «procesador basado en ARM» significa ARM64. El instalador ARM64 se niega a ejecutarse en un PC x64, y te lo dice.
Ejecuta el instalador. Está firmado por Seclio LLC, así que Windows muestra ese editor. Después:
- Si falta Git for Windows o el WebView2 Runtime, el instalador los muestra como componentes. Déjalos marcados para instalarlos también: Git llega desde winget, y WebView2 desde Microsoft. Cuando ambos ya están, esta página se omite.
- El instalador copia Bromure Sidecar en
%LOCALAPPDATA%\Programs\Bromure Sidecar. - En la última página, deja marcado Start Bromure Sidecar.
El instalador, además:
- añade un acceso directo Bromure Sidecar al menú Inicio;
- hace que el Sidecar arranque al iniciar sesión en Windows;
- registra el tipo de enlace
bromure-agent-host://que bromure.io usa para devolver el inicio de sesión al PC; - añade una entrada en Configuración → Aplicaciones → Aplicaciones instaladas, para desinstalarlo.
El icono del área de notificación y el panel
Bromure Sidecar vive en el área de notificación de la barra de tareas. Si no ves su icono, haz clic en la flecha ^; puedes arrastrar el icono a la barra de tareas para que siga visible.
El icono indica el estado de un vistazo:
| Icono | Significado |
|---|---|
| Gris | El Sidecar no se está ejecutando, o el PC no está vinculado a ningún Bromure Agentic Coding. |
| En color | Vinculado. Pasa el puntero por encima para ver el nombre del Mac al que está vinculado. |
| Con un punto | Un agente te necesita: espera una respuesta o una aprobación. |
Un clic izquierdo en el icono abre el panel del Sidecar. Haz clic en cualquier otro sitio, o pulsa Esc, para cerrarlo. Un clic derecho abre un menú con Open Bromure Sidecar, Coding Agents… y Quit Bromure Sidecar.
El panel muestra, de arriba abajo:
- La cabecera: «Bromure Sidecar» y una línea de estado, como «Not signed in to bromure.io», «Signed in as nombre-del-pc» o «Attached to Mac as nombre-del-pc». Sus dos botones abren Coding agents y Settings.
- Avisos, cuando corresponden: «Git for Windows is needed», con un botón Install, o «Bromure Sidecar versión is available», con un botón Update.
- La tarjeta de conexión: iniciar sesión, o vincularse a un Mac.
- Sessions: los agentes que se ejecutan en este PC.
- El pie: Coding Agents y Quit.
Iniciar sesión en bromure.io
La tarjeta de conexión del panel muestra Reach this PC from Bromure AC.
- Haz clic en Sign in to bromure.io. El navegador abre la página de inicio de sesión de bromure.io.
- Inicia sesión con la cuenta que usa tu Mac y aprueba que se añada este PC.
- bromure.io devuelve el inicio de sesión al Sidecar mediante un enlace
bromure-agent-host://; el navegador puede preguntar si quieres abrir Bromure Sidecar. Permítelo.
La línea de estado cambia a «Signing in…» y después a «Signed in as nombre-del-pc».
Si el navegador no puede abrir el Sidecar (por ejemplo, porque terminaste de iniciar sesión en otro ordenador), copia el enlace bromure-agent-host:// de la página y haz clic en Paste link en el panel.
Seguridad: El Sidecar solo acepta el inicio de sesión que él mismo empezó. Un enlace
bromure-agent-host://tiene que llevar el código del inicio de sesión que empezaste con Sign in to bromure.io, tanto si llega desde el navegador como si se pega; cualquier otro se rechaza con «that sign-in link wasn't started here — sign in again from the menu». Así una página web o un mensaje no pueden colar este PC en la cuenta de otra persona. Si ves ese mensaje, haz clic otra vez en Sign in to bromure.io y termina ese inicio de sesión.
El nombre de la máquina es el nombre con el que Bromure Agentic Coding muestra este PC. De forma predeterminada es el nombre del ordenador seguido de -native; puedes cambiarlo en los ajustes.
Vincular con Bromure Agentic Coding
Con la sesión iniciada, la tarjeta de conexión muestra los servidores de tu cuenta: los Mac cuyo Bromure Agentic Coding está en línea, cada uno con Online u Offline y un botón Attach. Si no aparece ninguno, «No Bromure AC server is online in your account»: abre Bromure Agentic Coding en tu Mac (con sesión iniciada en la misma cuenta y el acceso remoto a través de bromure.io activado — consulta Acceso remoto y clientes).
Haz clic en Attach junto a tu Mac:
- La tarjeta muestra Connecting.
- La primera vez muestra Waiting for approval: «Allow this PC in Bromure AC's fleet dialog on Mac.» En el Mac, aprueba el PC cuando Bromure Agentic Coding lo pida.
- La tarjeta muestra Attached, y el icono del área de notificación pasa de gris a color.
El PC aparece ahora entre las máquinas del Mac, en Native Machines. La vinculación sobrevive a los reinicios: el Sidecar se vuelve a conectar solo la próxima vez que arranque. Haz clic en Detach para dejarlo; el Mac olvida entonces este PC hasta que lo vuelvas a vincular.
Si la vinculación falla, la tarjeta dice por qué:
- «Can't reach Mac» — el Mac está desconectado o no se puede alcanzar.
- «Mac didn't accept this machine (is it up to date?)» — actualiza Bromure Agentic Coding en el Mac.
- «Mac refused this machine» — el PC se rechazó en el Mac; el Sidecar vuelve a intentarlo al cabo de dos minutos.
Agentes de programación
El Sidecar no incluye ningún agente. Abre Coding Agents (el botón del panel, o Coding Agents… en el menú del icono) para elegir cuáles ejecuta este PC:
| Agente | Fabricante | Notas |
|---|---|---|
| Claude Code | Anthropic | Totalmente integrado: estado en directo, chat y delegación en Bromure Agentic Coding. |
| Codex | OpenAI | |
| Grok Build | xAI | |
| Kimi Code | Moonshot AI | |
| Oh My Pi | Código abierto |
Cada tarjeta muestra el estado del agente (Installed · versión, Not installed, Installing, Queued, Failed) y el comando exacto que ejecuta su instalador, con un botón para copiarlo.
- Install / Update ejecuta el instalador del propio agente, descargado de su fabricante, en tu cuenta, sin permisos de administrador. Bromure no incluye ni aloja ninguno. Las instalaciones se hacen de una en una. La mayoría de los agentes se mantienen actualizados solos a partir de ahí.
- Sign in… inicia la sesión del agente en su proveedor. El Sidecar muestra un código de un solo uso con Copy y Open sign-in page; para Claude Code, pega de vuelta el código que muestra la página y haz clic en Submit. «Agent: signed in» lo confirma. (Oh My Pi no tiene paso de inicio de sesión aquí.)
- Check again vuelve a comprobar qué está instalado, por ejemplo después de que hayas instalado un agente por tu cuenta.
Niveles de aprobación
Cada tarjeta de agente tiene un ajuste de aprobación. Se aplica a las sesiones nuevas y reanudadas:
| Nivel | Qué hace el agente |
|---|---|
| Ask | Pregunta antes de actuar — el comportamiento predeterminado del propio agente. |
| Auto | Solo pregunta cuando una acción es arriesgada. En Codex: nunca pregunta, pero mantiene el sandbox propio de Codex. En Kimi Code: solo pregunta cuando hace falta. |
| Full | Nunca pregunta, sin límites. |
Oh My Pi solo ofrece Ask y Full.
Advertencia: En un Sidecar, Full significa que el agente puede hacer todo lo que puede tu cuenta de Windows, sin preguntar. Prefiere Ask o Auto, salvo que el PC esté dedicado a los agentes.
Sesiones
La lista Sessions del panel muestra todos los agentes que se ejecutan en este PC — iniciados desde el Mac o desde el PC — con su título, agente, carpeta y un estado: Working, Needs you o Idle. Un terminal simple aparece como Shell.
- Haz clic en una sesión para abrirla en una ventana de terminal (Windows Terminal, si está instalado). Cierra la ventana del terminal cuando quieras: la sesión sigue ejecutándose.
- New inicia una sesión en el PC: elige un agente instalado, ve hasta la carpeta en la que debe trabajar y haz clic en Start in this folder. Se abre un terminal en ella, y también aparece en Bromure Agentic Coding en el Mac.
- End this session (el botón de encendido que aparece al pasar el puntero por una fila) la detiene.
Desde el Mac, una máquina Sidecar funciona como cualquier otra: inicia una sesión en ella, abre su terminal, chatea con una sesión de Claude Code o delégale trabajo. Las rutas se muestran a la manera de Linux: tu carpeta de perfil de Windows es /home/ubuntu, y D:\src es /d/src.
Los agentes sobreviven al Sidecar. Se ejecutan en un proceso en segundo plano aparte: salir de Bromure Sidecar, o instalar una actualización, no los detiene. Mientras el Sidecar está cerrado, eso sí, el Mac no puede alcanzarlos; te avisa si sales con agentes en marcha. Reiniciar Windows, cerrar la sesión de Windows o desinstalar sí los detiene.
Ajustes
Abre Settings desde la cabecera del panel:
- Start at login — arranca el Sidecar al iniciar sesión en Windows, para que los agentes sigan accesibles tras un reinicio. Activado de forma predeterminada.
- Machine name — el nombre con el que Bromure Agentic Coding muestra este PC. Déjalo vacío para volver al predeterminado (nombre-del-ordenador-native).
- SSH host key — la huella de la clave de host SSH de este PC, con un botón para copiarla, para comprobarla desde el Mac.
- bromure.io account — con qué cuenta ha iniciado sesión el PC, y Sign out. Cerrar la sesión también desvincula el PC y le quita las claves de la cuenta.
El pie muestra la versión del Sidecar y la dirección de su servidor SSH (consulta Seguridad).
Actualizaciones
El Sidecar busca una versión nueva dos minutos después de arrancar y después cada 12 horas. Cuando hay una, el panel muestra «Bromure Sidecar versión is available — Agents keep running while it installs.» Haz clic en Update: el Sidecar descarga el nuevo instalador, lo comprueba y lo instala en silencio. El Sidecar se reinicia solo unos segundos después; los agentes en marcha no se interrumpen.
Nada se actualiza sin que hagas clic en Update. También puedes instalar una versión nueva en cualquier momento ejecutando el instalador más reciente de los enlaces de descarga sobre el existente.
Desinstalación
Abre Configuración → Aplicaciones → Aplicaciones instaladas, busca Bromure Sidecar y elige Desinstalar. Si todavía hay agentes en marcha, el desinstalador pregunta primero: «Agents are still running in Bromure Sidecar. Uninstalling stops them. Continue?»
La desinstalación quita el programa, el acceso directo del menú Inicio, la entrada de inicio con la sesión y el tipo de enlace bromure-agent-host://. Conserva tu carpeta de datos, %LOCALAPPDATA%\BromureSidecar (inicio de sesión, ajustes, registros): borra también esa carpeta para empezar de cero. Para quitar también el PC de tu cuenta de bromure.io, cierra la sesión (en los ajustes) antes de desinstalar.
Seguridad
- Solo conexiones salientes. El PC no abre ningún puerto a la red. Su servidor SSH solo escucha en
127.0.0.1(puerto 2223), y el Mac llega a él a través del relé de bromure.io al que se conecta el propio PC. - Claves, no contraseñas. Los inicios de sesión SSH son solo por clave, y solo para tu propio nombre de usuario de Windows. Las claves vienen de los dispositivos de tu cuenta de bromure.io; el Sidecar las sincroniza cada tres minutos y las quita cuando cierras la sesión.
- Aprobación en el Mac. Un Mac solo deja que un Sidecar se vincule después de que lo apruebes allí.
- Tus datos siguen siendo tuyos. La carpeta del Sidecar solo la pueden leer tu cuenta y el propio Windows.
- Software firmado. El instalador y cada programa que contiene están firmados por Seclio LLC y con sello de tiempo; las actualizaciones se comprueban contra el SHA-256 publicado antes de ejecutarse.
- Sin frontera de red. Como se indica al principio, las máquinas nativas no tienen las protecciones de pasarela de las VM Linux. Trata un Sidecar como tu propio terminal y elige los niveles de aprobación de los agentes en consecuencia.
La línea de comandos
bromure-sidecar.exe, en la carpeta de instalación, es la herramienta de línea de comandos del Sidecar. Su comando ctl habla con el Sidecar en ejecución:
| Comando | Qué hace |
|---|---|
bromure-sidecar ctl health | ¿Se está ejecutando el Sidecar? |
bromure-sidecar ctl status | Versión, nombre de la máquina, cuenta, vinculación, puerto y huella SSH, agentes en marcha. |
bromure-sidecar ctl signin | Abre la página de inicio de sesión de bromure.io. |
bromure-sidecar ctl enroll <code-or-link> | Inicia sesión con un código o enlace que has copiado (como Paste link). |
bromure-sidecar ctl signout | Cierra la sesión de bromure.io (también desvincula). |
bromure-sidecar ctl servers | Lista los servidores de la cuenta. |
bromure-sidecar ctl attach {"id":"<server-id>"} | Vincula con un servidor. |
bromure-sidecar ctl detach | Desvincula. |
bromure-sidecar ctl machine-name <name> | Cambia el nombre del PC. |
bromure-sidecar ctl install-state | El estado de instalación de los agentes. |
bromure-sidecar ctl quit | Detiene el Sidecar (los agentes siguen en marcha). |
bromure-sidecar claude | Inicia Claude Code en la carpeta actual como sesión Sidecar y se conecta a ella aquí. Pulsa Ctrl-B y luego D para dejarla en marcha. |
bromure-sidecar version | Muestra la versión. |
En PowerShell, pon los argumentos JSON entre comillas simples: bromure-sidecar ctl attach '{"id":"<server-id>"}'.
Archivos y carpetas
| Ruta | Qué contiene |
|---|---|
%LOCALAPPDATA%\Programs\Bromure Sidecar | Los programas. |
%LOCALAPPDATA%\BromureSidecar | Tus datos: inicio de sesión, ajustes, sesiones, claves SSH. |
%LOCALAPPDATA%\BromureSidecar\settings.json | Los ajustes, incluidos algunos sin botón: sshPort (2223 de forma predeterminada) y updateFeed (ponlo a "" para desactivar la búsqueda de actualizaciones). Sal del Sidecar y vuelve a abrirlo después de editarlo. |
%LOCALAPPDATA%\BromureSidecar\logs\bromure-sidecar.log | El registro. |
Solución de problemas
| Problema | Qué hacer |
|---|---|
| «Bromure Sidecar isn't running» | Abre Bromure Sidecar desde el menú Inicio. Tus agentes no se han detenido. |
| Aviso «Git for Windows is needed», o comandos que fallan con «Git for Windows isn't installed on this machine» | Haz clic en Install en el aviso (ejecuta winget install --id Git.Git -e --scope user), o instala Git for Windows tú mismo, y vuelve a intentarlo. |
| «WebView2 isn't available» | Instala el Microsoft Edge WebView2 Runtime y vuelve a abrir el Sidecar. |
| «that sign-in link wasn't started here — sign in again from the menu» | Haz clic en Sign in to bromure.io y termina ese inicio de sesión; consulta Iniciar sesión. |
| «This machine was removed from your bromure.io account.» | El PC se quitó en bromure.io. Vuelve a iniciar sesión. |
| «Enrolled without the agent-host capability…» | Cierra la sesión en Settings y vuelve a iniciarla con Sign in to bromure.io. |
| «No Bromure AC server is online in your account.» | Abre Bromure Agentic Coding en el Mac, con sesión iniciada en la misma cuenta y el acceso remoto a través de bromure.io activado. |
| Atascado en Waiting for approval | Aprueba el PC en el Mac, en Bromure Agentic Coding. |
| Un agente dice que no está instalado | Instálalo desde Coding Agents. Si el instalador terminó pero el agente sigue sin encontrarse, haz clic en Check again, o cierra la sesión de Windows y vuelve a iniciarla. |
| La vista Settings muestra «Couldn't start the SSH server» | Otro programa usa el puerto 2223. Indica otro sshPort en settings.json, y luego sal del Sidecar y vuelve a abrirlo. |
| Cualquier otra cosa | Sal del Sidecar y vuelve a abrirlo desde el menú del icono (los agentes siguen en marcha), y luego mira el archivo de registro. bromure-sidecar ctl status muestra el estado del Sidecar de un vistazo. |