Base de conhecimento

Referência de comandos do Zinnector®

Cada comando do Zinnector® exatamente como zinnector --help o lista — argumentos, sinalizadores e padrões, um exemplo executável e o que ele imprime — gerado a partir da própria CLI para que não divirja da versão que você instalou.

Todos os comandos compatíveis com o Zinnector® 0.1.6 — 43 no total, exatamente como zinnector --help os lista — com suas opções, um exemplo executável e o que você deve visualizar. Esta página é gerada a partir da própria CLI, portanto não pode divergir da ferramenta que você instalou; se um comando listado aqui estiver ausente em sua máquina, execute npm install -g zinnector@latest.

Antes de começar

Instale-o com npm install -g zinnector no Node 24 ou mais recente e, em seguida, verifique a instalação com zinnector --version e zinnector --help. O guia de primeiros passos aborda os primeiros cinco minutos; esta página é a referência para você consultar sempre que necessário.

Todos os comandos aceitam -h, --help. Estas opções globais precedem o nome do comando:

opção	o que faz
`-V, --version`	exibe a versão
`--profile <name>`	usa um perfil de credenciais nomeado

Os comandos

`zinnector new`

Crie a estrutura de um projeto WordPress que você pode executar imediatamente.

zinnector new [options] [name]

argumento	obrigatório	o que é
`name`	não	diretório no qual o projeto será criado e o nome do projeto — obrigatório, a menos que se use --here

opção	o que faz	padrão
`-t, --template <kind>`	um de: site, plugin, theme	`"site"`
`--php <version>`	versão do PHP para o desenvolvimento	`"8.3"`
`--wp <version>`	versão do WordPress para o ambiente de execução local	`"latest"`
`--runtime <name>`	playground ou docker	`"playground"`
`--here`	gerar a estrutura no diretório atual em vez de em um novo

Exemplo

zinnector new my-site

O que você vê — capturado — 0.1.2 no Linux

Created my-site  ·  site
──────────────────────────

  + .gitignore
  + README.md
  + wp-content/mu-plugins/000-zinnector-dev.php
  + wp-content/plugins/.gitkeep
  + wp-content/themes/.gitkeep
  + zinnector.json

  php        8.3
  wordpress  latest
  runtime    playground

→ run it:
    cd my-site
    zinnector dev

→ then, when you have a hosting slot:
    zinnector link     # point it at a site
    zinnector check    # pre-flight before you push
    zinnector push

`zinnector dev`

Execute este projeto localmente — nenhum Docker é necessário.

zinnector dev [options]

opção	o que faz	padrão
`--php <version>`	versão do PHP a ser executada (5.2–8.5 no playground, 7.4–8.5 no docker)
`--wp <version>`	versão do WordPress
`-p, --port <port>`	porta na qual servir
`--runtime <name>`	playground (padrão) ou docker
`--login`	iniciar sessão automaticamente como administrador	`true`
`--no-login`	não iniciar sessão automaticamente
`--once`	inicializar, relatar o que está em execução e depois parar
`--yes`	instalar o runtime local sem perguntar
`--reset-runtime`	excluir o runtime instalado e instalá-lo novamente
`-v, --verbose`	mostrar a saída própria do runtime

Exemplo

cd my-site
zinnector dev

O que você vê — capturado — 0.1.2. A primeira execução solicita uma vez o download do ambiente de execução do WordPress (~570 MB); passe --yes para pular a pergunta

my-site  ·  WordPress Playground (WASM, no Docker)
───────────────────────────────────────────────────

  serving    a WordPress project
  from       /home/you/my-site
  php        8.3
  wordpress  latest

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

  Ctrl-C to stop

`zinnector login`

Entrar — com sua própria conta no navegador ou com uma chave de API.

zinnector login [options]

opção	o que faz	padrão
`--profile <name>`	armazena sob um perfil nomeado (padrão: default)
`--api <url>`	URL base da API	`"https://api.zinndigital.com"`
`--api-key`	cola uma chave de API por organização em vez de iniciar sessão como você mesmo
`--issuer <url>`	o serviço de início de sessão	`"https://auth.zinndigital.com/realms/zinn"`
`--no-browser`	imprime o link de início de sessão sem tentar abrir um navegador

Exemplo

zinnector login

O que você vê — a chave é digitada no prompt, nunca na linha de comando. No CI, use um pipe: echo "$ZINN_API_KEY" | zinnector login --profile ci

Sign in to Zinn Digital®  ·  https://api.zinndigital.com
────────────────────────────────────────────────────

  API key: ••••••••••••••••••••••••••••

✔ signed in as you@example.com (Acme Ltd) — profile “default”
→ next: zinnector sites

`zinnector logout`

Esquecer um login armazenado.

zinnector logout [options]

opção	o que faz	padrão
`--profile <name>`	qual perfil esquecer (padrão: default)

Exemplo

