Bromure Agentic Coding — Manual de usuario

Bienvenido al manual oficial de Bromure Agentic Coding, la app de macOS que ejecuta agentes de código con IA — Claude Code, Codex, Grok, Kimi Code, Oh My Pi, y las herramientas de shell de siempre — dentro de máquinas virtuales Linux aisladas en tu Mac, con una pasarela del lado del anfitrión que mantiene tus credenciales reales fuera del alcance del agente.

Este manual documenta la versión 5.0.0. Requiere macOS 14 (Sonoma) o posterior en Apple Silicon.

La versión 5.0.0 está organizada alrededor de las sesiones: cada conversación con un agente es una fila en la barra lateral, y le hablas en un chat. Las VM Linux en las que se ejecutan las sesiones se llaman máquinas en la ventana principal. El editor de ajustes las sigue llamando espacios de trabajo; las dos palabras significan lo mismo.

¿Nuevo en la app? Empieza por Instalación y primer arranque, y luego sigue el Inicio rápido. Lee Conceptos y arquitectura cuando quieras la imagen completa. Todo lo demás es referencia.

Índice

Para empezar

Capítulo	Qué cubre
1. Introducción	Qué es la app, el modelo de seguridad de un solo límite, las funciones principales, y cómo se compara con otras herramientas.
2. Instalación y primer arranque	Requisitos del sistema, instalar la app, el asistente de puesta en marcha en seis pasos, las actualizaciones de la imagen base, la herramienta de línea de órdenes, el almacenamiento, pasar a un Mac nuevo, y desinstalar.
3. Inicio rápido	Del asistente a una tarea acabada: iniciar una sesión, responder a la pregunta del agente, mirar los archivos cambiados, inspeccionar la traza, y luego archivar la sesión y traerla de vuelta.
4. Conceptos y arquitectura	Sesiones, máquinas, salas y ramas; estados de sesión; anfitrión e invitado; el límite de red; qué persiste; los puertos vsock y MCP; la red.

Uso diario

Capítulo	Qué cubre
5. El inicio de las sesiones	La ventana principal: la barra lateral y su carril plegado, las filas de sesión y sus menús, la cabecera de sesión, el menú de máquinas, la cápsula Linux, la paleta de órdenes ⌘K, y archivar, terminar, eliminar y deshacer.
6. Iniciar una sesión	La pantalla de nueva sesión: elegir el agente, la máquina y dónde trabaja (una carpeta nueva, una de las tuyas, o un repositorio), adjuntar archivos, los inicios recientes, y preguntar a otra sesión con @.
6.1 El chat	Hablar con un agente: el compositor, los adjuntos, las órdenes con barra y el terminal en línea, las tarjetas de pregunta, las líneas de actividad, los resúmenes de archivos cambiados, las tarjetas de inicio de sesión, detener, editar y reenviar, y la búsqueda.
6.2 Salas	Agrupar sesiones relacionadas en una sala: la cuadrícula de chats vivos, las disposiciones y las pestañas, ampliar una celda, la Centralita propia de la sala, y enviar a toda la sala.
6.3 Ramas y revisión	Sesiones de rama en su propio worktree de git, volverlas a fusionar, la ventana Ramas, y la ventana de revisión con comentarios de línea.
6.4 Agentes trabajando juntos	La delegación a sesiones hijas, las peticiones a otras sesiones por @apodo, el panel Delegaciones, el paso de archivos, los límites, y las peticiones entre máquinas.
6.5 Centralita y mensajería	La sesión Centralita que sigue la pista de todas las demás sesiones, sus reglas de seguridad, y el conector de mensajería para Signal, WhatsApp y Slack.
6.6 Máquinas	La sección Máquinas virtuales: crear, arrancar, suspender y eliminar máquinas, Rebobinar el home y Restablecer disco, los terminales y la Cuadrícula, el panel Archivos, y el portapapeles.
6.7 El navegador integrado	El navegador Chromium al lado de una sesión: conducirlo tú mismo, dejar que el agente lo conduzca con las herramientas de navegador, mantener la sesión iniciada, y la privacidad.
Aceleración Metal en Bromure Web	La aplicación web independiente: requisitos de Metal, controles globales y por perfil, renderizador activo y compatibilidad con vídeo.
6.8 Automatizaciones	Ejecuciones de agente programadas y desatendidas en un tablero kanban: disparadores, horarios, cadenas, historial, responder a sus preguntas, y el servidor MCP de automatizaciones.
6.9 Tareas de código	El kanban del código: tareas, fases planificadas por el agente, ejecuciones autónomas en worktrees, revisión con comentarios de línea, y fusión.

Referencia de ajustes

Capítulo	Qué cubre
7. Referencia de ajustes	Cómo abrir el editor de ajustes y los Ajustes, la lista agrupada de paneles y Buscar en los ajustes, la plantilla Valores predeterminados, y qué se guarda cuándo.

La referencia de ajustes tiene una página por panel, en el orden del editor:

Espacio de trabajo: General, Apariencia
Modelos: Modelos, Fusion, Squelch
Máquina: Carpetas, Entorno, MCP, Navegador, Recursos
Seguridad: Credenciales, Trazado, Salvaguardas, Cadena de suministro, Inyección de prompts, Protección de datos personales
App (solo en los Ajustes): Automatización

Seguridad y el límite de red

