Unlimited Agent

Unlimited Agent permite que una app privada de ChatGPT opere el PC con Windows que su propietario ha emparejado: archivos, PowerShell, programas, capturas de pantalla, ratón y teclado, portapapeles y Chrome.

Usa ChatGPT como cerebro. No llama a una API de modelos, no consume tokens de Codex ni instala una clave de API de modelos de OpenAI. El usuario aún necesita una credencial restringida de Secure MCP Tunnel runtime (Tunnels: Read + Use) para que el puente local pueda autenticarse en su propio túnel; esa credencial no puede realizar inferencias de modelos y está cifrada con DPAPI de Windows.

[!WARNING] El control remoto total es potente. Instálalo solo en un ordenador cuyo propietario haya dado su consentimiento informado. Mantén la política predeterminada balanced + dangerous approval a menos que entiendas las consecuencias de cambiarla.

Qué puede hacer

• Leer, buscar, crear, editar, copiar, mover y eliminar archivos accesibles

• Ejecutar comandos de PowerShell inmediatamente o como trabajos en segundo plano

• Iniciar programas locales e inspeccionar información de Windows/sistema

• Capturar el escritorio principal o virtual

• Listar, enfocar, redimensionar, minimizar, maximizar o cerrar ventanas

• Enviar clics de ratón, desplazamiento, atajos de teclado y entrada de texto

• Leer o reemplazar el texto del portapapeles

• Abrir URLs, seleccionar un perfil de Chrome y controlar pestañas/navegación

• Hacer solicitudes HTTP y descargar archivos sin heredar la credencial del túnel

• Reconectarse automáticamente después del inicio de sesión de Windows

El contrato completo de 21 herramientas está en docs/TOOL_CONTRACT.md.

Related MCP server: ChatGPT Local Agent MCP

Requisitos

• Windows 10 u 11, x64

• Una cuenta de ChatGPT que pueda habilitar el modo desarrollador y apps/conectores privados

• Acceso a Secure MCP Tunnels de OpenAI Platform

• Google Chrome para las herramientas específicas de Chrome (las demás no lo requieren)

Instalación y emparejamiento

1. Descarga Unlimited-Agent-Setup-v0.1.0.exe y SHA256SUMS.txt desde la última versión.

2. Opcionalmente, verifica la descarga:

   Get-FileHash .\Unlimited-Agent-Setup-v0.1.0.exe -Algorithm SHA256

3. Ejecuta el instalador y acepta el aviso de consentimiento informado. Windows SmartScreen puede advertir porque las compilaciones comunitarias no están firmadas con código; verifica el SHA-256 antes de elegir Ejecutar de todos modos.

4. En la ventana de configuración, selecciona Open Secure MCP Tunnels. Crea un túnel en la configuración de túneles de OpenAI Platform y luego copia su ID tunnel_....

5. En claves de API de OpenAI Platform, crea una clave de proyecto dedicada restringida a Tunnels: Read + Use. No concedas permisos de modelos ni de otras API. Pégala en la ventana de configuración.

6. Elige los permisos. Los valores predeterminados recomendados son:

   • Modo de permiso: balanced

   • Aprobación local: dangerous

   • Aprobación de lectura sensible: habilitada

   • Carpeta permitida: tu perfil de usuario de Windows

7. Selecciona Guardar y conectar. El puente se inicia en segundo plano y se registra para el usuario actual de Windows al iniciar sesión.

8. En ChatGPT, abre Configuración → Aplicaciones y conectores → Configuración avanzada, habilita modo desarrollador, crea una app privada y selecciona el túnel que acabas de emparejar. Nómbrala Unlimited Agent.

Abre el acceso directo del escritorio Unlimited Agent Status. CONNECTED and ready significa que el túnel puede servir a la app privada de ChatGPT. Pregunta a ChatGPT: "Usa Unlimited Agent para mostrar mi información del sistema de Windows."

OpenAI documenta actualmente Secure MCP Tunnels como una función privada de prueba en modo desarrollador. No admiten el envío público al directorio de apps de ChatGPT ni un túnel público compartido. En consecuencia, cada usuario debe crear su propio túnel privado y su propia app privada, aunque el instalador y el código fuente sean públicos. Consulta la guía oficial de Secure MCP Tunnel.

Modos de permiso

Abre Unlimited Agent Settings en el escritorio para volver a emparejar, cambiar la credencial del túnel o cambiar los permisos. La configuración se aplica sin reinstalar. Una llamada de herramienta denegada devuelve un resultado estructurado PERMISSION_DENIED a ChatGPT. Las llamadas de herramientas están serializadas, por lo que Unlimited Agent no puede usar su propia herramienta de ratón/teclado para hacer clic en una ventana de aprobación pendiente.

Ejemplos de solicitudes

• "Encuentra todos los archivos .docx modificados esta semana en Documentos y resume sus nombres. No cambies nada."

• "Crea una carpeta en mi escritorio llamada Trip, mueve las fotos seleccionadas a ella y verifica el recuento."

• "Ejecuta la suite de pruebas en C:\work\my-app; sigue consultando hasta que termine y corrige el primer fallo."

• "Toma una captura de pantalla, enfoca Chrome, abre el panel del proyecto y dime qué es visible."

• "Inicia el Bloc de notas, escribe esta nota de reunión, guárdala en Documentos y luego confirma que el archivo existe."

Para tareas de GUI, ChatGPT debe iterar captura de pantalla → enfoque de ventana → entrada → captura de pantalla. Unlimited Agent no puede omitir contraseñas, CAPTCHAs, MFA, el escritorio seguro de UAC ni sesiones de Windows bloqueadas.

