Tethered

Sessões de tarefas de IA

Estas integrações conectam clientes de IA locais ao Tethered 1.2.0 ou posterior, que inclui Geral → IA → Sessões de tarefas e o adaptador MCP integrado. A instalação do cliente e os resultados do ciclo de vida variam; veja cada cliente abaixo e o registro de validação datado.

Ative as Sessões de tarefas no Tethered e crie um perfil de tarefa. Todos os perfis de tarefa salvos ficam disponíveis enquanto as Sessões de tarefas estiverem ativadas. Mantenha o Tethered em execução no mesmo Mac e na mesma conta macOS que o seu aplicativo de IA. As Sessões de tarefas exigem acesso Pro e as permissões necessárias para o perfil selecionado.

O Tethered permite que um assistente aplique um perfil criado pelo usuário durante builds locais, suítes de teste ou trabalhos de processamento de dados. Os perfis podem solicitar o modo Automático, Baixo consumo ou Alto desempenho quando suportado e manter o Mac acordado usando o Caffeinate. Os usuários também podem despriorizar aplicativos selecionados ou outros aplicativos em segundo plano, suspender aplicativos elegíveis em segundo plano ou suspender aplicativos acima de um limite de memória configurado. Os controles de processo podem ser aplicados durante toda a sessão ou ativados quando o macOS relatar pressão de memória de aviso ou crítica. Exceções de aplicativos configuradas, proteção do aplicativo em primeiro plano e proteção para a árvore de processos do cliente de IA limitam quais processos são afetados.

O assistente pode listar perfis salvos, iniciar uma sessão, inspecionar o status, relatar progresso e eventos de proteção e encerrar sua sessão. Encerrar ou expirar uma sessão libera os controles temporários e retoma os aplicativos que o Tethered suspendeu. Os usuários escolhem as configurações do perfil e podem encerrar sessões diretamente no Tethered. As proteções configuradas podem alertar sobre falhas repetidas ou saída, inatividade, falta de progresso relatado, tempo de execução excessivo e pressão de memória sustentada; solicitações de pausa/cancelamento exigem cooperação do cliente de IA. O monitoramento de calor, alertas e proteção de ventilador configurada permanecem ativos. A política de carregamento permanece independente das sessões de tarefas.

Por exemplo: "Use meu perfil de Build ao compilar, mantenha o Mac acordado e encerre a sessão quando o build terminar." Escolha uma duração finita se quiser que a expiração forneça um fallback quando o agente não encerrar sua sessão.

Instalação

Todos os clientes exigem o aplicativo Tethered instalado e em execução, acesso Pro, Sessões de tarefas ativadas e um perfil salvo. Selecione seu cliente abaixo. Estas rotas de instalação direta não exigem uma listagem em marketplace público.

Para pacotes baseados em repositório, baixe ou clone este repositório e substitua /path/to/Tethered pelo seu diretório local. Se você já configurou um servidor MCP Tethered direto, desative essa entrada antes de instalar um plugin para evitar ferramentas duplicadas.

Claude Desktop

Baixe tethered-0.2.6.mcpb e importe-o no Claude Desktop. Este pacote público inicia o adaptador a partir do aplicativo instalado. Uma exportação gerada pelo aplicativo é outra opção; siga o README incluído.

Verificação registrada: Importação, aprovação de ferramentas e um ciclo de vida de um minuto de início/status/fim passaram com uma versão anterior de quatro ferramentas. O pacote atual de oito ferramentas tem verificação de adaptador compartilhada; seu ciclo de vida completo no Claude não foi repetido. Veja resultados de validação e datas.

Codex desktop e CLI

Execute codex plugin marketplace add /path/to/Tethered e depois instale o Tethered a partir da fonte local do Tethered no diretório Plugins. Abra um novo chat. A configuração manual usa TOML em ~/.codex/config.toml.

Verificação registrada: Instalação interativa via CLI, aprovações por chamada e ciclo de vida passaram. O usuário verificou a descoberta de perfil do plugin desktop e o status inativo. A reutilização de conversa da versão 0.2.0 e a limpeza total passaram na CLI; estes são distintos dos testes de suspensão compartilhados atuais. Veja resultados de validação e datas.

Claude Code

Execute claude plugin marketplace add /path/to/Tethered e depois claude plugin install tethered@tumerit-tethered. Abra uma nova sessão.

