1Byte Systems

Guia · 1B Terminal

Os alertas do teu agente de IA no telemóvel

Os agentes de programação param para pedir autorização, terminam uma tarefa ou dão um erro, e ninguém está a ver. Com o 1B Terminal e alguns minutos de configuração, esses momentos chegam ao teu telemóvel Android como notificações a que podes responder.

Definições confirmadas na documentação oficial de cada ferramenta a 4 de novembro de 2026.

Porque é que te escapam as perguntas do teu agente

Um agente que está à tua espera não faz nada. O 1B Terminal garante que ficas a saber.

  • Para e espera

    O Claude Code, o Codex, o OpenCode e outros agentes fazem uma pausa antes de executar um comando ou editar um ficheiro. Se não estiveres a olhar para o ecrã, o trabalho fica parado até voltares.

  • O teu telemóvel dá por isso

    O 1B Terminal transforma a campainha do terminal e as notificações do agente (OSC 9 e OSC 777) em notificações do Android para cada sessão que não estás a ver. Também dentro do tmux: a partir da versão 1.2.0, a app ativa sozinha allow-passthrough na sua própria sessão do tmux.

  • Responde a partir da notificação

    Cada alerta tem os botões Responder, Enter e y. Escreve ou dita uma resposta, confirma com Enter ou diz que sim sem abrir a app.

  • Mesmo que o agente não avise

    Se um programa nunca enviar alertas, o 1B Terminal pode avisar-te quando a saída dele fica em silêncio depois de um período de trabalho: provavelmente terminou ou está à tua espera.

Configura no 1B Terminal

Cinco passos no telemóvel. Os nomes a negrito são exatamente o que vês na app (versão 1.2.0).

  1. Instala o 1B Terminal

    Transfere-o do Google Play para o teu telemóvel Android (Android 8.0 ou posterior). Não é preciso criar conta.

    Disponível no Google Play

  2. Adiciona o teu servidor

    Em Hosts, toca em + para abrir Novo host, introduz o endereço, o nome de utilizador e uma chave ou palavra-passe, e guarda. Liga-te uma vez e confirma a impressão digital do servidor.

  3. Ativa o tmux no host

    No editor do host, em Sessão, ativa Entrar no tmux ao ligar. O teu agente continua a correr no servidor se a ligação cair, e o 1B Terminal deixa passar os alertas dele através do tmux. O tmux tem de estar instalado no servidor.

  4. Prepara o servidor para o teu agente

    Abre Definições › Agentes de IA › Preparar o servidor para agentes (também está no menu ⋮ de uma sessão). Aí tens as definições da secção seguinte, prontas a copiar. A app nunca altera ficheiros no teu servidor: és tu que os adicionas.

  5. Permite as notificações

    No Android 13 e posterior, permite as notificações quando a app pedir. Em Definições › Notificações, mantém Avisar quando uma sessão precisar de ti ativado, ativa Avisar quando a saída parar se quiseres e mantém Responder a partir da notificação ativado para teres os botões.

Agora inicia o teu agente e muda para outra app ou bloqueia o telemóvel. Quando o agente precisar de ti, chega a notificação; toca nela para voltares a essa sessão.

O que mudar em cada agente

Só definições que aparecem na documentação oficial de cada ferramenta, com ligação para as confirmares tu mesmo.

Claude Code

Por predefinição, o Claude Code não envia nada para terminais que não reconhece; a documentação dele diz «Other terminals: nothing». Diz-lhe para tocar a campainha do terminal em qualquer terminal, e o 1B Terminal transforma essa campainha numa notificação.

Ficheiro: ~/.claude/settings.json
{
  "preferredNotifChannel": "terminal_bell"
}

Também podes abrir /config no Claude Code, ir a Local notifications e escolher a campainha do terminal.

Se és tu a iniciar o tmux

Com Entrar no tmux ao ligar, o 1B Terminal já deixa passar os alertas na sua própria sessão. Se preferires iniciar o tmux tu mesmo, adiciona estas linhas da documentação do Claude Code e recarrega-as com tmux source-file ~/.tmux.conf.

Ficheiro: ~/.tmux.conf
set -g allow-passthrough on
set -g focus-events on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

Estado da sessão: o Claude Code v2.1.295 e posteriores indicam se cada sessão está a trabalhar ou à tua espera (OSC 7501), e o 1B Terminal mostra-o no separador da sessão. Só funciona quando o Claude Code corre fora do tmux.

Documentação oficial: code.claude.com/docs/en/terminal-config · code.claude.com/docs/en/settings-reference ·

Codex

O Codex pode enviar os seus alertas como notificações OSC 9, que o 1B Terminal mostra com o respetivo texto. Adiciona estas linhas ao teu ficheiro de configuração de utilizador.

Ficheiro: ~/.codex/config.toml
[tui]
notifications = true
notification_method = "osc9"
notification_condition = "always"

Com «always», o Codex avisa-te mesmo quando o terminal tem o foco. O 1B Terminal nunca te avisa sobre a sessão que estás a ver, por isso não vais receber alertas duplicados.

Documentação oficial: learn.chatgpt.com/docs/config-file/config-reference ·

OpenCode

Os alertas de atenção do OpenCode vêm desativados por predefinição. Ativa-os no tui.json dele.

Ficheiro: tui.json
{
  "$schema": "https://opencode.ai/tui.json",
  "attention": {
    "enabled": true,
    "notifications": true
  }
}

A documentação do OpenCode não diz onde fica esse ficheiro; diz, sim, que podes indicar um com a variável OPENCODE_TUI_CONFIG. O OpenCode só avisa quando o terminal não tem o foco, e o 1B Terminal diz-lhe quando sais da sessão.

Documentação oficial: opencode.ai/docs/tui ·

Antigravity CLI

O Antigravity CLI da Google corre como agy. A documentação dele não descreve nenhuma definição de notificações, por isso deixa que o 1B Terminal te avise quando a saída ficar em silêncio.

Documentação oficial: github.com/google-antigravity/antigravity-cli ·

Qualquer outro agente

Em Definições › Notificações, ativa Avisar quando a saída parar. Quando uma sessão esteve ocupada e deixa de escrever, o 1B Terminal avisa-te: o programa provavelmente terminou ou está à espera de uma resposta.

Perguntas e respostas

Preciso do tmux?

Não. Os alertas também funcionam numa sessão SSH simples, que a app mantém ligada em segundo plano. O tmux é recomendado porque o teu agente continua a trabalhar no servidor se a ligação cair, e o 1B Terminal volta à mesma sessão quando volta a ligar-se.

Funciona no iPhone?

Não. O 1B Terminal só está disponível para Android (8.0 ou posterior).

É enviada alguma coisa para a 1Byte Systems?

Não. A ligação vai diretamente do teu telemóvel para o teu servidor por SSH, e as notificações são criadas no próprio telemóvel. Não há nenhum servidor da 1Byte pelo meio nem conta.

Porque é que não recebo alertas da sessão que estou a ver?

De propósito: o 1B Terminal só te avisa sobre sessões que não estás a ver, e no máximo uma vez a cada 5 segundos por sessão.

Posso responder sem abrir a app?

Sim, com os botões Responder, Enter e y da notificação. Ficam ocultos enquanto o bloqueio da app estiver ativado.

Obtém o 1B Terminal

O terminal SSH para trabalhar com agentes de IA a partir do teu telemóvel Android: chaves, tmux, uma fila de teclas pensada para agentes e alertas que te chegam.