Capítulo	Qué cubre
8. Credenciales y el límite de red	Cómo los secretos reales se quedan en el anfitrión mientras el agente solo recibe señuelos: el proxy MITM, inicios de sesión y claves de API, aprobaciones por credencial, y la alerta de compromiso.
9. Protección de la cadena de suministro	Comprobar, reescribir y bloquear instalaciones de paquetes antes de que el agente las vea: la barrera de edad, OSV, socket.dev, Depi, y el despojo de guiones de instalación.
10. Detección de inyección de prompts y salvaguardas	Los detectores en el dispositivo que examinan el tráfico de IA del agente en busca de instrucciones inyectadas, el cortafuegos de salida, y las salvaguardas sobre operaciones destructivas.
10.5 Protección de datos personales	Cambiar los datos personales por señuelos coherentes antes de que una conversación salga de tu Mac, y restituirlos en las respuestas.
11. Trazado y auditoría	Qué registra una traza de sesión, el Inspector de trazas, el cifrado en reposo, la retención, la exportación, y la privacidad.
11.5 Resumen y cronología de seguridad	La ventana Cronología de seguridad: el Resumen de 24 horas, las protecciones por máquina, y la Cronología filtrable y exportable de cada decisión de seguridad.

Modelos e infraestructura

Capítulo	Qué cubre
12. Fusion — el panel multimodelo	Responder a cada prompt con varios modelos a la vez, juzgados y combinados en una única respuesta sobre el cable.
12.5 Squelch — menos ruido, menos tokens	Quitar las pruebas superadas, el progreso y otro ruido de la salida de los comandos antes de que el modelo la lea (a la manera de rtk), y los tokens ahorrados por sesión.
13. Modelos y proveedores	El tablero Modelos global: proveedores (inicios de sesión, claves de API, Amazon Bedrock, OpenRouter, servidores personalizados, modelos en el dispositivo), elecciones de modelo por agente, anulaciones por espacio de trabajo, y cambios en caliente.
13.5 Clústeres de Kubernetes y registros	Ejecutar clústeres k3s y un registro de contenedores privado en sus propias VM al lado de tus máquinas: almacenamiento, equilibrio de carga, extras, acceso, y el servidor MCP de infraestructura.

Más allá de un solo Mac

Capítulo	Qué cubre
14. Acceso remoto y el cliente enriquecido	Reflejar un Bromure remoto desde otro Mac, iPhone, iPad o Apple Vision Pro; los Ajustes remotos; la CLI por SSH, túneles y PAC; y el modelo de seguridad remoto.
15. Empresa — Inscripción y flota	Inscribirse en bromure.io, qué sube la telemetría (y qué no), la vista de flota, y la salida.

Referencia

Capítulo	Qué cubre
16. CLI, API y MCP	La herramienta de línea de órdenes `bromure-cli`, la API de control en bucle local, los servidores MCP, y AppleScript.
16.5 Avanzado	Herramientas para usuarios avanzados: el explorador de archivos ext4 y la comprobación del sistema de archivos, y restaurar o rebobinar el home de una máquina.
17. Solución de problemas	Diagnosticar problemas de instalación, de máquina, de inicio de sesión, de TLS, de cadena de suministro, de espacio en disco y de acceso remoto, organizados por síntoma.
18. Glosario	Definiciones de todos los términos usados en este manual.
19. Apéndice — Ubicaciones de archivos, puertos y entorno	Tablas de referencia: ubicaciones en disco, puertos de red y vsock, variables de entorno, valores por omisión, atajos de teclado, y la chuleta del invitado.

Convenciones de este manual

El texto en negrita nombra un control o una etiqueta en pantalla exactamente como la app la muestra en inglés — un botón, un elemento de menú, un conmutador, un panel o una sección de la barra lateral (por ejemplo, New session o Start this VM at login).
El texto en monoespaciado es una orden, una ruta de archivo, una variable de entorno o un valor literal que escribes o ves (por ejemplo, bromure-cli vm ls o ~/Library/Application Support/BromureAC).
Una ruta como Workspaces › Infrastructure › Messaging Connector… es una ruta de menú: el menú, y luego cada submenú o elemento en orden. Ajustes › Modelos significa el panel Modelos de la ventana de Ajustes.
Máquina y espacio de trabajo significan lo mismo: una VM Linux aislada con sus ajustes. La ventana principal dice máquina; el editor de ajustes, los menús como New Workspace… y la CLI dicen espacio de trabajo (o perfil).
Una sesión es una conversación con un agente, en una carpeta, en una máquina. No es una ejecución de una máquina; ver Conceptos y arquitectura.
Los atajos de teclado usan los símbolos de macOS: ⌘ Comando, ⌥ Opción, ⌃ Control, ⇧ Mayúsculas, ⏎ Retorno, ⎋ Escape.
Las capturas de pantalla muestran la interfaz en inglés con contenido de demostración sintético. La app está traducida, así que tus pantallas siguen el idioma de tu macOS.
Las notas, los consejos y las advertencias aparecen como recuadros:

Nota: información de fondo que vale la pena conocer.

Consejo: un atajo o una práctica recomendada.

Advertencia: algo que puede perder datos o debilitar una protección si te equivocas.

Dónde más mirar

Las descargas del producto, el informe técnico y la matriz detallada de funciones están en bromure.io. Para las preguntas que este manual no responde, Solución de problemas reúne los procedimientos de diagnóstico, y el Glosario define el vocabulario.