Sobre o projeto

amux é um plano de controle open-source para agentes de codificação de IA, projetado para coordenar múltiplos trabalhadores de IA (como Claude Code, Codex, Gemini CLI, OpenCode e Ollama) a partir de um único painel web ou aplicativo móvel. É local-first, auto-hospedado e construído como um único binário Rust com armazenamento SQLite. Os principais recursos incluem: - **Tarefas atômicas**: Um quadro kanban compartilhado com reivindicação compare-and-swap para evitar trabalho duplicado; as tarefas exigem evidência para 'concluída' e verificação por pares para 'verificada'. - **Consciência dos workers**: Os workers podem ver o status do fleet, espiar terminais de pares e se coordenar por meio de mensagens entre workers com carimbo de origem. - **Direcionamento**: Os usuários podem digitar em sessões em execução a partir do painel ou telefone para redirecionar tarefas durante a execução. - **Agendamentos e loops**: Prompts recorrentes estilo cron e loops autônomos para execuções noturnas. - **Grupos e escopo**: Os workers podem ser organizados em lanes com memória compartilhada, ambiente e gates. - **Troca de modelo**: Troque modelos ou provedores em workers em execução sem perder contexto. - **Histórico de mensagens**: Todos os prompts, respostas e entregas são registrados para recuperação posterior. - **Auto-recuperação**: Um watchdog auto-compacta, reinicia sessões travadas e reproduz a última mensagem. A instalação é simples com um instalador de um comando que configura o servidor, CLI e serviços do sistema (launchd no macOS, systemd no Linux). O painel está embutido no binário do servidor, e o CLI (`amux-rs`) fornece comandos para gerenciamento de quadro, controle de workers e agendamento. A arquitetura consiste em quatro crates Rust: server, dashboard, CLI e tipos de domínio core. Ele usa oito primitivas (board, workers, schedulers, filesystem, groups, memories, environment, messages) para compor novos recursos. Um recurso notável são os arquivos `.mdai`, que são arquivos markdown computados que atuam como nós em um DAG, sintetizando conteúdo de fontes conectadas por meio de prompts de modelo. Isso permite geração dinâmica de documentos com detecção de ciclos e cache. A segurança é local-first com autenticação por bearer token, e o projeto enfatiza não expor a porta do servidor à internet, recomendando Tailscale para acesso remoto. O projeto é licenciado sob MIT + Commons Clause, livre para uso e auto-hospedagem, com revenda comercial exigindo uma licença separada. Está em desenvolvimento ativo com um roadmap para se tornar um sistema operacional durável em torno de agentes.