zinnector logout

O que você vê

✔ signed out of profile “default”

`zinnector whoami`

Mostra com qual conta esta CLI está conectada e o que ela pode acessar.

zinnector whoami [options]

opção	o que faz	padrão
`--profile <name>`	use um perfil nomeado
`--scopes`	liste as permissões que uma chave de API possui
`--json`	saída legível por máquina

Exemplo

zinnector whoami --scopes

O que você vê — capturado a partir de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único foram substituídos


Signed in  ·  https://api.zinndigital.com
──────────────────────────────────────────
account        you@example.com
as             a person, signed in through the browser
organisations  8 — listed below
mode           live
credential     profile “default”

  · Example Org  owner · 01a00000-0000-7000-8000-000000000000
  · Example Org· 01a00001-0000-7000-8000-000000000001
  · Example Org· 01a00002-0000-7000-8000-000000000002
  · Example Org· 01a00003-0000-7000-8000-000000000003
  · Example Org· 01a00004-0000-7000-8000-000000000004
  · Example Org· 01a00005-0000-7000-8000-000000000005
  · Example Org· 01a00006-0000-7000-8000-000000000006
  · Example Org· 01a00007-0000-7000-8000-000000000007

  scopes belong to API keys — a signed-in person acts with their ROLE in each organisation (shown above).

`zinnector sites`

Liste os sites que esta chave pode ver.

zinnector sites [options]

opção	o que faz	padrão
`--json`	saída legível por máquina
`--status <status>`	somente sites neste status

Exemplo

zinnector sites

O que você vê — capturado a partir de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único foram substituídos


Sites  ·  12
─────────────
domain          status  php      target  id
example-2.com   active  php —    fleet   01a00000-0000-7000-8000-000000000000
example-3.com   active  php —    fleet   01a00001-0000-7000-8000-000000000001
example-4.com   active  php —    fleet   01a00002-0000-7000-8000-000000000002
example-5.com   active  php 8.5  fleet   01a00003-0000-7000-8000-000000000003
example-6.com   active  php —    fleet   01a00004-0000-7000-8000-000000000004
example.com     active  php 8.4  fleet   01a00005-0000-7000-8000-000000000005
example-7.com   active  php —    fleet   01a00006-0000-7000-8000-000000000006
example-8.com   active  php 8.5  fleet   01a00007-0000-7000-8000-000000000007
example-9.com   active  php 8.5  fleet   01a00008-0000-7000-8000-000000000008
example-10.com  active  php 8.5  fleet   01a00009-0000-7000-8000-000000000009
example-11.com  active  php 8.5  fleet   01a00010-0000-7000-8000-000000000010
example-12.com  active  php 8.5  fleet   01a00011-0000-7000-8000-000000000011

`zinnector status`

Tudo o que a plataforma sabe sobre um site.

zinnector status [options] [site]

argumento	obrigatório	o que é
`site`	não	um id de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--json`	saída legível por máquina

Exemplo

zinnector status example.com

O que você vê — capturado a partir de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único foram substituídos


example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────
status         active
product line   footprint_free
stack          wordpress
region         fsn1
deploy target  fleet
plan           PBN 10

● PHP
version        8.4
can switch to  8.5, 8.4, 8.3, 8.2, 8.1, 8.0, 7.4

● Quota
disk      188 MB used of 500.0 GB
files     6,313 of 2,000,000
database  1 MB

● Deploy
status         building
target         fleet
repository     —
commit         —
live url       —
last deployed  2026-09-14T01:29:26.991511Z

● WordPress
version     7.1
up to date  yes
multisite   no

`zinnector share`

Dê acesso a uma pessoa a UM site — um desenvolvedor, um designer, um cliente.

zinnector share [options] <site> <email>

argumento	obrigatório	o que é
`site`	sim	o site a compartilhar — um id, domínio principal ou nome
`email`	sim	a quem conceder acesso — a pessoa receberá um convite por e-mail se ainda não tiver uma conta

opção	o que faz	padrão
`--role <role>`	o que podem fazer: viewer, editor, manager
`--reason <text>`	por que precisam disso — mantido com a concessão para a trilha de auditoria
`--until <date>`	quando o acesso expira por conta própria (AAAA-MM-DD); omita para manter até ser revogado
`--json`	saída legível por máquina

Exemplo

zinnector share example.com dev@agency.test --role editor --reason "rebuild the checkout"

O que você vê — a forma exata impressa pelo comando, a partir da fonte (o W40-DEVTOOL adicionou isso após esta última captura do arquivo); seus domínios, IDs e datas serão diferentes

Shared example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
────────────────────────────────────────────────────────────

✔ invited dev@agency.test as editor
  They have no account yet, so an invitation has been emailed. Until they
  sign in and accept it they can see nothing; the moment they do, the site is theirs.

→ what they do next, on their own machine:
    npm i -g zinnector && zinnector login   # sign in as themselves
    zinnector clone example.com   # pull the files down

`zinnector collaborators`

Quem recebeu acesso a um site e se aceitou.

zinnector collaborators [options] [site]

argumento	obrigatório	o que é
`site`	não	um id de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--json`	saída legível por máquina

