agent-seat

_{Capturado desde el propio asiento de la IA a través de la CLI. El escritorio del propietario no está involucrado.}

¿Por qué agent-seat?

Tu agente necesita un lugar para abrir aplicaciones, leer pantallas y realizar tareas de escritorio. Tú aún necesitas una computadora que puedas usar.

agent-seat crea una cuenta local de Windows y una sesión de escritorio separadas para tu IA. Tu agente trabaja en esa sesión mientras tú sigues usando la tuya. Abre el visor local para ver su progreso, pausar la entrada o tomar el control con tu mouse y teclado.

Úsalo para darle a un agente de IA existente un espacio de trabajo de escritorio, explorar la automatización de aplicaciones de Windows o supervisar una tarea sin mantener la pantalla de la IA en primer plano. El proyecto proporciona el escritorio y las herramientas de control; trae tu propio agente capaz de procesar imágenes o cliente de modelo.

Vista previa experimental · 0.9.3. El instalador utiliza una modificación no compatible de TermWrap para habilitar sesiones simultáneas en clientes Windows. Las actualizaciones de Windows pueden afectar la compatibilidad. La instalación en máquinas nuevas en distintas versiones de Windows y el reinicio/nuevo inicio de sesión aún no están validados. Revisa el registro de validación antes de instalar.

Lo que puedes hacer

Capacidad	Lo que te ofrece
🖥️ Escritorio dedicado	Una cuenta estándar de Windows y su propia sesión interactiva
👀 Visor local	Ve el escritorio de tu IA en un navegador; comienza en modo solo lectura
🖱️ Toma de control humana	Haz clic, doble clic, clic derecho, arrastra, desplázate, envía teclas y texto IME
🧰 CLI + MCP opcional	Conecta tu agente existente a través de cualquiera de las dos interfaces
📝 Observaciones selectivas	Texto de la interfaz, detección de marcos sin cambios y recortes de regiones modificadas
⏸️ Controles del propietario	Pausa, reanuda y detén la entrada desde el panel local
🌐 Tres idiomas de interfaz	Inglés, coreano y chino simplificado con una elección de idioma guardada

La versión incluye el servicio, la CLI, el ancla RDP, el asistente de entrada y el runtime de .NET.

Cómo encaja todo

flowchart LR
    You[You] --> Own[Your Windows desktop]
    Agent[Your AI agent] --> Tools[CLI or MCP]
    Tools --> Service[agent-seat local service]
    Service --> Seat[Dedicated Windows desktop]
    You --> Viewer[Local browser viewer]
    Viewer <--> Service

El banner es una ilustración conceptual. Ambos escritorios comparten un único host de Windows. Las cuentas y sesiones separadas no son una VM ni una zona de pruebas de seguridad.

Inicio rápido

Instalación con doble clic

Descarga Install-AgentSeat.cmd y haz doble clic en él. Descarga el ZIP ejecutable de la versión, verifica su suma de verificación SHA-256 y el resumen del activo de GitHub, lo extrae e inicia la configuración. No se necesitan herramientas de desarrollo ni extracción manual.

Revisa el plan de instalación, escribe INSTALL para aceptar la modificación no compatible del cliente de Windows y luego aprueba el acceso de administrador de Windows con la misma cuenta de propietario. La configuración crea el asiento y abre su pantalla en modo solo lectura.

Un comando de PowerShell

Abre Windows PowerShell de 64 bits con tu cuenta de propietario habitual e ejecuta:

& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/aksmfosef11/agent-seat/v0.9.3/Get-AgentSeat.ps1')))

Esto descarga y ejecuta el script de arranque versionado de este repositorio. A continuación, se realiza la misma revisión de instalación y el aviso de administrador de Windows. El arranque verifica el ZIP antes de ejecutar su instalador.

Para que tu IA lo instale, dale la guía de instalación ejecutada por IA. Enumera los pasos de acceso de administrador y consentimiento que la IA debe devolverte.

Instalación ZIP sin conexión

Descarga agent-seat-0.9.3-win-x64.zip y SHA256SUMS.txt desde Releases, compara el hash, luego extrae el ZIP y haz doble clic en su Install-AgentSeat.cmd. Esta ruta usa el paquete local sin otra descarga.

Get-FileHash .\agent-seat-0.9.3-win-x64.zip -Algorithm SHA256

Los archivos fuente automáticos de GitHub no contienen aplicaciones compiladas. Los usuarios finales no necesitan Visual Studio, Node.js, Git ni un SDK de .NET.

