O que é Axel?

Axel é um aplicativo nativo poderoso para macOS, projetado para acelerar fluxos de trabalho de desenvolvimento, atuando como um gerenciador de tarefas inteligente e centralizado para agentes de IA. Ele permite que os desenvolvedores enfileirem tarefas complexas—desde geração e modificação de código até execução de testes ou chamadas de API—e as despachem para modelos de linguagem grandes (LLMs) especializados, como Claude, Codex e OpenCode. Ao fornecer uma interface única e simplificada, Axel elimina o atrito de alternar entre múltiplas ferramentas ou gerenciar interações de agentes manualmente, garantindo que os desenvolvedores possam se concentrar puramente na lógica e no resultado de seu trabalho.

Esta aplicação transforma a maneira como as equipes de desenvolvimento interagem com assistentes de IA. Em vez de prompts ad-hoc, Axel introduz um sistema de fila estruturado onde as tarefas podem ser priorizadas, reordenadas dinamicamente durante a execução e monitoradas em tempo real. Além disso, o Axel se integra profundamente ao ambiente do desenvolvedor, suportando configurações específicas do projeto via arquivos AXEL.md e garantindo que as habilidades de IA sejam portáteis entre diferentes agentes, maximizando a consistência e a eficiência em todo o ciclo de vida do desenvolvimento.

Principais Funcionalidades

• Fila de Tarefas Acelerada: Adicione tarefas a uma fila persistente, atribua-as a agentes específicos (Claude, Codex, OpenCode, Antigravity) e reordene as prioridades em tempo real sem reiniciar a execução. As tarefas são executadas em paralelo para máxima vazão.
• Caixa de Entrada de Aprovação Centralizada: Agentes solicitam permissão para ações sensíveis como edição de arquivos, execução de comandos ou chamadas de API. Todas as solicitações são consolidadas em uma caixa de entrada onde os usuários podem aprovar, negar ou definir regras granulares de aprovação automática.
• Visualizações de Contexto Completas: Antes de aprovar qualquer ação, os usuários veem o contexto completo, incluindo caminhos de arquivo, prévias detalhadas de diff das alterações propostas e argumentos de comando.
• Habilidades e Configuração Portáteis: Defina layouts de projeto, configurações de painel e habilidades usando um único arquivo YAML de frontmatter AXEL.md. As habilidades são armazenadas centralmente (~/.config/axel/skills) e automaticamente vinculadas (symlinked) aos locais esperados para cada agente.
• Integração com o Ambiente: Integra-se perfeitamente com fluxos de trabalho Git, gerando worktrees necessários (ex: axel -w feat/auth) e suportando sessões de terminal persistentes usando tmux ou iTerm2.
• Rastreamento de Custo e Tokens: Fornece visibilidade em tempo real sobre o uso de recursos, rastreando tokens de entrada/saída e custos estimados em USD por tarefa, com totais cumulativos rastreados por sessão.
• Experiência Nativa no macOS: Construído com SwiftUI, o Axel oferece um aplicativo nativo na barra de menu com integração profunda ao sistema operacional, incluindo atalhos de teclado e notificações do macOS para aprovações bloqueadas.

Como Usar o Axel

Começar com o Axel envolve configurar seu ambiente e definir seu primeiro fluxo de trabalho de projeto:

