Tethered

Sesiones de tareas de IA

Estas integraciones conectan clientes locales de IA a Tethered 1.2.0 o posterior, que incluye General → IA → Sesiones de tareas y el adaptador MCP incluido. Los resultados de instalación y ciclo de vida del cliente varían; consulta cada cliente a continuación y el registro de validación con fecha.

Habilita Sesiones de tareas en Tethered y crea un perfil de tarea. Todos los perfiles de tarea guardados están disponibles mientras Sesiones de tareas esté habilitado. Mantén Tethered ejecutándose en el mismo Mac y con la misma cuenta de macOS que tu aplicación de IA. Las sesiones de tareas requieren acceso Pro y los permisos necesarios para el perfil seleccionado.

Tethered permite que un asistente aplique un perfil creado por el usuario durante compilaciones locales, suites de pruebas o trabajos de procesamiento de datos. Los perfiles pueden solicitar el modo Automático, Bajo consumo o Alto rendimiento donde sea compatible y mantener el Mac despierto usando Caffeinate. Los usuarios también pueden despriorizar aplicaciones seleccionadas u otras aplicaciones en segundo plano, suspender aplicaciones elegibles en segundo plano o suspender aplicaciones por encima de un umbral de memoria configurado. Los controles de procesos pueden aplicarse durante toda una sesión o activarse cuando macOS informe presión de memoria de advertencia o crítica. Las excepciones de aplicaciones configuradas, la protección de la aplicación en primer plano y la protección del árbol de procesos del cliente de IA limitan qué procesos se ven afectados.

El asistente puede listar perfiles guardados, iniciar una sesión, inspeccionar el estado, informar progreso y eventos de salvaguarda, y finalizar su sesión. Finalizar o expirar una sesión libera los controles temporales y reanuda las aplicaciones que Tethered suspendió. Los usuarios eligen la configuración del perfil y pueden finalizar sesiones directamente en Tethered. Las salvaguardas configuradas pueden advertir sobre fallos repetidos o salida, inactividad, falta de progreso informado, tiempo de ejecución excesivo y presión de memoria sostenida; las solicitudes de pausa/cancelación requieren cooperación del cliente de IA. El monitoreo de temperatura, las alertas y la protección de ventiladores configurada permanecen activos. La política de carga permanece independiente de las sesiones de tareas.

Por ejemplo: "Usa mi perfil de Compilación mientras compilo, mantén el Mac despierto y finaliza la sesión cuando termine la compilación." Elige una duración finita si quieres que la expiración proporcione un respaldo cuando el agente no finalice su sesión.

Instalación

Todos los clientes requieren la aplicación Tethered instalada y ejecutándose, acceso Pro, Sesiones de tareas habilitado y un perfil guardado. Selecciona tu cliente a continuación. Estas rutas de instalación directa no requieren un listado en un mercado público.

Para paquetes basados en repositorios, descarga o clona este repositorio y reemplaza /path/to/Tethered con su directorio local. Si ya configuraste un servidor MCP directo de Tethered, deshabilita esa entrada antes de instalar un plugin para evitar herramientas duplicadas.

Claude Desktop

Descarga tethered-0.2.6.mcpb e impórtalo en Claude Desktop. Este paquete público inicia el adaptador desde la aplicación instalada. Una exportación generada por la aplicación es otra opción; sigue su README incluido.

Verificación registrada: La importación, la aprobación de herramientas y un ciclo de vida de inicio/estado/fin de un minuto pasaron con una compilación anterior de cuatro herramientas. El paquete actual de ocho herramientas tiene verificación de adaptador compartida; su ciclo de vida completo de Claude no se ha repetido. Consulta resultados de validación y fechas.

Codex de escritorio y CLI

Ejecuta codex plugin marketplace add /path/to/Tethered, luego instala Tethered desde el código fuente local de Tethered en el directorio Plugins. Abre un nuevo chat. La configuración manual usa TOML en ~/.codex/config.toml.

Verificación registrada: La instalación interactiva de CLI, las aprobaciones por llamada y el ciclo de vida pasaron. El usuario verificó el descubrimiento de perfiles de plugin de escritorio y el estado inactivo. La reutilización de conversación y el borrado completo de la versión 0.2.0 pasaron en CLI; estos son distintos de las pruebas de suspensión compartidas actuales. Consulta resultados de validación y fechas.

Claude Code

Ejecuta claude plugin marketplace add /path/to/Tethered, luego claude plugin install tethered@tumerit-tethered. Abre una nueva sesión.

