1Byte Systems

Guia · 1B Terminal

Os alertas do seu agente de IA no celular

Os agentes de programação param para pedir permissão, terminam uma tarefa ou dão erro, e ninguém está olhando. Com o 1B Terminal e alguns minutos de configuração, esses momentos chegam ao seu celular Android como notificações que você pode responder.

Ajustes conferidos na documentação oficial de cada ferramenta em 4 de novembro de 2026.

Por que você perde as perguntas do seu agente

Um agente que está esperando por você não faz nada. O 1B Terminal garante que você fique sabendo.

  • Ele para e espera

    Claude Code, Codex, OpenCode e outros agentes fazem uma pausa antes de executar um comando ou editar um arquivo. Se você não está olhando para a tela, o trabalho fica parado até você voltar.

  • Seu celular fica sabendo

    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 você não está olhando. Também dentro do tmux: a partir da versão 1.2.0, o app ativa sozinho o allow-passthrough na própria sessão do tmux.

  • Responda pela notificação

    Cada alerta tem os botões Responder, Enter e y. Digite ou dite uma resposta, confirme com Enter ou diga sim sem abrir o app.

  • Mesmo que o agente não avise

    Se um programa nunca envia alertas, o 1B Terminal pode avisar você quando a saída dele fica em silêncio depois de um período de trabalho: provavelmente ele terminou ou está esperando por você.

Configure no 1B Terminal

Cinco passos no celular. Os nomes em negrito são exatamente o que você vê no app (versão 1.2.0).

  1. Instale o 1B Terminal

    Baixe no Google Play no seu celular Android (Android 8.0 ou posterior). Não é preciso criar conta.

    Disponível no Google Play

  2. Adicione seu servidor

    Em Hosts, toque em + para abrir Novo host, informe o endereço, o nome de usuário e uma chave ou senha, e salve. Conecte-se uma vez e confira a impressão digital do servidor.

  3. Ative o tmux no host

    No editor do host, em Sessão, ative Entrar no tmux ao conectar. Seu agente continua rodando no servidor se a conexão cair, e o 1B Terminal deixa os alertas dele passarem pelo tmux. O tmux precisa estar instalado no servidor.

  4. Prepare o servidor para o seu agente

    Abra Ajustes › Agentes de IA › Preparar o servidor para agentes (também fica no menu ⋮ de uma sessão). Ali estão os ajustes da próxima seção, prontos para copiar. O app nunca altera arquivos no seu servidor: quem os adiciona é você.

  5. Permita as notificações

    No Android 13 e posterior, permita as notificações quando o app pedir. Em Ajustes › Notificações, mantenha Avisar quando uma sessão precisar de você ativado, ative Avisar quando a saída parar se quiser e mantenha Responder pela notificação ativado para ter os botões.

Agora inicie seu agente e mude para outro app ou bloqueie o celular. Quando o agente precisar de você, a notificação chega; toque nela para voltar àquela sessão.

O que mudar em cada agente

Só ajustes que aparecem na documentação oficial de cada ferramenta, com link para você mesmo conferir.

Claude Code

Por padrão, o Claude Code não envia nada para terminais que não reconhece; a documentação dele diz “Other terminals: nothing”. Peça a ele que toque a campainha do terminal em qualquer terminal, e o 1B Terminal transforma essa campainha em uma notificação.

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

Você também pode abrir /config no Claude Code, ir em Local notifications e escolher a campainha do terminal.

Se você mesmo inicia o tmux

Com Entrar no tmux ao conectar, o 1B Terminal já deixa os alertas passarem na própria sessão. Se você preferir iniciar o tmux por conta própria, adicione estas linhas da documentação do Claude Code e recarregue-as com tmux source-file ~/.tmux.conf.

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

Status da sessão: o Claude Code v2.1.295 e posteriores informam se cada sessão está trabalhando ou esperando por você (OSC 7501), e o 1B Terminal mostra isso na aba da sessão. Só funciona quando o Claude Code roda 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 seus alertas como notificações OSC 9, que o 1B Terminal mostra com o texto delas. Adicione estas linhas ao seu arquivo de configuração de usuário.

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

Com “always”, o Codex avisa você mesmo quando o terminal está em foco. O 1B Terminal nunca avisa sobre a sessão que você está olhando, então você não vai 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 padrão. Ative-os no tui.json dele.

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

A documentação do OpenCode não diz onde esse arquivo fica; diz, sim, que você pode apontar para um com a variável OPENCODE_TUI_CONFIG. O OpenCode só avisa quando o terminal não está em foco, e o 1B Terminal informa a ele quando você sai da sessão.

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

Gemini CLI

O Google descontinuou o Gemini CLI para contas individuais em 18 de junho de 2026. Ele continua funcionando com licenças empresariais e com uma chave de API. Se você usa assim, ative Avisar quando a saída parar para que o 1B Terminal avise quando ele parar.

Documentação oficial: developers.google.com/gemini-code-assist/docs/deprecations/code-assist-individuals ·

Antigravity CLI

O Antigravity CLI do Google roda como agy. A documentação dele não descreve nenhum ajuste de notificação, então deixe o 1B Terminal avisar você quando a saída ficar em silêncio.

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

Qualquer outro agente

Em Ajustes › Notificações, ative Avisar quando a saída parar. Quando uma sessão estava ocupada e para de imprimir, o 1B Terminal avisa você: o programa provavelmente terminou ou está esperando uma resposta.

Perguntas e respostas

Preciso do tmux?

Não. Os alertas também funcionam em uma sessão SSH comum, que o app mantém conectada em segundo plano. O tmux é recomendado porque seu agente continua trabalhando no servidor se a conexão cair, e o 1B Terminal volta para a mesma sessão ao reconectar.

Funciona no iPhone?

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

Alguma coisa é enviada para a 1Byte Systems?

Não. A conexão vai direto do seu celular para o seu servidor por SSH, e as notificações são criadas no próprio celular. Não há nenhum servidor da 1Byte no meio nem conta.

Por que não recebo alertas da sessão que estou olhando?

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

Posso responder sem abrir o app?

Sim, com os botões Responder, Enter e y da notificação. Eles ficam ocultos enquanto o bloqueio do app está ativado.

Baixe o 1B Terminal

O terminal SSH para trabalhar com agentes de IA no seu celular Android: chaves, tmux, uma fileira de teclas pensada para agentes e alertas que chegam até você.