Exemplo

zinnector collaborators example.com

O que você vê — capturado de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, ids e links de uso único foram substituídos. o formato exato impresso pelo comando, a partir da fonte (W40-DEVTOOL adicionou estes após a última captura deste arquivo); seus domínios, ids e datas serão diferentes


Access to example.com  ·  3
───────────────────────────────────────────────────────────
who              role    status   ends  why                                          grant
dev@agency.test  viewer  revoked  —     Example Org— revoked immediately after       01a00000-0000-7000-8000-000000000000
dev@agency.test  viewer  revoked  —     Example Org— revoked at the end of the walk  01a00001-0000-7000-8000-000000000001
dev@agency.test  editor  revoked  —     Example Org— revoked at the end of the walk  01a00002-0000-7000-8000-000000000002

`zinnector unshare`

Revogue o acesso de uma pessoa a um site — por e-mail ou grant id.

zinnector unshare [options] <site> <who>

argumento	obrigatório	o que é
`site`	sim	o site do qual retirar o acesso — um id, domínio principal ou nome
`who`	sim	a pessoa a ser removida — seu endereço de e-mail ou o id da concessão de zinnector collaborators

opção	o que faz	padrão
`--yes`	não perguntar

Exemplo

zinnector unshare example.com dev@agency.test --yes

O que você vê — a forma exata impressa pelo comando, a partir da fonte (o W40-DEVTOOL adicionou isso após esta última captura do arquivo); seus domínios, IDs e datas serão diferentes

✔ withdrew the invitation to dev@agency.test

`zinnector invitations`

Os convites que estão esperando por você e aceitar um.

zinnector invitations [options] [command]

Exemplo

zinnector invitations

O que você vê — capturado de uma execução real de 0.1.5 em produção em 2026-09-14; domínios, ids e links de uso único foram substituídos. o formato exato exibido pelo comando, a partir da origem (W40-DEVTOOL adicionou estes após a última captura deste arquivo); seus domínios, ids e datas serão diferentes; sem subcomando, ele executa list


Invitations  ·  0
──────────────────

● nothing waiting for you

`zinnector invitations list`

Convites endereçados à conta na qual você iniciou sessão.

zinnector invitations list [options]

opção	o que faz	padrão
`--json`	saída legível por máquina

Exemplo

zinnector invitations list


Invitations  ·  0
──────────────────

● nothing waiting for you

`zinnector invitations accept`

Aceite um convite — o site será seu assim que este comando for concluído.

zinnector invitations accept [options] <id>

argumento	obrigatório	o que é
`id`	sim	o id do convite de zinnector invitations — um prefixo exclusivo dele é suficiente

Exemplo

zinnector invitations accept 01a03f39-9c11-7b02-a7e0-2e4d0c5f1b77

O que você vê — a forma exata impressa pelo comando, a partir da fonte (o W40-DEVTOOL adicionou isso após esta última captura do arquivo); seus domínios, IDs e datas serão diferentes

✔ you now have access to example.com

`zinnector link`

Aponte este projeto para um slot de hospedagem (e conecte o repositório dele).

zinnector link [options] [site]

argumento	obrigatório	o que é
`site`	não	um id de site, domínio primário ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--repo <owner/name>`	conecta este repositório ao site na plataforma
`--provider <name>`	a conta conectada por meio da qual implantar: github_app, github ou gitlab (padrão: aquela conectada pela sua organização)
`--branch <name>`	branch a partir da qual um push realiza a implantação
`--no-repo`	apenas grava o zinnector.json; não altera a plataforma

Exemplo

zinnector link example.com --repo acme/example-site --branch main

O que você vê

✔ this project deploys to example.com (01a03f39-730a-7dc4-84b0-5d4f7582dd04)
  written to zinnector.json — commit it so everyone deploys to the same slot
✔ the platform will deploy acme/example-site (main)
→ next: zinnector check

`zinnector pull`

Puxe os arquivos de um site hospedado para este projeto para desenvolvimento local — e execute novamente para sincronizar novamente.

zinnector pull [options] [site]

argumento	obrigatório	o que é
`site`	não	um ID de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--via <seam>`	auto (padrão), git ou backup	`"auto"`
`--fresh`	cria um novo backup em vez de usar o mais recente (consome um slot sob demanda)
`--max-age <hours>`	aceita o backup mais recente se for mais recente do que isto	`"24"`
`--full`	toda a raiz do documento, incluindo o núcleo do WordPress (padrão: apenas wp-content)
`--no-uploads`	não inclui wp-content/uploads (mídia)
`--no-database`	não inclui o banco de dados do site — obtém apenas os arquivos
`--live-config`	também grava o wp-config.php — contém as credenciais do banco de dados de PRODUÇÃO
`--clean`	esvazia wp-content antes de extrair, para que as exclusões no site sejam espelhadas
`--dry-run`	informa o que aconteceria e para
`--yes`	não pergunta

