Sobre o projeto

WebCodex é uma ferramenta de código aberto que conecta agentes de IA baseados em nuvem (como ChatGPT e Claude) a ambientes de desenvolvimento locais. Em vez de exigir que os desenvolvedores enviem seu código para um espaço de trabalho hospedado, o WebCodex permite que agentes de IA interajam diretamente com repositórios, executem comandos, usem Git, rodem testes e realizem tarefas de longa duração—tudo na própria máquina do desenvolvedor. A ferramenta opera através de uma arquitetura Servidor/Executor. O Servidor atua como intermediário ao qual os clientes de IA se conectam via MCP (Model Context Protocol) ou HTTPS, enquanto o Executor realiza operações na máquina local. Esse design mantém o repositório e todas as ferramentas de desenvolvedor na máquina original, preservando o ambiente de desenvolvimento existente. O WebCodex suporta dois modos principais de uso. Para o desenvolvimento diário, os usuários configuram um Servidor e Executor regulares, o que fornece acesso durável a múltiplos projetos com capacidades completas, incluindo exploração de projetos, edição, operações Git, execução de comandos, testes e navegação de código. Para testes rápidos, um modo `share` de comando único inicia uma instância temporária de projeto único que imprime valores de conexão para o ChatGPT. A ferramenta suporta múltiplas plataformas: Linux (x64/arm64), macOS (x64/arm64) e Windows (x64 e arm64). Usuários de Windows e macOS são recomendados a usar o aplicativo Desktop WebCodex com o Túnel Seguro oficial da OpenAI para a configuração mais simples. A configuração baseada em CLI está disponível para todas as plataformas, com opções adicionais para auto-hospedagem e configurações avançadas. As principais capacidades incluem: ler, pesquisar, inspecionar e fazer alterações protegidas no código; executar comandos, testes, formatadores, compiladores e ferramentas específicas de projeto; trabalhar com Git para inspecionar status e diffs; lidar com trabalhos de longa duração com jobs observáveis; e suportar revisão humana através de um Console de Runtime, evidências de Sessão de Workflow e revisão de Git/diff. O WebCodex é construído com Rust (usando Cargo para compilação) e é licenciado sob a Licença Apache 2.0. O projeto inclui documentação abrangente cobrindo instalação desktop, configuração completa, testes rápidos, integração MCP, implantação, solução de problemas, referência CLI, configuração assistida por IA e orientações de segurança.