Verificação registrada: A validação de manifesto nativo passou. As chamadas de modelo de ponta a ponta foram bloqueadas por crédito de conta insuficiente; elas não são contadas como aprovações. Veja resultados de validação e datas.

Cursor

Copie Integrations/cursor para ~/.cursor/plugins/local/tethered e depois reabra o Cursor e revise as permissões de plugin e ferramentas. A configuração manual pode ser mesclada através das configurações de MCP do Cursor.

Verificação registrada: Descoberta de plugin e um ciclo de vida de um minuto passaram após reiniciar o cliente para resolver um erro de política de conta. Veja resultados de validação e datas.

VS Code / Copilot

Instale a prévia .vsix através de Extensões: Instalar do VSIX e depois revise as permissões de ferramentas MCP no agente local. A configuração manual usa uma entrada JSON servers através de MCP: Abrir Configuração do Usuário ou .vscode/mcp.json do workspace.

Verificação registrada: Instalação do VSIX, descoberta de quatro ferramentas, aprovações e um ciclo de vida de um minuto passaram. Veja resultados de validação e datas.

Google Antigravity

Copie Integrations/antigravity para ~/.gemini/config/plugins/tethered e depois atualize os servidores MCP em Configurações → Personalizações.

Verificação registrada: Instalação do plugin, chamadas somente leitura e um ciclo de vida de um minuto passaram. Isso não resolve a elegibilidade de conta do Gemini CLI. Veja resultados de validação e datas.

Gemini CLI

Execute gemini extensions install /path/to/Tethered/Integrations/gemini-cli e depois abra uma nova sessão.

Verificação registrada: Validação de manifesto e prompts de permissão/instalação passaram. As chamadas de modelo foram bloqueadas por UNSUPPORTED_CLIENT; uma tentativa isolada com o CLI atual encontrou o mesmo bloqueador de elegibilidade de conta. Veja resultados de validação e datas.

Nenhuma entrada de token, compilação de adaptador ou instalação de runtime de linguagem é necessária. Cada pacote de repositório encontra o aplicativo Tethered instalado através do macOS e inicia seu adaptador integrado. Mover ou atualizar o Tethered não exige regenerar esses pacotes de lançamento.

Estas ferramentas são executadas no seu Mac. Chats somente em navegador e processos de ferramentas em uma máquina remota, VM em nuvem ou contêiner não podem usar esta conexão local.

Primeira conexão

Pergunte ao seu aplicativo de IA:

Use o Tethered para listar perfis de tarefa salvos e relatar o status da sessão. Não inicie uma sessão ainda.

Depois, peça para iniciar um perfil de teste salvo por um minuto, relatar o status e encerrar exatamente essa sessão. Você pode observar a sessão no Tethered ou encerrá-la lá. Se as ferramentas estiverem indisponíveis, verifique se o plugin está ativado, se a sessão de IA é nova e se a versão instalada do Tethered contém seu adaptador MCP.

A inferência em nuvem sozinha não exige uma sessão de desempenho. As integrações orientam os modelos a usar perfis salvos para trabalho local substancial ou quando explicitamente solicitado. As instruções do modelo não garantem uma chamada de ferramenta no início ou no fim de cada prompt.

Configuração manual

Se o seu aplicativo de IA não tiver um instalador de plugin, ative as Sessões de tarefas no Tethered, escolha o aplicativo em Configuração Manual e depois use uma destas opções:

• Abrir Configuração abre o diálogo de instalação do cliente suportado. Revise e aprove lá.
• Exportar Integração salva um pacote ou configuração e um README específico da plataforma. Importe o arquivo .mcpb no Claude Desktop, instale o arquivo .vsix no VS Code ou siga as instruções exportadas para o aplicativo selecionado.
• Copiar Configuração copia apenas uma entrada de servidor. Mescle-a nas configurações existentes do cliente; preserve quaisquer outros servidores.

Codex: configuração manual

TOML, ~/.codex/config.toml. Mescle a entrada de servidor copiada na configuração existente.

Claude Desktop: configuração manual

JSON, ~/Library/Application Support/Claude/claude_desktop_config.json. Mescle a entrada de servidor copiada na configuração existente.

Cursor, LM Studio, Windsurf, Cline e Kiro: configuração manual

JSON através das configurações de MCP do cliente. Mescle a entrada de servidor copiada na configuração existente.

VS Code / Copilot: configuração manual