Arquitectura

flowchart LR
  A[Private ChatGPT app] --> B[OpenAI Secure MCP Tunnel]
  B -->|outbound HTTPS session| C[tunnel-client]
  C -->|stdio MCP| D[Unlimited Agent server]
  D --> E[Central policy + local approval]
  E --> F[Files / PowerShell / HTTP]
  E --> G[Windows UI / Chrome / clipboard]

• server.mjs registra las herramientas MCP y contiene sus implementaciones.

• policy.mjs envuelve cada registro de herramienta con verificación de permisos de ruta canónica, comprobaciones de carpetas resistentes a reparse/hardlink, detalles completos de aprobación local, anulaciones y comprobaciones de auditoría.

• scripts/windows-ui.ps1 proporciona primitivas de pantalla, ventana, entrada y portapapeles a través de las API de Windows.

• scripts/start-tunnel.ps1 descifra la credencial de runtime por usuario solo el tiempo suficiente para iniciar tunnel-client. El servidor MCP elimina las variables de entorno de credenciales antes de manejar llamadas, y los procesos hijos reciben un entorno saneado.

• scripts/watch-tunnel.ps1 proporciona recuperación en segundo plano de instancia única.

• scripts/settings.ps1 gestiona el emparejamiento y la configuración de permisos. Las credenciales usan DPAPI CurrentUser; la política no secreta es JSON.

• installer/ produce un ejecutable de instalación de Windows x64 autocontenido.

No se crea ningún listener entrante ni excepción de firewall. El servidor local es solo stdio; tunnel-client proporciona el endpoint MCP remoto seleccionado por ChatGPT.

Desarrollo local

git clone https://github.com/yungsuk53-pixel/unlimited-agent.git
cd unlimited-agent
npm ci --ignore-scripts
npm test

npm test alcanza el nivel de validación 2: comprobaciones de esquema/anotaciones, una sesión MCP stdio real, operaciones de archivos, aislamiento de credenciales de PowerShell, HTTP local, capturas de pantalla, ventanas, canalización de entrada, política del sistema y trabajos en segundo plano.

Prueba de compilación e instalación limpia:

npm run build:installer
npm run test:install

La compilación descarga versiones fijadas de Node.js, tunnel-client y ripgrep x64 y las verifica contra valores SHA-256 inmutables comprometidos en el script de compilación. CI repite las pruebas MCP, la compilación del instalador, el ciclo DPAPI, la instalación limpia sintética y las pruebas de herramientas del runtime instalado. Las credenciales de prueba son sintéticas y nunca contactan con OpenAI.

Para probar un túnel real, instala el EXE generado, empareja una credencial de túnel dedicada, comprueba Unlimited Agent Status y conecta la app privada en el modo desarrollador de ChatGPT.

Ubicaciones de datos

Los archivos instalados y los datos del usuario actual están en:

%LOCALAPPDATA%\UnlimitedAgent\
  config\config.json          non-secret policy and tunnel ID
  config\credential.dpapi     DPAPI-encrypted restricted runtime key
  data\audit.jsonl            tool decision audit (names, decisions, hashes)
  data\logs\                  tunnel and watchdog diagnostics

El proyecto nunca registra la credencial del túnel en texto plano. Los registros redactan cadenas que coinciden con formatos de claves de OpenAI, y los procesos lanzados por herramientas reciben una lista mínima permitida de variables de entorno ordinarias de Windows en lugar de heredar tokens o secretos ambientales.

Solución de problemas

El estado dice reconectando o no disponible

• Abre Unlimited Agent Settings y vuelve a ingresar el ID del túnel y una clave de runtime restringida válida.

• Confirma que la clave tiene Tunnels: Read + Use y pertenece a la organización/espacio de trabajo que posee el túnel.

• Revisa %LOCALAPPDATA%\UnlimitedAgent\data\logs\bridge.log y watchdog.log.

• Un 404 comúnmente significa que ChatGPT seleccionó un túnel/app diferente, que el runtime está detenido o que la app privada no se creó desde el mismo contexto de organización de ChatGPT/OpenAI.

Una herramienta es denegada

• La respuesta local indica si el modo de solo lectura, un límite de carpetas permitidas, una anulación por herramienta o una aprobación rechazada lo causaron.

• Abre Unlimited Agent Settings para cambiar la política. No debilites los permisos solo para ocultar un límite de seguridad genuino.

Las acciones de ratón o teclado no hacen nada

• Windows debe tener sesión iniciada y estar desbloqueado.

• El escritorio seguro de UAC, las pantallas de inicio de sesión, algunas apps elevadas, juegos con entrada exclusiva y medios protegidos no se pueden automatizar de manera confiable desde un proceso de usuario normal.

Chrome abre el perfil incorrecto

• Pide a ChatGPT que llame a open_url o browser_control con el nombre del directorio del perfil de Chrome, como Default o Profile 2.

Desinstalación y revocación

Ejecuta el acceso directo del escritorio Uninstall Unlimited Agent. Detiene/elimina el runtime local, elimina las entradas de inicio automático, elimina la credencial cifrada y borra el directorio de instalación.

Luego revoca la clave restringida dedicada en OpenAI Platform y elimina el túnel si ya no se usará. La revocación es importante si el PC o la cuenta de Windows pueden estar comprometidos.

Seguridad y licencia

Lee SECURITY.md antes de habilitar el acceso completo. Los informes de seguridad deben usar el informe de vulnerabilidades privado de GitHub, no problemas públicos.

Unlimited Agent está disponible bajo la Licencia MIT. Los avisos de runtime incluidos están en THIRD_PARTY_NOTICES.md.