PC Control Center · App desktop & agente remoto

Estudo de caso Personal project

Um computador que você confere, e desliga, por um chat.

Cliente: Personal project
Tipo: App desktop & agente remoto
Papel: Design & desenvolvimento full-stack
Ano: 2026

01Visão geral

Um app desktop e um agente local que colocam o computador ao alcance de um chat do Telegram: um painel em Electron que configura tudo e um agente em Node.js que responde a 37 comandos vindos de um único chat autorizado.

02O problema

Conferir uma máquina longe de você costuma exigir software de acesso remoto, portas abertas ou VPN. E um bot capaz de rodar comandos no seu computador é tão seguro quanto a pior mensagem que ele aceitar.

02A abordagem

Usar um app de mensagens que o dono já carrega no bolso e deixar o computador no comando. O agente consulta o Telegram de dentro para fora, então nada fica escutando na rede; ele responde a um único chat configurado e ignora todos os outros; e tudo o que altera a máquina precisa ser confirmado antes.

03A construção

O que foi de fato construído

01
Um painel de configuração em Electron: basta colar o token do bot e o chat ID, e ele valida os dois no Telegram (getMe e uma mensagem de teste), instala o agente, o coloca para iniciar no boot e mostra cada etapa conforme ela é concluída.
02
Um agente em Node.js sem dependências em runtime: long polling com offset persistido, para nunca reprocessar mensagens antigas, e 37 comandos de sistema, rede, processos, arquivos, mídia e energia, cada um implementado por plataforma, com um simples “ainda não disponível” onde não existe implementação segura.
03
Proteções em todo caminho sensível: desligar, reiniciar, suspender, bloquear, limpeza e upgrade exigem um código de seis dígitos em até 30 segundos, escolhido entre quatro botões; o sudo genérico é bloqueado no /cmd, padrões destrutivos são recusados e ações privilegiadas só rodam por scripts wrapper fixos, liberados em um sudoers restrito, nunca NOPASSWD: ALL.
04
Instaladores para serviço systemd no Linux, tarefa agendada no Windows e LaunchAgent no macOS. A configuração é salva com permissão 600, e o token aparece mascarado na interface e é removido das mensagens de erro.

Tecnologia

Electron
Node.js
JavaScript
Telegram Bot API
systemd
Bash
PowerShell

04A experiência

Tela de configuração do Telegram com os campos BOT_TOKEN e CHAT_ID e cinco etapas concluídas, de “Configuração salva” a “PC conectado”. — Configuração: dois valores e o app valida o Telegram, instala o agente e o inicia.

Conversa com o bot mostrando a resposta do /help, a lista completa de comandos e um menu de oito botões por categoria. — /help: todos os comandos, mais um menu de botões por categoria.

Tela de status do agente com o selo “Conectado”, botões para reparar, reiniciar e ver logs, e hostname, sistema, CPU, núcleos, RAM e disco do computador. — Status: o computador como o agente o vê, com reparar, reiniciar e logs a um clique.

Conversa mostrando os botões da categoria Sistema e as respostas do bot para CPU, RAM, disco, swap e uptime. — Categoria Sistema: um toque por leitura.

Conversa em que um comando com sudo é bloqueado, rm -rf / é recusado e /desligar pede um código de seis dígitos com quatro botões. — Proteções: sudo genérico bloqueado, comandos destrutivos recusados e desligamento atrás de um código de 30 segundos.

05Onde está hoje

Um protótipo funcional (v0.1.0), desenvolvido no Linux, onde o suporte é mais completo. Windows e macOS são parciais, e o próprio README ainda lista problemas em aberto. Gerenciar vários PCs em um só painel está no roadmap, ainda não foi construído.

Próximo projetoRoomFlowGrupo Transire · Reserva de salas de reunião