Sobre o projeto

CodeAgent Mobile — Clients é o repositório público para os bridges do lado do cliente do CodeAgent Mobile, uma camada de continuidade de fluxo de trabalho que permite supervisionar agentes de codificação por IA (Claude Code, Copilot, Cursor, Windsurf, JetBrains AI, OpenAI Codex, Vertex AI, etc.) a partir de um dispositivo móvel ou painel web. O repositório contém três clientes distintos: - **apps/cli** – `codeam-cli`, uma ponte de terminal que envolve Claude Code em um PTY e transmite comandos para qualquer dispositivo. Instalável via npm e utilizado com um fluxo de pareamento por QR. - **apps/vsc-plugin** – uma extensão para VS Code, Cursor e Windsurf que se conecta ao mesmo relay de backend, permitindo aprovar diffs, redirecionar prompts e monitorar sessões pelo celular. - **apps/jetbrains-plugin** – um plugin para a família IntelliJ (IDEA, WebStorm, PyCharm, Rider, GoLand, ...) que integra as mesmas capacidades de controle móvel. Todos os clientes compartilham a mesma configuração por variáveis de ambiente (`CODEAM_API_URL` e `CODEAM_TEST_MODE=1`) para apontar para uma API de produção, staging ou auto-hospedada. Eles leem essas variáveis a partir do processo host; os plugins VS Code e JetBrains também suportam uma configuração `apiBaseUrl` como substituição manual. O layout do repositório segue um padrão monorepo com `apps/` para cada cliente, um pacote TypeScript `packages/shared` que armazena o parser de protocolo chunk e tabelas de precificação de modelos (inlined no build), e scripts raiz para build, testes e publicação. Os pré-requisitos de build são Node ≥ 18, Python 3 (para manipulação de PTY) e JDK 17 para o plugin JetBrains. Os releases são coordenados por uma única linha de versão (começando em 2.0.0). Uma tag `vX.Y.Z` dispara publicação automatizada do CLI no npm, da extensão VS Code no VS Code Marketplace e Open VSX, e do plugin JetBrains no canal estável do JetBrains Marketplace. Tags de pré-lançamento ignoram o push para o marketplace JetBrains. Arquiteturalmente, os clientes atuam como relays finos: conectam-se ao backend CodeAgent via REST/WebSocket, encaminham comandos para o agente de IA local (via PTY, APIs de IDE ou terminal) e transmitem a sessão para a interface móvel/web para aprovação, redirecionamento e supervisão assíncrona. A contribuição segue um fluxo simples: abrir uma issue para mudanças não triviais, manter mudanças escopadas por app, executar os testes apropriados (`npm run test:cli`) e garantir builds bem-sucedidos antes de submeter um pull request. O projeto é licenciado sob a MIT License. Este repositório é ideal para desenvolvedores que desejam estender fluxos de trabalho de codificação por IA além do desktop, fornecendo um plano de controle unificado para múltiplas IDEs e agentes de terminal a partir de uma única interface móvel.