FirstMate
FirstMate es un host local para plugins que ejecuta herramientas propias en la máquina del usuario sin requerir runtime propio por cada herramienta. Escucha en puerto 4747 y proporciona página web y dirección para cada plugin.
Ficha actualizada 25 sept 2026, 2:47 · upstream 25 sept 2026, 2:34 · release v1.0.1
Qué es FirstMate
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
FirstMate actúa como anfitrión local para plugins, ejecutando las herramientas del usuario en su propia máquina sin que cada una deba construir su propio runtime. El host escucha en http://127.0.0.1:4747/ y asigna a cada plugin un proceso, página web y dirección única.
La arquitectura se basa en Node.js 24 o superior con Next.js como framework. Los plugins son directorios que pueden contener una carpeta web/ para servir páginas y un ejecutable mcp para comunicación MCP vía stdin/stdout. No requiere paso de build al clonar el repositorio.
El sistema incluye gestión de permisos mediante grants unidireccionales, atajos de teclado integrados con soporte para WSL en Windows, integración con systemd en Linux, y almacenamiento de configuración en ~/.firstmate con registro de plugins, runtime y settings.
- Ejecutar herramientas MCP locales sin construir runtime propio
- Gestionar múltiples plugins de IA localmente en una sola máquina
- Crear extensiones personalizadas para flujos de trabajo automatizados
- Servir páginas web desde plugins directamente al host
- Centralizar herramientas de desarrollo en un único punto de acceso
- Sin dependencias de runtime, solo Node.js 24+
- Estructura de plugin simple: carpeta web/ y ejecutable mcp
- Integración nativa con systemd en Linux
- Soporte WSL para tray app en Windows
- MIT license sin restricciones comerciales
- No compatible con Windows nativo para Plugin Server
- Sin soporte Docker o contenedores
- Requiere Node.js 24 o versión superior
- Shelf debe configurarse manualmente vía CLI
- Grants son unidireccionales solo de from a to
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar globalmente con npm install -g @luan-afonso/firstmate. Ejecutar firstmate start para iniciar el host en puerto 4747. Requiere Node.js 24+. En Linux usar systemd service. Configurar FIRSTMATE_HOME=~/.firstmate. Para WSL en Windows, el tray app funciona solo a través de \wsl.localhost\. Los plugins se añaden con node src/cli.ts add <ruta>. El shelf predeterminado es ~/.firstmate/shelf.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.