> ## Documentation Index
> Fetch the complete documentation index at: https://zos-help.zoryon.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Comandos de terminal

> Comandos práticos para instalar, atualizar, diagnosticar e operar o Zoryon COIA fora do agente.

# Comandos de terminal

Estes são os comandos práticos para instalar, atualizar, diagnosticar e operar o Zoryon COIA fora do agente.

## Instalação e atualização

```bash theme={null}
curl -fsSL https://z-os.zoryon.co/install.sh | KEY=SUA-KEY bash
curl -fsSL https://z-os.zoryon.co/install.sh | bash -s -- --update
```

<CardGroup cols={2}>
  <Card title="Instalar" icon="download">
    Ativa a licença, baixa o pacote privado e instala o COIA localmente.
  </Card>

  <Card title="Atualizar" icon="refresh-cw">
    Atualiza uma instalação já ativada, preservando o hub do cliente.
  </Card>
</CardGroup>

## Comando principal

```bash theme={null}
zoryon --doctor
zoryon setup
zoryon status
zoryon pull
zoryon push
zoryon sync
zoryon comandos
```

| Comando           | O que faz                                                         |
| ----------------- | ----------------------------------------------------------------- |
| `zoryon --doctor` | Verifica estrutura, licença, help, porta, plugins e dependências. |
| `zoryon setup`    | Abre o setup guiado.                                              |
| `zoryon status`   | Mostra o status do backup.                                        |
| `zoryon pull`     | Puxa backup privado antes de trabalhar.                           |
| `zoryon push`     | Envia backup privado ao terminar.                                 |
| `zoryon sync`     | Faz pull e depois push.                                           |
| `zoryon comandos` | Lista os comandos internos do produto.                            |

## Aliases diretos

```bash theme={null}
zoryon-setup
zoryon-status
zoryon-pull
zoryon-push
zoryon-sync
```

Use os aliases quando quiser comandos curtos. Eles chamam o mesmo motor usado pelo comando principal `zoryon`.

## Setup interativo

```bash theme={null}
zoryon-setup
zoryon-setup --status
ZORYON_COIA_NO_CLACK=1 zoryon-setup
```

* `zoryon-setup`: abre o fluxo guiado com backup primeiro, APIs opcionais depois e doctor no fim.
* `zoryon-setup --status`: mostra hub, produto, ferramentas, chaves gravadas por nome e status do backup.
* `ZORYON_COIA_NO_CLACK=1 zoryon-setup`: força o modo simples se a interface visual falhar.

## Codex

```bash theme={null}
codex plugin marketplace add ~/ZoryonCOIA-app
codex plugin add zr-coia-hub@zoryon-coia
codex plugin add zr-coia-marketing@zoryon-coia
codex plugin add zr-coia-vendas@zoryon-coia
codex plugin add zr-coia-operacoes@zoryon-coia
```

## Motor direto

Use apenas para diagnóstico técnico:

```bash theme={null}
bash ~/ZoryonCOIA-app/plugins/zr-coia-hub/scripts/run.sh motor.help
bash ~/ZoryonCOIA-app/plugins/zr-coia-hub/scripts/run.sh motor.doctor --pos-install --hub ~/ZoryonCOIA --raiz ~/ZoryonCOIA-app/plugins/zr-coia-hub
bash ~/ZoryonCOIA-app/plugins/zr-coia-hub/scripts/run.sh motor.nuvem status
```

<Warning>
  Para uso normal, prefira `zoryon`, `zoryon-setup`, `zoryon-pull` e `zoryon-push`. O motor direto é rota técnica.
</Warning>