Exemplo

zinnector pull

O que você vê

Pull example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
─────────────────────────────────────────────────────────────

● via git — the site syncs to its own repository and this is a clone of it
✔ fast-forwarded 3 commits 4f1c2a9b → 9d2e7c14

● not synced, and why
  ✖ database                     the local playground has its own; the site's is not copied
  ✖ offloaded media              objects in storage are not in the site's files
  ✖ anything outside the repository  only wp-content syncs

→ next: zinnector dev

`zinnector clone`

Crie um projeto local a partir de um site hospedado: clone seu repositório ou extraia seus arquivos.

zinnector clone [options] <site> [dir]

argumento	obrigatório	o que é
`site`	sim	o site hospedado a ser copiado — um id, domínio principal ou nome
`dir`	não	diretório a ser criado — o padrão é o domínio principal do site

opção	o que faz	padrão
`--via <seam>`	auto (padrão), git ou backup	`"auto"`
`--fresh`	cria um novo backup em vez de usar o mais recente
`--full`	a raiz inteira de documentos, núcleo do WordPress incluído
`--no-uploads`	deixa wp-content/uploads (mídia) de fora
`--no-database`	deixa o banco de dados do site de fora — copia apenas os arquivos
`--live-config`	também grava wp-config.php — ele contém as credenciais do banco de dados LIVE
`--yes`	não pergunta

Exemplo

zinnector clone client.example.com

O que você vê

Clone client.example.com  ·  client.example.com
──────────────────────────────────────────────────────

✔ wrote client.example.com/zinnector.json (php 8.3, wordpress 6.7.1)
● via backup — the site does not sync to a repository
✔ downloaded 214 MB and extracted wp-content

● not synced, and why
  ✖ database                     the local playground has its own; the site's is not copied
  ✖ offloaded media              objects in storage are not in the site's files
  ✖ wp-config.php                holds the live database credentials (--live-config to write it)
  ✖ WordPress core               the runtime supplies the version the slot runs (--full to take it)

→ next: zinnector dev

→ run it:
    cd client.example.com
    zinnector dev

`zinnector sync`

Sincronização bidirecional entre os arquivos ativos de um site e seu repositório.

zinnector sync [options] [command]

Exemplo

zinnector sync --help

O que você vê — sem subcomando, zinnector sync <site> equivale a sync status

Usage: zinnector sync [options] [command]

two-way sync between a site's live files and its repository

  site → repository   zinnector sync run   commits the live files and pushes the branch
  repository → site   zinnector push       builds the branch and publishes it

`zinnector sync status`

Status da sincronização bidirecional e suas últimas execuções.

zinnector sync status [options] [site]

argumento	obrigatório	o que é
`site`	não	um id de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--json`	saída legível por máquina

Exemplo

zinnector sync status example.com

O que você vê — capturado a partir de uma execução real da versão 0.1.4 em um site de teste em 2026-09-12; o domínio e os IDs foram substituídos por valores de exemplo

Two-way sync — example.com
──────────────────────────

repository   acme/example-site (main)
available    yes
sync         on
state        synced
last sync    2026-09-12T22:51:41.539832Z
note         Started from acme/example-site@main.

run        files       commit         when
synced     2 changed   da85d73cef5f   2026-09-12T22:52:10.117301Z

`zinnector sync on`

Ative a sincronização bidirecional (não envia nada por si só).

zinnector sync on [options] [site]

argumento	obrigatório	o que é
`site`	não	um id de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--subdir <path>`	sincroniza apenas este subdiretório do site
`--json`	saída legível por máquina

Exemplo

zinnector sync on example.com

O que você vê — requer um repositório conectado em sua própria conta do GitHub; não faz push de nada por conta própria

✔ two-way sync is on

Two-way sync — example.com
…
→ next: zinnector sync run

`zinnector sync off`

Desative a sincronização bidirecional.

zinnector sync off [options] [site]

argumento	obrigatório	o que é
`site`	não	um id de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--subdir <path>`	sincroniza apenas este subdiretório do site
`--json`	saída legível por máquina

Exemplo

zinnector sync off example.com

O que você vê

✔ two-way sync is off

`zinnector sync run`

Faça o commit dos arquivos ativos do site no repositório agora.

zinnector sync run [options] [site]

argumento	obrigatório	o que é
`site`	não	um id de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--json`	saída legível por máquina

Exemplo

zinnector sync run example.com

