LinkShell
LinkShell es un puente CLI en Node.js que conecta terminales locales, agentes de codificación (Claude Code, Codex, Gemini CLI) y servidores de desarrollo con dispositivos móviles o navegadores mediante una arquitectura de gateway.
Ficha actualizada 26 sept 2026, 16:21 · upstream 26 sept 2026, 16:16 · release cli-v0.5.37
Qué es LinkShell
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
LinkShell permite acceder a tu entorno de desarrollo local desde el teléfono o navegador sin mover procesos. Actúa como puente entre la máquina host y clientes remotos, manteniendo las sesiones de terminal, agentes y servidores activos en el equipo original.
La herramienta se instala globalmente con npm y ejecuta un daemon que gestiona el puente y el gateway. Soporta múltiples vistas: Terminal (PTY real), Agent Workspace (conversaciones estructuradas), Browser (proxy HTTP/WebSocket) y Desktop (compartición de pantalla vía WebRTC o streaming).
La arquitectura es modular, con paquetes separados para CLI, Gateway, Protocolo compartido, App móvil (React Native) y Dashboard web. El protocolo está documentado en Zod schemas y permite autenticación por tokens de dispositivo tras emparejamiento QR.
- Continuar sesiones de terminal desde el móvil sin interrumpir procesos en el host
- Supervisar agentes de codificación (Claude Code, Codex) y aprobar solicitudes de herramientas
- Acceder a servidores de desarrollo local (HMR, WebSocket) desde cualquier navegador
- Compartir pantalla del equipo para revisión remota con fallback a streaming de capturas
- Arquitectura modular en pnpm workspace con paquetes claros: CLI, Gateway, Protocolo, App móvil y Dashboard
- Soporte nativo para agentes estructurados (Claude Code SDK, Codex app-server) y fallback a shell
- Gateway embebido o autoalojado con autenticación por tokens de dispositivo tras emparejamiento QR
- Proxy HTTP/WebSocket que mantiene HMR y hot reload en servidores locales
- Compartición de pantalla vía WebRTC (werift) con fallback a streaming de capturas
- No incluye Dockerfile; requiere instalación manual de Node.js y CLIs en el host
- El gateway es infraestructura de confianza sin cifrado extremo a extremo por defecto
- Requiere que el host permanezca activo y accesible en la red para mantener sesiones
- Los agentes no estructurados (ej. Gemini CLI) carecen de adaptador oficial de workspace
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 Node.js y CLIs en el host, luego ejecutar `linkshell start --daemon`. Para gateway propio: `linkshell gateway --daemon --port 8787` detrás de proxy HTTPS con soporte WebSocket. En móvil/navegador, escanear QR o usar URL del gateway. Verificar firewall y permisos de captura de pantalla en macOS.
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.