Repolode
coleam00

coleam00/Archon

Motor de workflows open source que executa processos de programação com IA e outros processos definidos em YAML, usando agentes, scripts e etapas de aprovação humana.

Estrelas
23,729
Forks
3,611
Issues abertas
180
Último commit
há 11 horas

O que é?

O Archon permite descrever em workflows YAML como o trabalho deve ser feito. Cada workflow é um grafo de nós: prompts para agentes de IA cuidam de decisões, comandos bash e scripts executam verificações determinísticas, loops repetem etapas até que um comando de teste passe, e nós de espera pausam a execução para que uma pessoa possa aprovar ou rejeitar. O objetivo é fazer com que a programação assistida por IA siga sempre o mesmo plano, as mesmas verificações e as mesmas etapas de aprovação, em vez de depender do resultado de uma execução isolada de um agente.

O pacote sdlc incluído implementa um pipeline de entrega de software: ele conduz uma issue pelas etapas de planejamento, implementação, revisão, espera pela CI e merge, com filas que assumem tarefas prontas e itens de atenção que só aparecem quando uma decisão é necessária. O mecanismo é genérico, então a mesma abordagem pode ser usada para produção de conteúdo, pesquisa ou operações. O Archon executa Claude Code, Codex e Pi por meio de suas próprias CLIs e SDKs, armazena logs de execução e dados de custos em um banco de dados SQLite local por padrão (com PostgreSQL opcional) e oferece uma CLI, um console web e integrações de chat com Slack, Telegram, GitHub e Discord.

A extensão é feita por meio de plugins para pacotes de workflows, provedores de agentes, forjas de código e interfaces de chat. Os plugins são instalados a partir de repositórios do GitHub com o comando archon plugin add. O projeto é escrito em TypeScript e executado no Bun.

Recursos principais

  • 01Defina workflows com várias etapas em YAML, usando nós de agente, bash, script, loop, espera e subworkflow.
  • 02Os loops repetem uma etapa até que um comando de shell, como a suíte de testes, seja concluído com sucesso.
  • 03Pausa as execuções para aprovação ou rejeição humana por meio de uma fila de atenção.
  • 04Executa cada tarefa do repositório em seu próprio git worktree, permitindo que várias avancem em paralelo.
  • 05Oferece suporte a Claude Code, Codex e Pi como provedores de agentes.
  • 06Inclui um pacote sdlc que transforma issues do GitHub em pull requests com merge realizado.

Casos de uso

  • Automatizar a entrega de issues até pull requests em um repositório, mantendo etapas de revisão e aprovação.
  • Padronizar como os agentes de programação com IA planejam, implementam e testam mudanças em uma equipe.
  • Criar processos repetíveis que não envolvam código, como produção de conteúdo ou pipelines de pesquisa com etapas executadas por agentes.
  • Hospedar por conta própria um histórico auditável das execuções dos agentes, seus resultados e custos para uma equipe.

Início rápido

  1. 1

    Instale o Claude Code e faça login, ou instale o Codex

  2. 2

    Instale o Archon com o Homebrew

    brew install coleam00/archon/archon
  3. 3

    Liste os workflows disponíveis no seu repositório git

    archon workflow list
  4. 4

    Execute um workflow de investigação incluído com uma pergunta

    archon workflow run archon-investigate "Why does the login test fail?"

Antes de usar

  • É necessário usar um provedor de agentes, como Claude Code ou Codex, com suas próprias contas.
  • Eventos anônimos de telemetria de uso são enviados por padrão.

Tópicos

Perguntas frequentes

O que é Archon?
Motor de workflows open source que executa processos de programação com IA e outros processos definidos em YAML, usando agentes, scripts e etapas de aprovação humana. O Archon permite descrever em workflows YAML como o trabalho deve ser feito. Cada workflow é um grafo de nós: prompts para agentes de IA cuidam de decisões, comandos bash e scripts executam verificações determinísticas, loops repetem etapas até que um comando de teste passe, e nós de espera pausam a execução para que uma pessoa possa aprovar ou rejeitar. O objetivo é fazer com que a programação assistida por IA siga sempre o mesmo plano, as mesmas verificações e as mesmas etapas de aprovação, em vez de depender do resultado de uma execução isolada de um agente.
Archon é gratuito? Qual é a licença?
Archon é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
Archon ainda é mantido?
Manutenção ativa. O último commit de Archon foi em 20 de out. de 2026.
Para que posso usar Archon?
Automatizar a entrega de issues até pull requests em um repositório, mantendo etapas de revisão e aprovação. Padronizar como os agentes de programação com IA planejam, implementam e testam mudanças em uma equipe. Criar processos repetíveis que não envolvam código, como produção de conteúdo ou pipelines de pesquisa com etapas executadas por agentes. Hospedar por conta própria um histórico auditável das execuções dos agentes, seus resultados e custos para uma equipe.
Como instalar Archon?
Instale o Claude Code e faça login, ou instale o Codex Instale o Archon com o Homebrew: brew install coleam00/archon/archon Liste os workflows disponíveis no seu repositório git: archon workflow list Execute um workflow de investigação incluído com uma pergunta: archon workflow run archon-investigate "Why does the login test fail?"
Onde consigo Archon?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/coleam00/Archon

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados