Interface web do Pi coding agent ganha força no GitHub Trending
Projeto local transforma sessões do agente de código em um espaço visual para chat, arquivos, modelos e históricos.
Projeto local transforma sessões do agente de código em um espaço visual para chat, arquivos, modelos e históricos.
O agegr/pi-web é uma interface web local para o pi coding agent, criada por agegr. O projeto entrou no GitHub Trending, na categoria mensal, e acumulava 3.812 estrelas e 532 forks na consulta de 9 de agosto de 2026. Sua proposta é resolver a dificuldade de recuperar conversas antigas, acompanhar chamadas de ferramentas e navegar pelos arquivos de um projeto sem depender apenas do terminal.
O Pi Web lê os arquivos de sessão mantidos localmente pelo pi coding agent e os apresenta no navegador. Com isso, o usuário pode navegar por conversas organizadas por projeto, retomar uma mensagem anterior ou criar uma rota separada a partir de uma sessão existente.
A interface também reúne o chat e a exploração do projeto no mesmo ambiente. É possível visualizar código, documentação, imagens, áudio e PDFs, enquanto o agente trabalha. O sistema acompanha ainda informações como uso de contexto, custo, estado de compactação e detalhes do prompt de sistema.
O repositório foi criado em 22 de março de 2026 e recebeu seu último commit em 8 de agosto de 2026. A versão mais recente informada é a v0.8.7, publicada em 6 de agosto de 2026.
O requisito principal é o Node.js 22.19.0 ou superior. O uso pode ser feito sem instalação permanente, por meio do npx, ou com uma instalação global pelo npm:
npx @agegr/pi-web@latest
Depois que o servidor estiver pronto, o acesso padrão é feito em http://127.0.0.1:30141. O programa tenta abrir o navegador automaticamente, mas oferece a opção --no-open para impedir esse comportamento.
Também é possível alterar a porta ou o endereço de rede:
pi-web --port 8080
pi-web --hostname 0.0.0.0
A variável PI_CODING_AGENT_DIR permite indicar outro diretório do pi agent. Por padrão, o projeto lê as sessões em ~/.pi/agent/sessions, onde os arquivos são armazenados em formato JSONL, uma estrutura baseada em linhas de objetos JSON.
O Pi Web não se apresenta como um agente de código independente. Ele funciona como uma camada de visualização e operação sobre o pi coding agent, aproveitando as sessões já gravadas localmente. A comparação central, portanto, é com o uso exclusivo da interface de linha de comando: o navegador acrescenta histórico navegável, painéis de arquivos e controles de configuração.
A arquitetura descrita no repositório separa recursos por APIs. Há módulos para criar e conduzir sessões do agente, enviar eventos em tempo real, acessar arquivos, listar diretórios, consultar modelos, administrar skills e exportar sessões em HTML.
Outro ponto específico é a distinção entre bifurcações de sessão e ramificações internas. A opção de fork cria um novo arquivo .jsonl, enquanto “Edit from here” cria outra ramificação dentro do mesmo arquivo de sessão.
A interface pode chamar um agente com privilégios elevados, segundo o README. A autenticação opcional usa HTTP Basic Auth, com o usuário fixo pi e uma senha definida por PI_WEB_PASSWORD. Como esse mecanismo não cifra a senha durante o trânsito, o projeto recomenda HTTPS por meio de um proxy reverso confiável ou uma VPN confiável para acessos remotos.
Por padrão, o servidor escuta apenas em 127.0.0.1. A exposição em uma rede pode ser feita com --hostname 0.0.0.0, mas exige cuidado com a configuração de hosts permitidos e com o acesso aos arquivos do projeto. A navegação e a prévia de arquivos são limitadas ao diretório selecionado e aos diretórios de trabalho presentes nas sessões.
A versão v0.8.7 indica um projeto em desenvolvimento ativo, mas o repositório consultado não informa uma classificação formal de maturidade, política de suporte ou quantidade de colaboradores. Também não informa o número de idiomas disponíveis na interface. Há 40 issues abertas na consulta.
A licença é MIT, permitindo uso, modificação e redistribuição conforme seus termos. O projeto depende do Node.js 22.19.0 ou superior e do pi coding agent; informações sobre custos de modelos, provedores compatíveis ou requisitos de hardware não foram informadas no repositório.