Sobre o projeto
CodexMonitor é um aplicativo de desktop baseado em Tauri para orquestrar múltiplos agentes Codex em espaços de trabalho locais. Ele fornece uma barra lateral para gerenciar projetos, um painel inicial para ações rápidas e atividade recente, e uma visualização de conversa apoiada pelo protocolo app-server do Codex.
Principais capacidades descritas no README:
- Espaços de trabalho e threads: adicionar e persistir espaços de trabalho, agrupá-los/classificá-los, iniciar um `codex app-server` por espaço de trabalho, retomar threads e rastrear estado de não lido/em execução. Suporta agentes worktree e clone para trabalho isolado, fixar/renomear/arquivar/copiar threads, rascunhos por thread e interromper turnos em andamento.
- Compositor e controles de agente: anexos de imagem via seletor, arrastar/soltar ou colar; comportamento de acompanhamento configurável (Fila vs Direcionar); autocompletar para habilidades, prompts, revisões e caminhos de arquivo; seletor de modelo, modos de colaboração, esforço de raciocínio, modo de acesso e anel de uso de contexto; ditado com pressionar para falar e forma de onda ao vivo (Whisper); renderização de itens de raciocínio/ferramenta/diff e prompts de aprovação.
- Git e GitHub: estatísticas de diff, diffs encenados/não encenados, controles de reverter/encenar, log de commits, lista de branches com checkout/criação e contagens de à frente/atrás do upstream; Issues e Pull Requests do GitHub via `gh`; um compositor de PR que envia contexto de PR para uma nova thread de agente.
- Arquivos e prompts: árvore de arquivos com busca, ícones por tipo de arquivo e revelar no gerenciador de arquivos; uma biblioteca de prompts para prompts globais/do espaço de trabalho que podem ser criados, editados, excluídos, movidos e executados em threads atuais ou novas.
- UI e experiência: painéis redimensionáveis com tamanhos persistidos, layouts responsivos, medidor de uso/créditos na barra lateral, dock de terminal multi-abas experimental, atualizações no aplicativo, painel de depuração, notificações sonoras e efeitos de janela específicos da plataforma.
Os requisitos incluem Node.js/npm, uma toolchain Rust estável, CMake, LLVM/Clang no Windows, o CLI Codex disponível como `codex` no PATH (ou um binário personalizado configurado nas configurações), CLI Git e, opcionalmente, o CLI GitHub. Um comando `npm run doctor` é fornecido para erros de build nativo.
O desenvolvimento usa `npm install` e `npm run tauri:dev`; builds de produção usam `npm run tauri:build`, com um script de build Windows opcional. Os comandos de validação incluem lint, teste, typecheck e `cargo check`.
O suporte a iOS é descrito como trabalho em andamento: o layout móvel funciona, o fluxo de backend remoto está conectado, e o iOS usa o modo de backend remoto por padrão, enquanto terminal e ditado permanecem indisponíveis no móvel. O README documenta uma configuração TCP baseada em Tailscale para conectar o aplicativo iOS a um daemon hospedado no desktop, além de um CLI de controle de daemon headless (`codex_monitor_daemonctl`) com comandos de status/iniciar/parar/pré-visualização de comando e substituições para diretório de dados, endereço de escuta, token e caminho do daemon. Pré-requisitos iOS, scripts de simulador e dispositivo USB, e um fluxo de lançamento TestFlight com script também são documentados.
Notas de persistência: espaços de trabalho persistem em `workspaces.json` e configurações do aplicativo em `settings.json` sob o diretório de dados do aplicativo; algumas configurações de recursos sincronizam com `$CODEX_HOME/config.toml`; estado de UI, como tamanhos de painel, é armazenado em localStorage. O README também lista a superfície de comandos IPC do Tauri em configurações, espaços de trabalho/worktrees, threads/turnos/revisões, conta/modelos/colaboração, git/GitHub, prompts, terminal/ditado/notificações/uso e auxiliares de backend remoto.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.