O que você vê — capturado de uma execução real da versão 0.1.4 em um site de teste em 2026-09-12; o domínio e os ids foram substituídos por valores de exemplo. Uma execução que o repositório já ultrapassou é, em vez disso, definida como HELD: nada é enviado por push ou sobrescrito, o comando é encerrado com código 1 e indica a próxima etapa

✔ committed 2 changed files da85d73cef5f

Two-way sync — example.com
…
→ next: git pull in your clone

`zinnector sync resolve`

Limpe uma sincronização retida escolhendo qual lado prevalece.

zinnector sync resolve [options] [site]

argumento	obrigatório	o que é
`site`	não	um id de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--keep <side>`	site (fazer commit do site por cima) ou repository (descartar as alterações não sincronizadas do site)
`--yes`	não perguntar
`--json`	saída legível por máquina

Exemplo

zinnector sync resolve example.com --keep repository --yes

O que você vê — capturado de uma execução real da versão 0.1.4 em um site de teste em 2026-09-12; o domínio e os ids foram substituídos por valores de exemplo. Sem --yes, ele pergunta primeiro e recusa imediatamente quando não há terminal para perguntar

✔ kept the repository

Two-way sync — example.com
…
state        synced

`zinnector check`

Compare este projeto com o slot no qual você está prestes a implantar.

zinnector check [options] [site]

argumento	obrigatório	o que é
`site`	não	um ID de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--probe`	inicializa o ambiente de execução local e MEDE seu php, em vez de confiar no zinnector.json
`--all`	mostra também as verificações bem-sucedidas
`--strict`	também falha quando algo não puder ser verificado
`--json`	saída legível por máquina

Exemplo

zinnector check

O que você vê — capturado de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único foram substituídos — a execução encontrou uma divergência real (PHP 8.3 no projeto contra 8.4 no slot), que é o objetivo principal do comando

→ reading the slot
  size excludes: .git

Pre-flight — example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────

  local  php 8.4  3 files, 0.0 MB
  slot   php 8.4  target fleet
  local php is the version DECLARED in zinnector.json — run with --probe to measure it

  ? unknown   local php extensions could not be enumerated
      try zinnector dev --once

  ? unknown   wordpress versions could not be compared
      No WordPress version found in the working copy.
      try zinnector status

  7 passed  ·  2 could not be checked

`zinnector push`

Verificação preliminar, envie seus commits e faça o deploy.

zinnector push [options] [site]

argumento	obrigatório	o que é
`site`	não	um id de site, domínio primário ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`-f, --force`	faça o deploy mesmo quando o pre-flight encontrar problemas
`--skip-checks`	não execute o pre-flight de forma alguma
`--probe`	meça o runtime local durante o pre-flight em vez de confiar no zinnector.json
`--no-wait`	acione o deploy e saia sem monitorá-lo
`--no-git`	não execute git push; faça o deploy de tudo o que a plataforma já tiver
`--dry-run`	faça tudo, exceto o deploy

Exemplo

zinnector push

O que você vê

Deploy to example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
───────────────────────────────────────────────────────────────

✔ pre-flight: 8 passed  ·  0 to look at  ·  2 could not be checked
→ pushing main (4f1c2a9b add the contact form)
✔ pushed
● deploy 7c0e… started — watching
✔ deployed 4f1c2a9b in 48s

  status    success
  commit    4f1c2a9b
  url       https://example.com

`zinnector deploy`

Implante novamente o que a plataforma já possui, sem fazer push.

zinnector deploy [options] [site]

argumento	obrigatório	o que é
`site`	não	um ID de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--no-wait`	disparar e sair

Exemplo

zinnector deploy example.com

O que você vê — capturado a partir de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único foram substituídos


Redeploy example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────
→ starting the deploy
✔ deploy started

`zinnector deploys`

Histórico de implantação de um site.

zinnector deploys [options] [site]

argument	required	what it is
`site`	não	um ID de site, domínio principal ou nome — assume como padrão o site vinculado em zinnector.json

option	what it does	default
`--json`	saída legível por máquina
`-n, --limit <n>`	quantos exibir	`"10"`

Exemplo

zinnector deploys example.com

O que você vê — capturado a partir de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único foram substituídos


Deploys — example.com  ·  2
───────────────────────────────────────────────────────────
status  commit  branch  trigger  started                      message
live    —       —       manual   2026-09-14T09:06:39.685554Z  —
live    —       —       manual   2026-09-14T01:29:20.196957Z  —

`zinnector php`

Exibir ou alternar a versão do PHP de um site.

zinnector php [options] [version]

argumento	obrigatório	o que é
`version`	não	a versão do PHP para a qual alternar o site, ex.: 8.4 — omita para exibir a atual

opção	o que faz	padrão
`-s, --site <site>`	id ou domínio do site
`--list`	lista as versões que a plataforma oferece
`--json`	saída legível por máquina

Exemplo

zinnector php 8.3 --site example.com

O que você vê — capturado de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único substituídos. sem uma versão, exibe a atual; --list mostra o que a plataforma oferece para a linha de produtos deste site


PHP — example.com
──────────────────────────────────────────────────────
version        8.4
can switch to  8.5, 8.4, 8.3, 8.2, 8.1, 8.0, 7.4

`zinnector quota`

Uso de disco, arquivos e banco de dados em relação ao que o plano concede.

zinnector quota [options] [site]

argumento	obrigatório	o que é
`site`	não	um id de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--json`	saída legível por máquina

