Skip to main content
Cada seção abaixo é um sintoma real já visto em produção, não uma lista genérica de “tente desligar e ligar de novo”. Se o seu problema não estiver aqui, vá direto para Fale com o suporte — o fluxo de diagnóstico já roda antes de qualquer contato humano.
Antes de ler qualquer seção abaixo, rode o diagnóstico. Ele aponta exatamente qual destes sintomas você tem:
O doctor verifica estrutura, licença, ajuda/coia, plugins e dependências — e reporta cada bloco separadamente. Um FAIL não significa reinstalar do zero; significa que um bloco específico está fora do lugar.
  • FAIL de estrutura: normalmente pasta ou arquivo esperado da instalação não está onde deveria. Rode zoryon plugins para reconferir o registro nos agentes e, se persistir, repita a instalação com o mesmo comando usado da primeira vez (ele reaproveita a licença já ativa).
  • FAIL de dependência: alguma ferramenta do computador (Git, gh, Node, Python) está ausente ou desatualizada. O setup guiado instala o que faltar:
  • FAIL de ajuda/coia/plugins: os comandos essenciais não estão respondendo no seu agente. Veja Host ficou desatualizado depois do update abaixo — a causa costuma ser a mesma.
Depois de qualquer correção, rode zoryon --doctor de novo até o resultado ficar limpo. Detalhe de cada verificação em Doctor: diagnóstico da instalação.
A ativação é por máquina e revalida sozinha, com 7 dias de tolerância offline. Se o doctor ou o produto disserem que a licença não está ativa:
A key chega no e-mail do recibo de compra — é a mesma usada na instalação. Se você trocou de computador ou reinstalou o sistema operacional, reative com o mesmo comando; não é preciso comprar de novo. Se a ativação recusar a key repetidamente, isso já é caso para suporte com o resultado do zoryon --doctor em mãos.
Isto não é um erro do sistema — é o verificador automático segurando material abaixo do padrão antes de virar entrega final. Nenhuma peça sai sem passar pelo gate; é o que garante qualidade, não burocracia.O motivo da reprovação vem descrito ao lado da peça, explicando o que corrigir e onde. Se a mensagem não fizer sentido, pergunte com suas palavras:
A ajuda lê o motivo real da reprovação e traduz em linguagem direta — nunca responde de memória o que já está escrito no resultado do verificador.
A instalação usa duas pastas: a -app (onde você abre o agente) e o hub (onde ficam dados, wiki, licença e backup do seu negócio). Se o sistema disser que não encontra o hub, ou o /comecar parecer começar do zero de novo:
1

Confirme o caminho salvo na instalação

O instalador grava o nome/caminho escolhido em ~/.zoryon-coia/install.json. Se você renomeou ou moveu a pasta manualmente depois de instalar, o sistema perde a referência.
2

Não abra a pasta errada

Sempre abra o agente na pasta -app (ex.: ~/ZoryonCOIA-app), nunca diretamente no hub de dados (~/ZoryonCOIA). O hub é lido automaticamente a partir da pasta -app; abrir o hub direto quebra essa referência.
3

Rode o diagnóstico com o caminho certo

Se o hub realmente sumiu (pasta apagada ou movida fora do fluxo do produto) e você tem backup configurado, o caminho de recuperação é puxar a versão da nuvem — veja Backup no GitHub.
O pacote é atualizado pelo instalador, mas cada agente precisa “enxergar” a pasta nova. Se depois de rodar install.sh --update o comportamento continuar antigo (comando sumiu, skill não reconhecida, resposta de versão anterior):Atalho que cobre Claude Code, Codex e Cursor de uma vez:
Depois, confirme com zoryon --doctor. Passo a passo completo em Atualizar o Zoryon COIA.
O zoryon-pull nunca cria commit: ele guarda suas mudanças locais em um stash temporário, puxa a versão da nuvem e tenta reaplicar seu trabalho por cima. Se as duas versões mexeram no mesmo arquivo, ele para em vez de decidir por você — isso é intencional, para não perder trabalho local.
1

Leia o aviso de conflito

O zoryon-pull indica exatamente o que ficou pendente de conciliação. Nada é perdido; o trabalho local fica preservado no stash até você resolver.
2

Resolva o arquivo em conflito

Escolha manualmente qual versão manter (a sua, a da nuvem, ou uma mescla) no arquivo apontado pelo aviso.
3

Confirme o estado antes de enviar de novo

4

Envie o backup resolvido

Se um envio anterior tiver ficado pendente, o próximo zoryon-push reaproveita esse commit em vez de criar duplicata.
Para o dia a dia sem pensar na ordem, zoryon-sync faz pull e só envia quando o pull confirmar que está seguro — e para sozinho em divergência ou modo offline. Detalhe completo em Backup no GitHub.
Guardou o resultado do zoryon --doctor? Ter ele em mãos acelera qualquer contato com o suporte.