Verificación registrada: La validación del manifiesto nativo pasó. Las llamadas de modelo de extremo a extremo fueron bloqueadas por crédito de cuenta insuficiente; no se cuentan como aprobadas. Consulta resultados de validación y fechas.

Cursor

Copia Integrations/cursor a ~/.cursor/plugins/local/tethered, luego vuelve a abrir Cursor y revisa sus permisos de plugin y herramientas. La configuración manual se puede fusionar a través de la configuración MCP de Cursor.

Verificación registrada: El descubrimiento de plugin y un ciclo de vida de un minuto pasaron después de reiniciar el cliente para resolver un error de política de cuenta. Consulta resultados de validación y fechas.

VS Code / Copilot

Instala la vista previa .vsix a través de Extensiones: Instalar desde VSIX, luego revisa los permisos de herramientas MCP en el agente local. La configuración manual usa una entrada JSON servers a través de MCP: Abrir configuración de usuario o .vscode/mcp.json del espacio de trabajo.

Verificación registrada: La instalación de VSIX, el descubrimiento de cuatro herramientas, las aprobaciones y un ciclo de vida de un minuto pasaron. Consulta resultados de validación y fechas.

Google Antigravity

Copia Integrations/antigravity a ~/.gemini/config/plugins/tethered, luego actualiza los servidores MCP en Configuración → Personalizaciones.

Verificación registrada: La instalación del plugin, las llamadas de solo lectura y un ciclo de vida de un minuto pasaron. Esto no resuelve la elegibilidad de cuenta de Gemini CLI. Consulta resultados de validación y fechas.

Gemini CLI

Ejecuta gemini extensions install /path/to/Tethered/Integrations/gemini-cli, luego abre una nueva sesión.

Verificación registrada: La validación del manifiesto y los avisos de permisos/instalación pasaron. Las llamadas de modelo fueron bloqueadas por UNSUPPORTED_CLIENT; un intento aislado con la CLI actual encontró el mismo bloqueador de elegibilidad de cuenta. Consulta resultados de validación y fechas.

No se requiere entrada de token, compilación de adaptador ni instalación de runtime de lenguaje. Cada paquete de repositorio encuentra la aplicación Tethered instalada a través de macOS e inicia su adaptador incluido. Mover o actualizar Tethered no requiere regenerar estos paquetes de lanzamiento.

Estas herramientas se ejecutan en tu Mac. Los chats solo de navegador y los procesos de herramientas en una máquina remota, VM en la nube o contenedor no pueden usar esta conexión local.

Primera conexión

Pregunta a tu aplicación de IA:

Usa Tethered para listar los perfiles de tareas guardados e informar el estado de la sesión. No inicies una sesión todavía.

Luego pídele que inicie un perfil de prueba guardado durante un minuto, informe el estado y finalice esa sesión exacta. Puedes ver la sesión en Tethered o finalizarla allí. Si las herramientas no están disponibles, verifica que el plugin esté habilitado, que la sesión de IA sea nueva y que la compilación de Tethered instalada contenga su adaptador MCP.

La inferencia en la nube por sí sola no requiere una sesión de rendimiento. Las integraciones guían a los modelos para usar perfiles guardados para trabajo local sustancial o cuando se solicite explícitamente. Las instrucciones del modelo no garantizan una llamada de herramienta al inicio o al final de cada aviso.

Configuración manual

Si tu aplicación de IA no tiene instalador de plugin, habilita Sesiones de tareas en Tethered, elige la aplicación en Configuración manual y luego usa una de estas opciones:

• Abrir configuración abre el diálogo de instalación del cliente compatible. Revísalo y apruébalo allí.
• Exportar integración guarda un paquete o configuración y un README específico de la plataforma. Importa el archivo .mcpb en Claude Desktop, instala el archivo .vsix en VS Code o sigue las instrucciones exportadas para tu aplicación seleccionada.
• Copiar configuración copia solo una entrada de servidor. Fúndela en la configuración existente del cliente; conserva cualquier otro servidor.

Codex: configuración manual

TOML, ~/.codex/config.toml. Fusiona la entrada de servidor copiada en la configuración existente.

Claude Desktop: configuración manual

JSON, ~/Library/Application Support/Claude/claude_desktop_config.json. Fusiona la entrada de servidor copiada en la configuración existente.

Cursor, LM Studio, Windsurf, Cline y Kiro: configuración manual

JSON a través de la configuración MCP del cliente. Fusiona la entrada de servidor copiada en la configuración existente.

VS Code / Copilot: configuración manual

Entrada JSON servers a través de MCP: Abrir configuración de usuario o .vscode/mcp.json del espacio de trabajo. Fusiona la entrada de servidor copiada en la configuración existente.