Exemplo

zinnector quota example.com

O que você vê — capturado a partir de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único foram substituídos


Quota — example.com
────────────────────────────────────────────────────────
disk used      188 MB
disk limit     500.0 GB
disk granted   500 GB  (per_site)
files used     6,313
file limit     2,000,000
database       1 MB

  “limit” is what is enforced today; “granted” is what the plan says.

`zinnector db`

Tamanho do banco de dados e links de uso único para o phpMyAdmin e o gerenciador de arquivos.

zinnector db [options] [site]

argumento	obrigatório	o que é
`site`	não	um id de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--json`	saída legível por máquina

Exemplo

zinnector db example.com

O que você vê — capturado de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único foram substituídos. Os links do phpMyAdmin e do gerenciador de arquivos são de uso único e expiram; não os cole em lugar nenhum


Database — example.com
───────────────────────────────────────────────────────────
size    1 MB
tables  14

  single-use links, valid for one visit:
  phpMyAdmin    https://pma.example.com/signon.php?t=<single-use>
  file manager  https://files.example.com/signon.php?t=<single-use>

`zinnector logs`

Acompanhe em tempo real os logs de acesso e de erros de um site.

zinnector logs [options] [site]

argumento	obrigatório	o que é
`site`	não	um id de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--access`	apenas o log de acesso
`--error`	apenas o log de erros
`--build`	em vez disso, o log de compilação da implantação mais recente
`--json`	saída legível por máquina

Exemplo

zinnector logs example.com --error

O que você vê — capturado de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único foram substituídos. --access para o log de acesso, --build para o log de compilação da última implantação (um site não compilado por um provedor de compilação mostra as etapas da própria implantação); sem nenhuma flag, ambos os logs do site são exibidos, e um log que não pôde ser lido informa isso em vez de parecer vazio


Error log — example.com
────────────────────────────────────────────────────────────

2026-09-14 11:06:07.153643 [NOTICE] [1929978] [T0] [config:vhost:zcaffb6eec5abbdab03fb9b2d62a15:epsr:lsphp-zcaffb6eec5abbdab03fb9b2d62a15]'Process Limit' probably is too low, adjust the limit to: 640.
2026-09-14 11:06:37.873060 [INFO] [1929982] [T0] [lsphp-zcaffb6eec5abbdab03fb9b2d62a15] add child process pid: 1933036, procinfo: 0x5555561cfe30

`zinnector wp`

Execute um comando WP-CLI permitido em um site.

zinnector wp [options] [command...]

argumento	obrigatório	o que é
`command...`	não	o comando do WP-CLI e seus argumentos, ex.: plugin list — omita-o com --commands

opção	o que faz	padrão
`-s, --site <site>`	id do site ou domínio
`--commands`	lista o que a plataforma executará
`--json`	saída legível por máquina

Exemplo

zinnector wp plugin list --site example.com

O que você vê — capturado de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único substituídos. a lista de permissões é fornecida pela plataforma — o comando zinnector wp --commands a imprime

name	status	update	version	update_version	auto_update
akismet	inactive	none	5.7.2		off
hello	inactive	none	1.7.2		off
imunify-security	active	none	4.1.0		off
litespeed-cache	active	none	7.9.1		off
redis-cache	active	none	2.8.0		off
zinn-cache	active	none	1.2.2		off
object-cache.php	dropin				off

`zinnector backup`

Liste e crie backups do site.

zinnector backup [options] [command]

Exemplo

zinnector backup list example.com

O que você vê — capturado de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único foram substituídos. O comando backup sozinho imprime seus subcomandos; consulte backup list e backup now abaixo


Backups — example.com  ·  3
───────────────────────────────────────────────────────────
status  taken                        size    id
stored  2026-09-14T09:06:39.918280Z  4.7 MB  01a00000-0000-7000-8000-000000000000
stored  2026-09-14T01:29:20.403161Z  36 MB   01a00001-0000-7000-8000-000000000001
stored  2026-09-14T01:29:15.898099Z  36 MB   01a00002-0000-7000-8000-000000000002

daily backups   on
retention       30 days
off-site copy   yes
on-demand left  2 of 3

`zinnector backup list`

Liste os backups de um site e o que o plano dele concede.

zinnector backup list [options] [site]

argumento	obrigatório	o que é
`site`	não	um id de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

opção	o que faz	padrão
`--json`	saída legível por máquina

Exemplo

zinnector backup list example.com

