Skip to content

chore(upstream): avaliação da animação de pareamento QR e túnel remoto (pair-qr-build) #258

Open

Description

@alltomatos

1. Contexto e Escopo da Revisão

  • Repositório Upstream: anomalyco/opencode (branch dev e branch pair-qr-build)
  • Range / Branch: upstream/pair-qr-build (16079efe34)
  • Repositório do Fork: alltomatos/opencode (branch dev)
  • Ambientes Locais: D:\dev\opencode-ori\opencode e D:\dev\ori\opencode sincronizados.

2. Critérios de Avaliação e Adoção

Critério Classificação Diretriz para o Fork
A. UX de CLI e Pareamento Remoto Prioridade Média/Visual Avaliar animação de construção do QR Code durante a emissão de certificados OpenTunnel em opencode pair --remote.
B. Compatibilidade com TTY e Terminais sem Cor Requisito Obrigatório Respeitar NO_COLOR, TERM=dumb e ambientes não-TTY (como CI ou processos headless).

3. Avaliação de Impacto das Novas Modificações

📲 1. Animação de Construção do QR Code em Pareamento Remoto (feat(cli): #pair-qr-build)

  • Commit: 16079efe34
  • Arquivos: packages/cli/src/commands/handlers/pair.ts, packages/cli/src/services/remote-tunnel.ts, packages/cli/src/ui/qr-build.ts
  • Descrição:
    • Em primeiras execuções de opencode pair --remote, o provisionamento do túnel OpenTunnel demora cerca de ~25 segundos aguardando emissão do certificado.
    • O CLI agora renderiza uma animação visual bloco a bloco no terminal mostrando as etapas ("Reserving address", "Making key", "Getting certificate", "Connecting"), substituindo a animação pelo QR code real final assim que o túnel é conectado.
  • Impacto no Fork:
    • Positivo (UX Visual): Proporciona feedback visual muito mais claro para o usuário durante a espera de conexão do app mobile/remoto.
    • Não afeta ambientes sem TTY ou pipelines de CI (desativa automaticamente com process.stdout.isTTY !== true ou NO_COLOR). Risco de regressão baixo.

4. Plano de Ação Recomendado

  1. Acompanhar o merge de pair-qr-build na branch dev do upstream.
  2. Portar packages/cli/src/ui/qr-build.ts e integração no handler de pareamento para enriquecer a experiência de pareamento com o app mobile do fork.
  3. Validar execução em terminais Windows (PowerShell, Windows Terminal) e macOS/Linux.

Activity

  1. added
    ui-uxUI/UX polish and consistency work
    ready-for-agentScoped and ready for an agent to pick up
    on Oct 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    ready-for-agentScoped and ready for an agent to pick upui-uxUI/UX polish and consistency work

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions