Impulse Pair

Edite o mesmo código em tempo real: você no VS Code, seu colega no Impulse Code. Sem copiar o projeto inteiro e sem instalar o Impulse no computador convidado.

Recursos

• Edição simultânea com sincronização Yjs e salvamento no computador anfitrião.
• Arquivos compartilhados organizados no Explorador do VS Code.
• Cursores e seleções dos participantes no código.
• Comando para acompanhar o arquivo e a posição do anfitrião.
• Aprovação de entrada para edição ou somente leitura; remoção pelo anfitrião.
• Acesso em redes diferentes por convite temporário, quando o anfitrião ativa a internet.

Requisitos

VS Code desktop 1.96 ou mais recente. O pacote não utiliza módulos nativos específicos de plataforma e foi validado no VS Code em Linux; o teste nativo em Windows e macOS ainda está pendente. Não funciona no vscode.dev. O anfitrião precisa usar uma versão do Impulse Code que inclua o botão Pair e manter o aplicativo aberto durante a sessão. Esta extensão é o cliente convidado; ela não hospeda uma sessão sozinha nem conecta dois VS Codes entre si.

Primeira versão pública, em prévia. Não possui vínculo com a extensão Microsoft Live Share.

Como começar

1. Instale Impulse Pair pela aba Extensões do VS Code. Para uma instalação manual, use Extensões → ⋯ → Instalar do VSIX… e selecione impulse-pair-0.1.0.vsix.
2. Abra a paleta com Ctrl+Shift+P e execute Impulse Pair: Entrar na sessão.
3. Cole o convite e informe seu nome. Aguarde o anfitrião aprovar sua entrada.
4. Abra arquivos em Explorador → Impulse Pair. Edições são compartilhadas ao digitar e salvas automaticamente no computador do anfitrião. Ctrl+S confirma o salvamento.
5. Use Impulse Pair: Acompanhar anfitrião para ir ao arquivo e posição dele. Execute novamente para parar; começar a editar também para o acompanhamento.
6. Para sair, execute Impulse Pair: Sair da sessão.

O que é compartilhado

Arquivos de código de até 512 KB, cursores e seleções. O anfitrião aprova edição ou somente leitura e pode remover participantes. A árvore verifica novos arquivos a cada seis segundos; Atualizar arquivos antecipa a verificação. Não há criação/exclusão remota, terminal, banco, Git remoto, chat, LSP remoto nem compartilhamento de servidores nesta versão. Extensões locais de linguagem podem ter suporte limitado aos documentos virtuais.

Conexão e privacidade

Em redes diferentes, o anfitrião ativa o acesso pela internet (túnel temporário Cloudflare com TLS). O convite contém um segredo temporário: envie apenas aos participantes. A conexão não possui criptografia de ponta a ponta; o provedor do túnel termina TLS. A porta do anfitrião escuta somente em loopback. Encerrar a sessão invalida o convite e encerra o túnel.

Arquivos .env, credenciais, chaves, bancos locais, dependências e diretórios gerados são bloqueados por padrão. Revise os arquivos de código antes de compartilhar: segredos escritos diretamente no código também serão visíveis. Um participante autorizado pode copiar os arquivos que abriu.

Desconexão

Não há reconexão ou recuperação offline automática nesta versão. Se desconectar durante uma edição, preserve o conteúdo local antes de fechar a aba e entre novamente com um convite ativo. Abas antigas não passam a pertencer à nova sessão.

Dados e privacidade

O cliente envia ao computador anfitrião o nome escolhido, os caminhos dos arquivos abertos, as edições e as posições do cursor. Não há conta própria do Impulse, publicidade ou telemetria de uso adicionada por esta extensão. A sessão pela internet passa pelo túnel Cloudflare escolhido pelo anfitrião. Os arquivos permanecem salvos no projeto anfitrião; o VS Code pode manter cópias temporárias e backups locais conforme suas configurações. Não compartilhe credenciais em código ou no convite.

Ajuda

• Conexão recusada: peça um novo convite de uma sessão ativa. Em redes diferentes, confirme que o anfitrião ativou o acesso pela internet antes de copiar o convite.
• Aguardando aprovação: o anfitrião precisa aceitar sua solicitação no painel Pair.
• Não consigo editar: sua entrada pode ter sido aprovada como somente leitura.
• Arquivo não aparece: arquivos ignorados, tipos não permitidos, credenciais e binários ficam fora do compartilhamento. A árvore verifica novos arquivos a cada seis segundos; o botão Atualizar arquivos antecipa essa verificação.
• Sugestões de linguagem limitadas: os arquivos são documentos virtuais. O suporte depende das extensões locais e não inclui um servidor de linguagem remoto.

Para relatar um problema, use a seção de perguntas e respostas da página da extensão. Não envie convites ativos, senhas ou código privado no relato.

Desenvolvimento

Na raiz do Impulse Code: node scripts/build-pair-extension.cjs. Para empacotar: cd vscode-pair e npx @vscode/vsce package --no-dependencies --allow-missing-repository --out ../artifacts/impulse-pair-0.1.0.vsix. O bundle inclui Yjs e ws; funciona no VS Code desktop em Windows, Linux e macOS (não no vscode.dev).