O que você vê — capturado a partir de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único foram substituídos


Backups — example.com  ·  3
───────────────────────────────────────────────────────────
status  taken                        size    id
stored  2026-09-14T09:06:39.918280Z  4.7 MB  01a00000-0000-7000-8000-000000000000
stored  2026-09-14T01:29:20.403161Z  36 MB   01a00001-0000-7000-8000-000000000001
stored  2026-09-14T01:29:15.898099Z  36 MB   01a00002-0000-7000-8000-000000000002

daily backups   on
retention       30 days
off-site copy   yes
on-demand left  2 of 3

`zinnector backup now`

Crie um backup sob demanda.

zinnector backup now [options] [site]

argumento	obrigatório	o que é
`site`	não	um id de site, domínio principal ou nome — o padrão é o site vinculado em zinnector.json

Exemplo

zinnector backup now example.com

O que você vê

✔ backup started — zinnector backup list example.com shows it when it completes

`zinnector domains`

Liste os domínios que esta chave pode ver.

zinnector domains [options]

opção	o que faz	padrão
`--json`	saída legível por máquina

Exemplo

zinnector domains

O que você vê — capturado a partir de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único foram substituídos


Domains  ·  1
──────────────
domain       status     ownership  renewal        expires
example.com  connected  connected  no auto-renew  —

`zinnector dns`

Leia e altere registros DNS.

zinnector dns [options] [command]

Exemplo

zinnector dns list example.com

O que você vê — capturado de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único substituídos. O comando dns isolado exibe seus subcomandos; consulte dns list, dns add e dns rm abaixo


DNS — example.com  ·  1 records
────────────────────────────────────────
type  name          value               ttl
TXT   w4357-verify  zinn-w4357-updated  ttl 3600

`zinnector dns list`

Liste os registros DNS de um domínio.

zinnector dns list [options] <domain>

argumento	obrigatório	o que é
`domain`	sim	o domínio, por nome ou id

opção	o que faz	padrão
`--type <type>`	apenas registros deste tipo
`--json`	saída legível por máquina

Exemplo

zinnector dns list example.com

O que você vê — capturado a partir de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único foram substituídos


DNS — example.com  ·  1 records
────────────────────────────────────────
type  name          value               ttl
TXT   w4357-verify  zinn-w4357-updated  ttl 3600

`zinnector dns add`

Crie um registro DNS.

zinnector dns add [options] <domain> <type> <name> <value>

argumento	obrigatório	o que é
`domain`	sim	o domínio, por nome ou id
`type`	sim	tipo de registro: A, AAAA, CNAME, MX, TXT, SRV, …
`name`	sim	o nome do registro — @ para o próprio domínio ou um rótulo de subdomínio
`value`	sim	para onde o registro aponta — um endereço, um nome de host ou texto

opção	o que faz	padrão
`--ttl <seconds>`	tempo de vida (time to live)	`"3600"`
`--priority <n>`	prioridade, para MX e SRV
`--proxied`	rotear através da CDN
`-y, --yes`	não perguntar

Exemplo

zinnector dns add example.com TXT _acme "token" --ttl 300

O que você vê — o registro é exibido e confirmado antes de ser gravado; passe --yes para pular a pergunta

Add a DNS record to example.com
───────────────────────────────

  type   TXT
  name   _acme
  value  "token"
  ttl    300

  create it? [y/N] y
✔ created TXT _acme

`zinnector dns rm`

Exclua um registro DNS.

zinnector dns rm [options] <domain> <recordId>

argumento	obrigatório	o que é
`domain`	sim	o domínio, por nome ou id
`recordId`	sim	o id do registro, conforme exibido por zinnector dns list

opção	o que faz	padrão
`-y, --yes`	não perguntar

Exemplo

zinnector dns rm example.com rec_7f3a

O que você vê

⚠ deleting A @ 203.0.113.10 from example.com
  delete it? [y/N] y
✔ deleted

`zinnector mail`

Listar serviços de e-mail.

zinnector mail [options]

opção	o que faz	padrão
`--json`	saída legível por máquina

Exemplo

zinnector mail

O que você vê — capturado a partir de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único foram substituídos


Mail services  ·  0
────────────────────

● no mail services

`zinnector bulk`

Execute uma operação em vários sites (cache_purge, malware_scan, sitemap, block_ip).

zinnector bulk [options] <operation>

argumento	obrigatório	o que é
`operation`	sim	o que executar em cada site selecionado: cache_purge, malware_scan, sitemap ou block_ip

opção	o que faz	padrão
`--all`	todos os sites que esta chave pode ver
`--site <site...>`	sites específicos, por id ou domínio
`--status <status>`	todos os sites neste status
`-y, --yes`	não perguntar
`--json`	saída legível por máquina

Exemplo

zinnector bulk cache_purge --all