Entrada JSON servers através de MCP: Abrir Configuração do Usuário ou .vscode/mcp.json do workspace. Mescle a entrada de servidor copiada na configuração existente.

Zed: configuração manual

Entrada JSON context_servers através das configurações do Zed. Mescle a entrada de servidor copiada na configuração existente.

OpenCode e Kilo Code: configuração manual

Entrada JSON mcp através do editor de configuração deles. Mescle a entrada de servidor copiada na configuração existente.

Continue: configuração manual

Entrada YAML mcpServers através do editor de configuração do Continue. Mescle a entrada de servidor copiada na configuração existente.

Outros clientes MCP locais: configuração manual

Entrada JSON mcpServers se suportada pelo cliente. Mescle a entrada de servidor copiada na configuração existente.

Para Codex, um aplicativo Tethered instalado em /Applications produz:

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

Configurações copiadas usam a localização atual do aplicativo. Copie novamente se você mover o Tethered. Edições de perfil, mudanças de sessão e reinicializações do aplicativo não exigem uma nova configuração. A exportação do Claude Desktop inclui um adaptador copiado, então reexporte e reinstale esse pacote quando o adaptador precisar de atualização. Exportações de desktop geradas pelo aplicativo são destinadas ao Mac que as exportou; não são pacotes universais de lançamento em marketplace.

Suspensão e restauração testadas

O worker instalado parou e retomou um aplicativo descartável de fixture e seu filho. Um perfil salvo também suspendeu ambos os processos após pressão simulada de aviso do macOS e os retomou após a pressão voltar ao normal. Veja os resultados e limites pós-teste. Essas verificações estabelecem suspensão e restauração no Mac testado; a suspensão não libera a memória do aplicativo e uma melhoria de desempenho não foi medida.

Disponibilidade

Estes são pacotes de prévia distribuídos diretamente, não listagens aprovadas em marketplace público. Clientes somente com configuração usam o fallback de Configuração Manual acima. Os pacotes do Claude Desktop são exportados pelo Tethered para o Mac que os exportou. As verificações de instalação e ciclo de vida de sessão do VS Code/Copilot e Antigravity passaram; veja o registro de verificação para as verificações restantes.

• Empacotamento do plugin Codex
• Distribuição do plugin Claude Code
• Plugins Cursor
• Extensões Gemini CLI

Escolher comportamento para um chat

Pergunte "Configure o Tethered para este chat." O assistente lista perfis salvos e pede que você escolha um, quando ativá-lo e quando encerrar sessões. Escolha a cada prompt, somente solicitações explícitas ou critérios que você descrever. Escolha encerrar após cada resposta/tarefa ou deixe a sessão expirar entre respostas. Você pode mudar o perfil ou parar de usá-lo a qualquer momento.

Por exemplo: "Use Heavy Work para cada prompt neste chat e deixe as sessões expirarem." O assistente usa sua duração salva, reutiliza sua sessão ativa sem estendê-la e inicia uma nova sessão após a expiração no próximo prompt correspondente. A sessão ativa de um chat diferente nunca é assumida.

Estas são preferências de conversa implementadas através de instruções de modelo, não um painel de configurações nativo de plugin. Inicie um novo chat após atualizar. As escolhas não são compartilhadas entre chats nem gravadas em arquivos de projeto. Permissões do host, comportamento do modelo e contexto da conversa determinam se as instruções são executadas; a expiração automática permanece como fallback. VS Code e clientes somente de configuração recebem este fluxo de trabalho por meio das instruções de inicialização MCP do adaptador Tethered atualizado. Com um adaptador mais antigo, inclua task-workflow.md no contexto do chat. Esta atualização do fluxo de trabalho requer um adaptador Tethered recém-compilado; atualizar apenas o plugin atualiza clientes baseados em habilidades.

Para interromper todas as sessões Tethered ativas, diga "Limpar todas as sessões de tarefas Tethered." O assistente chama clear_task_sessions, que encerra a sessão ativa independentemente da propriedade do chat e desativa a seleção de ativação futura deste chat. O comando é seguro para repetir quando inativo. Ele requer o aplicativo Tethered atualizado e o adaptador incluído; instalações 1.2.0 sem essa ferramenta devem usar o controle manual de Encerramento do Tethered. Outros chats mantêm suas preferências e podem iniciar outra sessão em um prompt posterior.