Sobre o projeto

Ground Control é um app para macOS (13+, Swift 5.9, sem dependências de terceiros) que rastreia sessões de agentes de IA em execução nos seus terminais e editores. Ele resolve um problema específico: quando você executa vários agentes em diversos terminais e Desktops, um deles pode estar bloqueado aguardando sua aprovação, e você perde tempo verificando cada um ou esquecendo de verificar. O app exibe um painel flutuante sobre todos os Desktops com uma linha por sessão de agente ativa. Cada linha mostra o nome da sessão, a atividade atual e um ponto de status que fica vermelho quando o agente está bloqueado e precisa de você. Clicar em uma linha navega até a aba exata do terminal (Terminal.app, iTerm2) ou traz o app proprietário para frente (VS Code, Cursor, Warp, Ghostty, WezTerm). Um ícone na barra de menu exibe um badge sempre que alguma sessão precisa de atenção. A compatibilidade testada com agentes inclui Claude Code (subagentes agrupados, vermelho quando bloqueado/pergunta), Grok CLI (vermelho em prompts de entrada), OpenAI Codex CLI (vermelho em solicitações de permissão), opencode (vermelho em permission.asked) e Grok Bot (vermelho em aprovações a partir da versão 0.58.0). O agente Composer do Cursor mostra linhas, mas não fica vermelho porque não dispara nenhum evento de espera. A aba Code do Claude for Desktop é suportada; suas sessões na nuvem e a aba Home não são, já que nada é executado localmente. O app funciona instalando hooks que gravam arquivos de sessão JSONL em uma pasta temporária; o app observa essa pasta e exibe o último estado de cada arquivo. O instalador faz merge em ~/.claude/settings.json, ~/.cursor/hooks.json e ~/.codex/config.toml, fazendo backup dos arquivos existentes primeiro. Os hooks nunca interrompem o agente e falham silenciosamente por design. O painel é totalmente tematizável por meio de pastas de imagens e JSON (estilo WinAmp). Um recurso integrado "Create a Theme" gera prompts para LLMs com capacidade de imagem produzirem a arte do tema. O analisador da barra de título pode executar fórmulas de altura de barra definidas pelo tema. O app não faz conexões de rede e seu TerminalFocuser só consegue navegar até janelas, não digitar ou executar comandos. Um recurso de resposta remota foi prototipado e deliberadamente removido por razões de segurança. Licenciado sob AGPL-3.0-or-later; não aceita contribuições de código, mas recebe bem relatórios de bugs e temas.