App open-source para o OpenCode

O OpenCode chega à sua própria interface através do seu próprio fluxo de attach, sem qualquer multiplexer pelo meio e sem nada para ativar antes — a sessão que o Happier iniciou é a sessão à qual o opencode se volta a ligar, e a app continua a aceitar mensagens enquanto um terminal está pousado nela.

A outra metade da história são as credenciais: o OpenCode traz uma camada de fornecedores própria, por isso os perfis de Codex, de OpenAI, de subscrição Claude e de Anthropic que ligou uma vez ficam todos selecionáveis no início da sessão, e uma pool montada para outro agente acaba por ser útil aqui. A entrada da subscrição Claude aceita as duas formas que esta versão intermedeia — um início de sessão no navegador e um setup token — enquanto a da Anthropic continua a ser uma chave de API, e qual delas está a usar é escolhido quando a sessão começa, em vez de ser herdado da última conta com que esse computador ficou com sessão iniciada.

É no fork que a versão publicada dá espaço a este. Uma conversa do OpenCode pode receber um fork por inteiro e pode receber um fork a partir de uma mensagem específica — a diferença entre “tenta isso outra vez de outra maneira” e “volta a antes da terceira chamada de ferramenta e tenta isso outra vez de outra maneira”. As skills e os comandos de barra que guarda em .opencode/skills e .opencode/commands, ou dentro de ~/.config/opencode, são lidos como recursos de prompt e viajam com a sessão, por isso o que ensinou à CLI à secretária continua lá quando a sessão está a ser respondida a partir de um telemóvel.

O OpenCode é o agente de programação em terminal da SST e traz uma camada de fornecedores própria: aponta-o para um modelo a que já tem acesso e ele conduz esse modelo sobre o seu repositório. happier opencode executa o mesmo binário com as mesmas credenciais de opencode auth, na mesma diretoria.

O Happier fornece os dispositivos. Uma sessão que iniciou num terminal numa divisão pode ser lida e respondida a partir de um telemóvel noutra, e a transcrição é encriptada no seu computador antes de ir para qualquer lado.

As aplicações iOS e Android, a aplicação de desktop para macOS, Windows e Linux, e o app.happier.dev são todos clientes sobre o processo OpenCode que corre no seu computador — não espelhos apenas de leitura. Responda a um pedido de permissão, envie a instrução seguinte, percorra o repositório, leia o diff. A transcrição é encriptada de ponta a ponta antes de sair do seu computador, por isso o servidor que a transporta guarda texto cifrado.

O Happier instala-se no computador que já guarda o seu repositório, e happier opencode inicia lá o OpenCode como um subprocesso normal, no diretório para onde o apontar, com a sessão iniciada da forma como a iniciou. Não há gateway nenhum entre o agente e a SST, nem cópia nenhuma do seu código em mais lado nenhum.

O Happier procura primeiro opencode no seu PATH e executa a cópia que você instalou. Se não houver nenhuma, ele pode instalar opencode-ai em ~/.happier/tools/providers/opencode/ — um diretório próprio, não o seu prefixo global do npm. Uma cópia que você gerencia nunca é substituída nem atualizada pelas suas costas.

O guia de instalação e login da própria SST está em opencode.ai/docs. O Happier não o espelha, porque uma cópia das instruções de instalação de outra pessoa é uma cópia que fica desatualizada.

Referência de configuração do lado do Happier — OpenCode na documentação do Happier.

O OpenCode é um dos agentes que o Happier consegue apontar para uma credencial conectada uma única vez, em vez da conta em que aquele computador está logado. Ele aceita a Codex subscription, an OpenAI API key, a Claude subscription or an Anthropic API key.

Os serviços conectados são indexados pela credencial, não pelo agente, então o mesmo Codex subscription pode ser selecionado para qualquer agente que o aceite, em todos os computadores que você conectou — o que também é o que torna útil um pool das suas próprias contas em mais de um deles. A credencial é criptografada e descriptografada nos seus próprios dispositivos; a página da documentação traz as regras por perfil, porque quais tipos de perfil cada agente aceita é exatamente o tipo de detalhe que muda entre versões.

O OpenCode é um de 13 agentes de programação de linha de comandos que o Happier corre, e todos partilham uma lista de sessões, uma caixa de entrada de permissões, um conjunto de atalhos de teclado e uma configuração MCP.

You define an MCP server once and OpenCode receives it as native MCP inventory, next to whatever MCP servers it already had of its own.

Isso conta sobretudo nos dias em que está a correr mais do que um: sessões de fornecedores diferentes lado a lado, e um toque numa notificação a abrir a sessão que levantou o pedido em vez da porta de entrada da aplicação. A lista completa está aqui.

Escrever happier opencode num terminal inicia a sessão mesmo onde está, e a mesma sessão está na aplicação ao mesmo tempo. O que lê nessa shell é a apresentação que o próprio Happier faz da sessão — a transcrição, os pedidos de permissão, a saída das ferramentas — e não a interface do OpenCode. Ninguém tem de abdicar do terminal para ter um cliente de telemóvel.

happier attach <session-id> abre a TUI do próprio OpenCode nessa mesma sessão pelo fluxo de attach do OpenCode. As duas pontas continuam graváveis, sem multiplexador no meio e sem nada para ligar antes: digite na TUI e aparece no app, envie pelo app e aparece na TUI.

O guia de attach lista os casos em vez de prometer todos eles.

Um comando no computador que guarda o seu código, e depois happier opencode no repositório em que quer trabalhar.

Os passo a passo estão nos guias. Tudo isto tem licença MIT, e o relay é um que pode correr você mesmo.