La configuración reutiliza un asiento existente y abre su visor; no restablece cuentas ni actualiza los binarios de aplicaciones existentes. Consulta instalación y recuperación para conocer las opciones, el modo de solo descarga y las instalaciones interrumpidas.

Después de la configuración, View-Seat.cmd abre la pantalla nuevamente. Detén la tarea de la IA antes de habilitar el Control manual. Usa el cuadro de texto para texto IME y los botones de acceso directo para combinaciones interceptadas por el navegador.

Requisitos

Elemento	Soporte de vista previa
Host	Windows 11 Pro / Enterprise / Education, x64
Instalación	Acceso de administrador desde la cuenta interactiva del propietario
Cliente de IA	Tu propio agente que pueda leer imágenes y llamar a herramientas CLI o MCP
Runtime	Incluido en el ZIP de la versión (.NET 8.0.31)
Instaladores no compatibles	Windows Home, ARM64 y Windows Server/RDS

El ancla se ejecuta bajo el propietario instalador. Después de cerrar sesión y volver a iniciarla, inicia el asiento nuevamente con computer start. Revisa recuperación y limitaciones actuales para instalaciones interrumpidas y actualizaciones de Windows.

Conecta tu agente

CLI

MCP es opcional. La CLI lee el token protegido del propietario instalador:

$cli = "$env:ProgramFiles\agent-seat\cli\agent-seat.exe"
& $cli computer start --seat agent
& $cli computer begin --seat agent
& $cli computer guide

Inicia un nuevo contexto de observación con begin, abre la captura de pantalla devuelta y luego reutiliza su ID de contexto para observaciones y acciones posteriores. La entrada se puede agrupar; observa el resultado antes de reintentar una acción fallida. Consulta el flujo de trabajo CLI en inglés.

MCP

Registra el mismo ejecutable con los argumentos computer mcp --seat agent en tu cliente MCP. Hay cuatro herramientas disponibles: seat_status, seat_start, seat_observe y seat_act. Las imágenes se pueden devolver directamente en los resultados de las herramientas. Consulta configuración de MCP.

Uso de tokens: el texto de la interfaz, la reutilización de imágenes, los recortes y los lotes pueden reducir las observaciones repetidas. El ahorro depende del modelo y la tarea; no se promete ningún porcentaje. El visor humano no envía fotogramas a un modelo y no realiza llamadas a la API del modelo.

Idiomas

El panel y el visor admiten English · 한국어 · 中文（简体）. La primera visita sigue los idiomas preferidos de tu navegador; los idiomas no compatibles se cambian al inglés. Usa el selector de idioma en el encabezado o en el visor para cambiarlo. Tu elección se guarda en ese navegador sin recargar la página ni borrar el texto redactado.

Esto cambia la interfaz de agent-seat, no el idioma de Windows ni las aplicaciones dentro del asiento. Los mensajes de máquina CLI/API y los diagnósticos originales permanecen en inglés para mantener la compatibilidad. Los diagnósticos de proveedores desconocidos permanecen disponibles en lugar de adivinarse u ocultarse.

Compilar y contribuir

Los desarrolladores necesitan Git, SDK de .NET 8, Visual Studio/Build Tools con Desarrollo de escritorio con C++ y el SDK de Windows. Node.js es necesario para las pruebas de interfaz de usuario.

git clone https://github.com/aksmfosef11/agent-seat.git
cd agent-seat
.\scripts\Build-TermWrap.ps1
dotnet test .\AgentSeat.sln -c Release
npm test
powershell -NoProfile -File tests/installer/bootstrap.tests.ps1
.\scripts\Package-Release.ps1

Confirma los cambios de código fuente antes del empaquetado; la versión registra su confirmación de código fuente. Los binarios generados y las credenciales locales permanecen fuera de Git. Consulta publicación y localización.

Los informes con una edición/compilación de Windows y pasos de reproducción claros ayudan más. Elimina tokens, credenciales y capturas de pantalla personales antes de abrir un problema. Las pruebas de instalación nueva y de nuevo inicio de sesión son especialmente útiles antes de una versión estable.

Documentación

Guía	English	한국어	简体中文
Descripción general del proyecto	README	README	README
Instalación y recuperación	Guía	안내	指南
Flujo de trabajo CLI	Guía	안내	指南
MCP opcional	Guía	안내	指南
Instalación ejecutada por IA	Guía	안내	指南

Seguridad · Validación · Arquitectura

Licencia

MIT para el código fuente de este proyecto. Las dependencias conservan sus licencias originales; consulta avisos de terceros.