1. Instalação e Configuração: Baixe o aplicativo nativo para macOS. Configure seus agentes de IA preferidos (como definir chaves de API para Claude ou Codex) nas configurações do aplicativo.
2. Configuração do Projeto (AXEL.md): Para projetos estruturados, crie um arquivo AXEL.md no seu diretório raiz. Este frontmatter YAML define o layout desejado, a estrutura de painéis e quais habilidades devem estar disponíveis para aquele projeto específico.
3. Adicionando Tarefas: Adicione tarefas diretamente à fila através da interface do aplicativo ou usando atalhos de teclado. Especifique qual agente deve lidar com a tarefa (ex: use Claude para tarefas de escrita criativa e Codex para geração pura de código).
4. Gerenciando a Execução: Monitore a fila enquanto as tarefas são executadas em paralelo. Se uma tarefa exigir modificação de arquivo ou execução de comando, ela pausará e aguardará aprovação na Caixa de Entrada.
5. Aprovando Ações: Revise a prévia do diff e os argumentos do comando na Caixa de Entrada. Aprove a ação para permitir que o agente prossiga, ou negue-a. Configure regras de aprovação automática para operações de baixo risco e somente leitura para manter o fluxo.
6. Persistência do Fluxo de Trabalho: Utilize a integração com tmux/iTerm2 para garantir que, mesmo que você feche sua sessão de terminal, os processos do agente e os estados das tarefas persistam, permitindo que você se reconecte mais tarde.

Casos de Uso

1. Prototipagem Rápida de Funcionalidades: Um desenvolvedor precisa implementar um novo middleware de autenticação. Ele enfileira a tarefa para "Adicionar validação JWT ao middleware de autenticação". O Axel gera o worktree git necessário, o agente elabora o código, e o desenvolvedor aprova a edição do arquivo diretamente da notificação do macOS, tudo isso enquanto rastreia o custo de tokens.
2. Refatoração Complexa e Testes: Ao refatorar um módulo grande, os desenvolvedores podem enfileirar uma série de tarefas dependentes: 1) Analisar dependências (Claude), 2) Refatorar código (Codex) e 3) Executar suíte de testes completa (comando local). A fila garante que as etapas sejam executadas sequencialmente somente após a conclusão e aprovação da etapa anterior.
3. Atualizações Automatizadas de Documentação: Para projetos que exigem sincronização frequente de documentação, os desenvolvedores podem definir uma regra de aprovação automática para pequenas edições com limite de tokens em arquivos de documentação (*.md). Qualquer modificação de agente nesses arquivos é mesclada instantaneamente, desde que a alteração seja pequena.
4. Implantação de Habilidades entre Agentes: Uma equipe usa uma habilidade personalizada específica para migração de esquema de banco de dados. Ao armazenar essa habilidade no diretório central ~/.config/axel/skills, qualquer agente iniciado dentro de uma sessão gerenciada pelo Axel pode acessar e utilizar imediatamente essa habilidade sem configuração manual.

FAQ

P: Quais modelos de IA o Axel suporta atualmente? A: O Axel é projetado para ser agnóstico em relação aos agentes, suportando modelos populares como Claude da Anthropic, Codex da OpenAI e modelos personalizados como OpenCode e Antigravity. O suporte é gerenciado através de arquivos de configuração.

P: O Axel é compatível com minha configuração de terminal existente? A: Sim. O Axel se integra perfeitamente com tmux e iTerm2, garantindo que suas sessões de terminal sejam persistentes. Você pode fechar seu laptop ou aplicativo de terminal e retomar seu trabalho exatamente de onde os agentes pararam.

P: Como o Axel lida com segurança e alterações não autorizadas? A: A segurança é fundamental. Por padrão, nada é executado sem aprovação explícita do usuário. Cada edição de arquivo ou execução de comando é bloqueada até que você revise o contexto completo (incluindo prévias de diff) na Caixa de Entrada e aprove manualmente a ação, a menos que uma regra explícita de aprovação automática esteja definida.

P: Posso rastrear o custo financeiro do uso de agentes de IA? A: Com certeza. O Axel possui rastreamento integrado de tokens e custos. Ele exibe os tokens de entrada/saída e o custo estimado em USD associado a cada tarefa executada, fornecendo transparência sobre seus gastos com LLM.

P: O Axel está disponível em plataformas além do macOS? A: O Axel está sendo desenvolvido atualmente como um aplicativo nativo SwiftUI especificamente para o ecossistema Apple, incluindo macOS, com potencial para integração com iOS e visionOS no futuro.