Se npm não for conveniente no seu ambiente, baixe o pacote adequado em Releases, descompacte e instale:

tar -xzf ccb-*.tar.gz
cd ccb-*
./install.sh install

A instalação por fonte é indicada apenas para desenvolvimento ou fallback temporário:

git clone https://github.com/SeemSeam/claude_codex_bridge.git
cd claude_codex_bridge
./install.sh install

A instalação por fonte aponta os comandos globais ccb / ask de volta para o checkout. Usuários comuns devem preferir o pacote npm.

O CCB 8.6.6 inclui o código Flutter do CCB Mobile em mobile/ e publica o APK Android pelo GitHub Releases:

• Baixar CCB Mobile v8.6.6 APK
• Fonte do app: mobile/app
• Fonte do gateway servidor: lib/mobile_gateway

O app do telefone é um controlador remoto para projetos CCB reais rodando em um servidor. Ele pode descobrir projetos montados pelo mobile gateway server-wide, trocar windows e agents, renderizar contexto de conversa, enviar texto via entrada pane-native, abrir uma visão terminal e enviar/baixar imagens e documentos pelo gateway autenticado.

Limite de segurança:

• O gateway CCB faz bind apenas em loopback, por exemplo 127.0.0.1:8787.
• O acesso remoto usa Tailscale Serve, não Tailscale Funnel.
• O CCB não armazena senhas Tailscale, OAuth tokens, admin API tokens, nem modifica ACLs/grants do tailnet automaticamente.
• O telefone recebe apenas os scopes autorizados pelo pairing profile, como view, content, terminal, file upload e file download.

• Adiciona Relay móvel com criptografia ponta a ponta, convites de uso único, streams multiplexados e modos oficial ou auto-hospedado.
• Move a escolha de Tailscale, LAN privada ou Relay para ccb update mobile; o telefone apenas lê o QR ou informa um código.
• Verifica metadados oficiais do GitHub, tamanho e SHA-256 antes de entregar uma atualização APK assinada ao Android.
• Preserva a identidade após mover projetos, acompanha o tema do sistema e integra a reconexão opcional e limitada do Codex.

• Centraliza upgrades de providers suportados em ccb update, com verificação exata, recusa e salto por versão, sem reiniciar panes ativos.
• Retira caches de software Claude/Gemini por projeto e limpa apenas dados legados com propriedade comprovada; projetos ativos, sessões e autenticação são preservados.
• Permite uma porta loopback estável e uma fonte de token protegida para a Config UI sem exibir o valor do token.
• Preserva finalizadores de shutdown durante a parada do servidor e adota um layout Yazi compacto de duas colunas no Rich mode.
• Sincroniza CLI, npm, Linux, macOS, Android e todos os artefatos de release com 8.3.1.

• Vincula Kimi, Claude e Qoder aos contratos nativos de turno, ativação, sessão e conclusão.
• Adiciona follow-ups para o job ativo exato, fases de execução correlacionadas, diagnóstico de inbounds órfãos e cancelamento terminal.
• Herda extensões de providers e plugins do Copilot com proteção explícita de ownership dos assets projetados.
• Delega upgrades gerenciados por npm ao próprio npm e torna conservadora a remoção de worktrees que contêm apenas marcadores.
• Mantém chat e terminal Mobile no workspace do projeto selecionado e sincroniza todas as superfícies de release com 8.3.0.

• Adiciona cercas de geração de inicialização, prova limitada de prontidão e diagnósticos de operações e linha do tempo.
• Interrompe ciclos de reinício sem saída por autenticação do provider e mostra a ação de login necessária.
• Adiciona conexão Android em segundo plano opcional e um único estado de resposta ativa por Agent.
• Sincroniza os artefatos Linux, macOS, npm e Android assinado com 8.2.1.

• Reduz trabalho repetido na inicialização do ccbd sem enfraquecer verificações de lifecycle e ownership.
• Corrige o fullscreen do Grok, preserva o tipo de credencial Claude, estabiliza escolhas de model/thinking e reforça a entrega ask/reply do Codex.
• Melhora recovery, chat, terminal, anexos, downloads e FCM no Mobile; sincroniza artifacts Linux, macOS, npm e Android assinado com 8.2.0.

• O README.md raiz voltou a ser a página GitHub em inglês.
• READMEs localizados agora ficam em README/, com chinês em zh.md.
• Links do Mobile App, package metadata e release notes apontam para o APK 8.0.14.

• Testes mobile host registry agora colocam Unix sockets temporários em um caminho curto /tmp/ccb-sock-*, evitando falhas AF_UNIX path too long no macOS CI.
• ccb update mobile, links do README, package metadata e o mobile release manifest agora apontam para o APK 8.0.12.
• O v8.0.12 introduziu READMEs multilíngues com a mesma estrutura de seções; os arquivos localizados atuais ficam no diretório README/.

• O código Flutter do CCB Mobile entrou oficialmente neste repositório, com o APK Android publicado via GitHub Releases.
• Foram adicionados descoberta server-wide de projetos mobile, pairing, rotas gateway autenticadas, entrada pane-native, renderização de contexto de conversa, acesso terminal e upload/download de imagens e documentos.
• ccb update mobile virou o ponto de entrada unificado de onboarding Tailscale Tailnet, mantendo o gateway loopback-only, sem Funnel, sem armazenar tokens e sem modificar ACLs/grants automaticamente.

• Os release artifacts agora incluem o Rust ccb-runtime-accelerator opcional; agents Codex instalados não retornam silenciosamente ao Python hot path quando o sidecar é esperado.
• Quando o caminho do projeto torna o Unix socket path longo demais, o accelerator socket migra automaticamente para uma raiz runtime curta por usuário.
• Callback repair e invalidação do cache de binding Codex foram reforçados, com evidências de regressão, long-idle Codex soak, callback Claude e integração mixed-provider.

• Chamadas ask longas agora continuam aguardando resultados reais de provider/completion, em vez de terminar como incomplete/heartbeat_timeout apenas por diagnósticos heartbeat.
• No-terminal timeouts pane-backed de Codex, Claude e Gemini agora são opt-in explícito por padrão, mantendo disponíveis políticas explícitas de reliability timeout.
• Um smoke source-runtime ask de 32 minutos confirmou que uma tarefa pode permanecer running por mais de 30 minutos e depois concluir com result_message, sem evidência de heartbeat_timeout ou incomplete.