nac: delegue tarefas ambiciosas de longo prazo a agentes de IA sem perder o foco

Para quem é

• Para usuários que querem delegar tarefas grandes e de longo prazo a agentes de IA sem perder o controle: o nac é um framework de execução de agentes de código aberto da Arcee, com arquitetura de thread-and-episode (threads e episódios) — um orquestrador central cuida do planejamento e da decomposição do trabalho, mas ele próprio não pode executar comandos nem editar arquivos, apenas iniciar threads; ao final de cada thread, é retornado um "episode", ou seja, um resumo estruturado do trabalho que informa exatamente o que foi feito.
• Para quem já usa outras ferramentas de agente (harness) e quer integrar o nac: a descrição oficial indica que o nac oferece um onboarding skill portátil e integração MCP; basta colar o snippet de integração oficial na ferramenta de agente de sua escolha para instalar o nac, concluir a configuração e conectar o MCP.
• Não serve como executor de linha de comando direto: o orquestrador não pode rodar comandos nem alterar arquivos por você; toda a execução acontece nas threads iniciadas.
• As evidências não indicam a lista específica de clientes de agente suportados, a compatibilidade de plataformas nem os requisitos de recursos — isso permanece desconhecido.

Primeira tentativa em 3 minutos

Caminho principal recomendado: instalador oficial → login por device code → dashboard local.

1. Pré-requisitos: as evidências não trazem as dependências prévias nem o comando reproduzível do instalador; siga as instruções de instalação do README oficial. Após a instalação, o nac-web será colocado pelo instalador em $HOME/.local/bin; se necessário, adicione esse diretório ao PATH.
2. Escolha a autenticação de modelo — etapa obrigatória antes de iniciar uma sessão (também pode ser feita depois no dashboard). O caminho recomendado oficialmente é o login por device code da Arcee, que dá acesso aos modelos Latest Open e Arcee Trinity:

nac-web arcee-auth login

1. Inicie o dashboard a partir do diretório do seu projeto. Sinal de sucesso: o dashboard fica acessível, a autenticação está concluída e é possível escolher o modelo.

Atualizações posteriores: o nac traz uma função nativa de atualização, que instala a versão estável mais recente:

nac-web upgrade

Métodos de autenticação alternativos (apenas como observação secundária): nac-web codex-auth login usa uma conta ChatGPT via OAuth para obter modelos da OpenAI; ou exporte uma API key de um provedor de catálogo (como OPENAI_API_KEY). Atenção: o login envolve as credenciais da sua conta; antes de iniciar uma sessão, é obrigatório escolher o método de autenticação de modelo. Na primeira tentativa, recomenda-se iniciar apenas uma tarefa de baixo risco e com resultado observável, priorizando ações de natureza somente leitura; o trabalho do episode é executado pelas threads, e tarefas reais podem incluir operações de escrita — deve haver uma etapa de confirmação antes de efeitos colaterais importantes.

Casos de uso

1. Delegar uma tarefa de longo prazo e recuperar um resultado estruturado: no dashboard local, inicie uma sessão com um modelo já autenticado (recomendados os modelos Latest Open ou Arcee Trinity após o login por device code da Arcee) e lance uma tarefa. O orquestrador decompõe o trabalho e inicia as threads; ao final, cada thread retorna um episode — um resumo estruturado do que foi concluído. Resultado esperado: você não precisa acompanhar todo o processo e fica sabendo o resultado de cada trecho de trabalho pelo episode.

2. Integrar o nac à sua ferramenta de agente atual: a documentação oficial oferece um onboarding skill portátil e integração MCP; basta colar o snippet de integração oficial na ferramenta de agente de sua escolha para instalar o nac, concluir a configuração e conectar o MCP. As evidências não trazem detalhes passo a passo para clientes de agente específicos; o comportamento na sua ferramenta deve ser verificado pelo resultado real da integração — o que se pode confirmar é essa capacidade de integração fornecida oficialmente.

Limites de uso

• Natureza de leitura e escrita: o orquestrador em si apenas planeja e inicia threads, sem executar comandos nem editar arquivos; a execução real acontece dentro das threads, portanto tarefas reais podem incluir operações de escrita e execução de comandos — na primeira tentativa, comece com uma tarefa de resultado observável e exija confirmação antes de efeitos colaterais importantes.
• Requisitos de autenticação: antes de iniciar uma sessão, é preciso concluir a autenticação de modelo (recomendado nac-web arcee-auth login por device code; ou nac-web codex-auth login; ou exportar uma API key de provedor de catálogo como OPENAI_API_KEY). As evidências não indicam se há cota gratuita ou cobrança — permanece desconhecido.
• Componentes locais: o nac-web é colocado pelo instalador em $HOME/.local/bin, e o dashboard roda localmente, o que constitui escrita de estado local; as evidências não trazem instruções de desinstalação.
• Restrição explícita oficial: o orquestrador não pode executar comandos nem editar arquivos, apenas obter resultados estruturados na forma de episodes por meio das threads.
• Informações-chave ainda não confirmadas: quais clientes de agente são suportados, custos e cotas das chamadas de modelo, isolamento de ambiente e limites de permissão da execução das threads, e os comandos e nomes exatos de instalação do onboarding skill portátil — nada disso é indicado nas evidências oficiais. Antes de assumir tarefas de alto risco, verifique esses pontos na documentação ou no repositório oficial; não infira "não há risco" a partir de "não encontrei menção".