Bromure Agentic Coding — Manual de usuario

Bienvenido al manual de usuario oficial de Bromure Agentic Coding, la app de macOS que ejecuta agentes de codificación con IA —Claude Code, Codex CLI, Grok CLI y herramientas de shell habituales— dentro de máquinas virtuales de Linux desechables, con una puerta de enlace del lado del anfitrión que mantiene tus credenciales reales fuera del alcance del agente.

Este manual documenta la versión 4.3.0. Requiere macOS 14 (Sonoma) o posterior en Apple Silicon. Si eres nuevo aquí, lee la Introducción y después la Guía rápida; todo lo demás es material de referencia al que puedes acudir cuando lo necesites.

¿Nuevo en la app? El camino más rápido para tener un agente en funcionamiento es la Instalación seguida del recorrido de la Guía rápida.

Índice de contenidos

Primeros pasos

Capítulo	Qué cubre
1. Introducción	Qué es la app, el modelo de seguridad de límite único, las funciones pilar y cómo se compara con otras herramientas.
2. Instalación	Requisitos del sistema, descarga e instalación de la app, el flujo de configuración del primer arranque, actualizaciones de la imagen base, migración y desinstalación.
3. Guía rápida	De una instalación nueva a un agente en funcionamiento en unos diez minutos: crear un espacio de trabajo, elegir un agente, compartir una carpeta, ejecutar una tarea e inspeccionar la traza.

Fundamentos

Capítulo	Qué cubre
4. Conceptos y arquitectura	Anfitrión frente a invitado, espacios de trabajo frente a sesiones frente a VM, el ciclo de vida de la VM, el límite de red, el almacenamiento, los puentes vsock y la red.
5. Espacios de trabajo	El explorador de espacios de trabajo: indicadores de estado, tarjetas de recursos, el resumen de configuración y cómo crear, duplicar, restablecer y eliminar espacios de trabajo.
6. Sesiones	La ventana de sesión unificada: iniciar y cerrar sesiones, pestañas y worktrees, los paneles de navegador y de archivos, la transferencia de archivos y los puntos de control.
El navegador integrado	Uso del Chromium integrado del espacio de trabajo: manejarlo tú mismo, dejar que el agente lo maneje a través de las herramientas del navegador, mantener la sesión iniciada y la privacidad.
Automatizaciones	Ejecuciones de agente programadas y desatendidas en un tablero kanban: cómo crearlas, disparadores y programaciones, automatizaciones encadenadas, historial de ejecuciones y cómo responder a sus prompts.
Tareas de código	El kanban de código: briefs, fases planificadas por el agente con dependencias, ejecuciones autónomas en worktrees, revisión de diffs con comentarios por línea, y fusión.

Referencia de ajustes

Capítulo	Qué cubre
7. Referencia de ajustes	Cómo abrir el editor Editar espacio de trabajo y una referencia página por página de los dieciséis paneles.

La referencia de ajustes tiene una página por panel: General, Agentes, Modelos locales, Fusion, Carpetas, Credenciales, Entorno, MCP, Trazado, Salvaguardas, Cadena de suministro, Inyección de prompts, Apariencia, Navegador, Recursos y el panel Automatización de toda la app.

Los pilares en profundidad

Capítulo	Qué cubre
8. Credenciales y el límite de red	Cómo los secretos reales permanecen en el anfitrión y el agente solo recibe falsos: el proxy MITM, los ciclos de vida por credencial, las aprobaciones y el detector de compromisos.
9. Protección de la cadena de suministro	Verificación, reescritura y bloqueo de instalaciones de paquetes antes de que el agente las vea: el filtro de antigüedad, OSV, socket.dev, Delpi y la eliminación de scripts.
10. Detección de inyección de prompts y salvaguardas	Detectores en el dispositivo que analizan el tráfico de IA del agente en busca de instrucciones inyectadas, además de salvaguardas que eliminan operaciones de infraestructura destructivas.
11. Trazado y auditoría	Qué registra la traza de una sesión, el Inspector de trazas, el cifrado en reposo, la retención, la exportación y la privacidad.
12. Fusion — el panel multimodelo	Responder cada prompt con varios modelos a la vez, juzgados y sintetizados en la red en una única respuesta.
13. Inferencia local e híbrida	Ejecutar modelos en tu propio Apple Silicon con MLX, el catálogo de modelos, el respaldo híbrido nube/local y las métricas de inferencia.

Más allá de un solo Mac

Capítulo	Qué cubre
14. Acceso remoto y el cliente enriquecido	Llegar a tu entorno aislado desde cualquier lugar: la réplica del cliente enriquecido, la CLI, SSH, túneles, PAC y el modelo de seguridad remoto.
15. Empresa — Inscripción y flota	Inscripción con Bromure Enterprise Manager, qué telemetría se sube (y qué no), la vista de flota y la baja.

Referencia

Capítulo	Qué cubre
16. CLI, automatización y MCP	La interfaz de línea de comandos `bromure-cli`, la API de control por loopback, el servidor MCP y AppleScript.
Avanzado	Herramientas para usuarios avanzados, incluido el explorador de archivos ext4 para leer la imagen de home de un espacio de trabajo detenido sin arrancarlo.
17. Solución de problemas	Diagnóstico de problemas de configuración, VM, autenticación, TLS, cadena de suministro, espacio en disco y acceso remoto, organizados por síntoma.
18. Glosario	Definiciones de todos los términos técnicos utilizados en este manual.
19. Apéndice	Tablas de referencia: ubicaciones en disco, puertos de red, variables de entorno y argumentos de inicio, y la chuleta de la VM invitada.

Convenciones utilizadas en este manual

El texto en negrita nombra un control en pantalla exactamente como lo etiqueta la app: un botón, elemento de menú, interruptor o panel (por ejemplo, Iniciar esta VM al iniciar sesión).
El texto en monoespaciado es un comando, ruta de archivo, variable de entorno o valor literal que escribes o ves (por ejemplo, bromure-cli run o ~/Library/Application Support/BromureAC).
Las capturas de pantalla muestran la interfaz en español (Espanol). La app está totalmente localizada; tus pantallas coincidirán con el idioma de tu macOS.
Las notas, consejos y advertencias aparecen como llamadas:

Nota: Información de fondo que conviene conocer.

Consejo: Un atajo o práctica recomendada.

Advertencia: Algo que puede provocar pérdida de datos o debilitar una protección si te equivocas.

Dónde buscar más

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