O que você vê — capturado de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único substituídos. uma chamada para a plataforma para toda a seleção, não uma por site; a seleção é exibida e confirmada primeiro


Bulk cache_purge  ·  1 sites
─────────────────────────────

·   example.com

→ running cache_purge
✔ cache_purge accepted for 1 sites

  The platform runs this asynchronously; results appear per site in the dashboard.

`zinnector ai`

Pergunte ao assistente da Zinn Digital®, com este projeto como contexto.

zinnector ai [options] <question...>

argumento	obrigatório	o que é
`question...`	sim	o que você deseja perguntar, em palavras simples — o uso de aspas é opcional

opção	o que faz	padrão
`-s, --site <site>`	perguntar sobre um site específico
`--org <id>`	a organização como a qual perguntar, quando sua conta pertencer a mais de uma
`--no-context`	não enviar nada sobre o projeto local
`--json`	saída legível por máquina

Exemplo

zinnector ai "why is my deploy failing?"

O que você vê — capturado de uma execução real da versão 0.1.5 em produção em 2026-09-14; domínios, IDs e links de uso único substituídos. O assistente responde no idioma da CONTA — a localidade desta conta é o árabe, portanto a resposta capturada está em árabe para uma pergunta em inglês

→ thinking

Zinn Digital® assistant
────────────────────────────

  هذا مشروع WordPress تم إنشاؤه بواسطة Zinnector® (مُهيّأ على PHP 8.4، أحدث
  إصدار WordPress، وبيئة تشغيل playground)؛ لتشغيله محلياً، انتقل إلى مجلده
  وشغّل الأمر: cd <اسم-المشروع> ثم zinnector dev، وسيقوم بتشغيل موقع WordPress
  حقيقي على جهازك دون الحاجة إلى Docker.

  sources:
    · https://zinndigital.com/kb/zinnector-getting-started
    · https://zinndigital.com/kb/zinnector-local-development

`zinnector mcp`

Execute uma ponte stdio para o servidor MCP hospedado — para Claude Desktop e outros clientes apenas locais.

zinnector mcp [options]

Exemplo

ZINN_MCP_TOKEN=zmcp_live_… zinnector mcp

O que você vê — iniciado POR um cliente de IA como Claude Desktop, nunca manualmente — comunica-se via MCP em stdin e stdout. Comprovado a partir de Claude Code 2.1.270 no servidor ativo em 2026-09-12

zinnector 0.1.4: MCP bridge to https://api.zinndigital.com/v1/mcp

Variáveis de ambiente

variável	efeito
`ZINNECTOR_TOKEN`	uma chave de API, usada em vez de um perfil armazenado — é assim que o CI se autentica
`ZINNECTOR_API`	URL base da API (padrão `https://api.zinndigital.com`)
`ZINNECTOR_DEBUG=1`	imprimir stack traces e a própria saída do instalador de runtime
`ZINNECTOR_CACHE_DIR`	onde o runtime do WordPress e qualquer Node gerenciado são mantidos (padrão `~/.cache/zinnector`)
`ZINNECTOR_CONFIG_DIR`	onde o arquivo de perfil da chave de API fica localizado (padrão `~/.config/zinnector`)
`NO_COLOR`	desativar cores

Códigos de saída

0 sucesso · 1 uma constatação ou uma recusa · 70 um erro interno · 77 autenticação ou permissão · 78 Node não compatível.

Toda a documentação para desenvolvedores →

Últimas do blog

O que temos escrito sobre hospedagem, SEO e gerenciamento de sites em grande escala.

SEO e construção de links a partir da camada de hospedagem: A visão de um operador para 2026

Como a hospedagem molda a indexação e o link equity em 2026: mantendo páginas indexadas, avaliando domínios antigos antes de utilizá-los, criando links sem deixar pegadas (footprint) e uma visão honesta sobre o que a infraestrutura pode e não pode fazer pelo SEO.

21 de julho de 2026

Ler o artigo →

Tornando o WordPress rápido e seguro: uma lista de verificação de desempenho e plugins

Um checklist prático para um WordPress rápido e seguro: cache no nível do servidor, cache de objetos por site, os poucos plugins que realmente valem a pena, manutenção do stack atualizado e as páginas do WooCommerce que você nunca deve armazenar em cache.

20 de julho de 2026

Ler o artigo →

Como escolher hospedagem web gerenciada em 2026: Um guia do comprador

O que realmente separa uma boa hospedagem gerenciada de uma máquina barata com painel de controle — migrações, backups, isolamento, cache real e escalabilidade honesta — e como avaliar isso antes de assumir um compromisso.

19 de julho de 2026

Ler o artigo →

Ler o blog →

Ainda precisa de ajuda?

O suporte está incluído em todos os planos, o atendimento funciona 24 horas por dia e você pode nos escrever em qualquer um dos nossos 58 idiomas — nós respondemos no seu.

Entrar em contato com o suporte → Todos os artigos →