FirstMate: equipos de agentes, evidencia duradera y autoridad de entrega
Desplegar FirstMate: código compartido, homes privados y backends de sesión
Planifica un entorno operativo para agentes, no un servidor web, con estado privado separado, credenciales deliberadas y actualizaciones versionadas.
Qué aprenderás
- El despliegue es un entorno operativo
- Separa capacidades y datos privados
- Actualiza sin borrar evidencia de recuperación
Antes de empezar
- Bases de árboles Git y solicitudes de cambios
- Comprender agentes de terminal y alcance de credenciales
Definir entregables e inspeccionar evidencia de estado y autoridad sin atribuir garantías no probadas.
Conclusiones clave
- La copia de código y el home operativo tienen funciones distintas.
- La madurez de los backends varía en esta revisión.
- Un fallo remoto no autoriza crear un sustituto local.
El despliegue es un entorno operativo
Clonar FirstMate no crea por sí solo un servicio HTTP que debas exponer. La base documentada incluye macOS o Linux, Git, GitHub CLI autenticado y un anfitrión compatible con las dependencias del backend. tmux es la referencia; unos comandos Shell aparentemente portables no demuestran compatibilidad nativa con Windows.
La raíz de código versionada contiene instrucciones y scripts compartidos. Cada FM_HOME efectivo conserva directorios operativos privados: data para registros duraderos, state para coordinación, config para decisiones locales y projects para clones. Respaldar solo el código no preserva el historial operativo del equipo.
Separa capacidades y datos privados
Considera sensible el home efectivo: instrucciones de tareas, informes, metadatos y artefactos opcionales de Relay pueden revelar información del proyecto. Excluye el estado privado de repositorios públicos y establece acceso y retención. La disposición ignorada por Git ayuda contra incorporaciones accidentales, pero no cifra datos ni constituye una estrategia de respaldo completa.
Elige explícitamente el backend de la prueba y registra su identidad. La arquitectura presenta tmux como referencia, Herdr con una vía de CI obligatoria y zellij, Orca y cmux como adaptadores experimentales. Esos niveles upstream no son equivalentes; Codex App tampoco es un backend seleccionable en esta revisión.
Actualiza sin borrar evidencia de recuperación
Registra revisión, home efectivo y backend juntos. Antes de actualizar, conserva una instantánea recuperable del estado privado conforme a tu política y revisa cambios sin trabajo activo. No borres un home o árbol para despejar un estado confuso: puede conservar propiedad de tareas y cambios todavía no integrados.
Los segundos oficiales opcionales utilizan homes aislados, locales o accesibles por SSH. Una ruta remota inaccesible no debe sustituirse silenciosamente por un home local. Verifica primero la operación local y ensaya el fallo remoto aparte. No ejecutamos aprovisionamiento remoto, reversión ni restauración de respaldos.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Documenta plataforma, anfitrión y backend.
- 2
Identifica el home efectivo y protege su estado.
- 3
Conserva revisión y evidencia de recuperación antes de actualizar.
- 4
Prueba la operación remota por separado.
Ejemplo para copiar
{
"plan": true,
"revision": "b182d0f908b78d08c7ccb8dce3775bdca8c5d657",
"homeEfectivo": "elegir una ruta privada",
"backend": "tmux",
"segundosOficialesRemotos": false,
"restauracionProbada": false
}Preguntas frecuentes
¿Qué puerto debo exponer?
La distribución no requiere por sí misma un despliegue web; evalúa aparte las integraciones opcionales.
¿gitignore protege informes confidenciales?
Evita ciertos seguimientos accidentales, pero no cifra archivos ni controla el acceso al equipo.
Fuentes
- FirstMate / README.mdFuente verificada 2026-09-14
- FirstMate / docs/configuration.mdFuente verificada 2026-09-14
- FirstMate / docs/architecture.mdFuente verificada 2026-09-14