Zed: configuración manual

Entrada JSON context_servers a través de la configuración de Zed. Fusiona la entrada de servidor copiada en la configuración existente.

OpenCode y Kilo Code: configuración manual

Entrada JSON mcp a través de su editor de configuración. Fusiona la entrada de servidor copiada en la configuración existente.

Continue: configuración manual

Entrada YAML mcpServers a través del editor de configuración de Continue. Fusiona la entrada de servidor copiada en la configuración existente.

Otros clientes MCP locales: configuración manual

Entrada JSON mcpServers si el cliente lo admite. Fusiona la entrada de servidor copiada en la configuración existente.

Para Codex, una aplicación Tethered instalada en /Applications produce:

[mcp_servers.tethered]
command = "/Applications/Tethered.app/Contents/MacOS/tethered-mcp"
args = []

Las configuraciones copiadas usan la ubicación actual de la aplicación. Copia de nuevo si mueves Tethered. Las ediciones de perfil, los cambios de sesión y los reinicios de aplicación no requieren una nueva configuración. La exportación de Claude Desktop incluye un adaptador copiado, así que vuelve a exportar y reinstalar ese paquete cuando su adaptador necesite actualizarse. Las exportaciones de escritorio generadas por la aplicación están destinadas al Mac que las exporta; no son paquetes universales de lanzamiento en mercados.

Suspensión y restauración probadas

El trabajador instalado detuvo y reanudó una aplicación de accesorio desechable y su hijo. Un perfil guardado también suspendió ambos procesos después de una presión de memoria simulada de advertencia de macOS y los reanudó después de que la presión volviera a la normalidad. Consulta los resultados y límites posteriores a la prueba. Estas comprobaciones establecen la suspensión y restauración en el Mac probado; la suspensión no libera la memoria de la aplicación y no se midió una mejora de rendimiento.

Disponibilidad

Estos son paquetes de vista previa distribuidos directamente, no listados aprobados en mercados públicos. Los clientes solo de configuración usan el respaldo de Configuración manual anterior. Los paquetes de Claude Desktop son exportados por Tethered para el Mac que los exporta. Las comprobaciones de instalación y ciclo de vida de sesión de VS Code/Copilot y Antigravity pasaron; consulta el registro de verificación para las comprobaciones restantes.

• Empaquetado de plugin de Codex
• Distribución de plugin de Claude Code
• Plugins de Cursor
• Extensiones de Gemini CLI

Elegir comportamiento para un chat

Pregunta "Configura Tethered para este chat." El asistente lista los perfiles guardados y te pide que elijas uno, cuándo activarlo y cuándo finalizar las sesiones. Elige cada aviso, solo solicitudes explícitas o criterios que describas. Elige finalizar después de cada respuesta/tarea o deja que la sesión expire entre respuestas. Puedes cambiar el perfil o dejar de usarlo en cualquier momento.

Por ejemplo: "Usa Trabajo pesado para cada aviso en este chat y deja que las sesiones expiren." El asistente usa tu duración guardada, reutiliza su sesión activa sin extenderla e inicia una nueva sesión después de la expiración en el siguiente aviso que coincida. La sesión activa de un chat diferente nunca se toma.

Estas son preferencias de conversación implementadas a través de instrucciones del modelo, no un panel de configuración nativo de plugin. Inicia un chat nuevo después de actualizar. Las elecciones no se comparten entre chats ni se escriben en archivos de proyecto. Los permisos del host, el comportamiento del modelo y el contexto de la conversación determinan si las instrucciones se ejecutan; la expiración automática sigue siendo el respaldo. VS Code y los clientes de solo configuración reciben este flujo de trabajo a través de las instrucciones de inicialización MCP del adaptador Tethered actualizado. Con un adaptador más antiguo, incluya task-workflow.md en el contexto del chat. Esta actualización del flujo de trabajo requiere un adaptador Tethered recién compilado; actualizar solo el plugin actualiza los clientes basados en habilidades.

Para detener todas las sesiones Tethered activas, diga "Clear all Tethered task sessions." El asistente llama a clear_task_sessions, lo que finaliza la sesión activa independientemente de la propiedad del chat y desactiva la selección de activación futura de este chat. El comando es seguro de repetir cuando está inactivo. Requiere la aplicación Tethered actualizada y el adaptador incluido; las instalaciones 1.2.0 sin esa herramienta deben usar el control manual End de Tethered. Otros chats conservan sus preferencias y pueden iniciar otra sesión en un mensaje posterior.