novo zinnector
Crie a estrutura de um site, plugin ou tema de blocos que inicializa imediatamente. Sem arquivos temporários, sem TODOs — o plugin é ativado e o tema pode ser selecionado assim que é criado.
Zinnector®
A CLI para desenvolvedores para hospedagem WordPress
O Zinnector® compila o WordPress localmente sem nada instalado além do Node — sem Docker, sem MAMP — e então compara o que você construiu com o slot de hospedagem no qual você está prestes a fazer o deploy e informa o que não será compatível, antes de você fazer o push. Instale-o com npm install -g zinnector. Ele é gratuito, sob licença MIT e construído sobre a mesma API pública de tudo o mais aqui.
Cinco comandos, e o do meio é o ponto principal
A maioria das CLIs de hospedagem começa no deploy. O Zinnector® começa antes disso — ele constrói o site com você e, em seguida, verifica seu trabalho em relação à máquina para a qual você está prestes a enviá-lo. A lacuna entre "funcionou no meu laptop" e "funciona no servidor" é onde as tardes são perdidas, e essa lacuna é mensurável.
zinnector dev
Um WordPress real na sua máquina em segundos, executando seus próprios plugins e temas, sem Docker e sem PHP no seu PATH. Escolha qualquer PHP de 5.2 a 8.5 para programar.
verificação zinnector
A verificação prévia. Compara o que você compilou com o slot em que está prestes a fazer a implantação e identifica cada incompatibilidade — e cada verificação que não pôde realizar — antes de enviar.
zinnector push
Faça a verificação prévia, envie seus commits, acione a implantação e acompanhe até a conclusão. Se falhar, o registro de compilação estará a apenas um comando de distância.
zinnector ai
Consulte o assistente a partir do terminal, com seu projeto e seu site como contexto. Ele é executado na plataforma em sua própria conta, de modo que nenhuma chave de modelo é armazenada em sua máquina.
Teste o funcionamento em dois minutos, sem necessidade de conta
Seis comandos, em ordem, e como é o resultado correto em cada um. Tudo aqui é executado em sua própria máquina; uma chave de API só é necessária quando você atingir um slot de hospedagem.
Instalar
Execute npm install -g zinnector no Node 24 ou mais recente. Se o npm exibir EBADENGINE, seu Node é anterior ao 24 — instale a versão LTS atual a partir de nodejs.org e execute a instalação novamente.
Verificar a versão
zinnector --version exibe um número de versão como 0.1.2. Em um Node anterior ao 24, exibe uma mensagem informando que o Node 24 ou mais recente é necessário e é encerrado.
Leia a ajuda
O comando zinnector --help lista cada comando abaixo com uma breve descrição de uma linha. Cada comando também aceita sua própria opção --help.
Criar estrutura inicial de um site
zinnector new my-site cria um projeto que inicializa imediatamente — um zinnector.json, uma árvore wp-content e um README — e exibe os próximos comandos a serem executados.
Executar
cd my-site, depois zinnector dev. A primeira execução solicita uma vez o download do ambiente de execução do WordPress (cerca de 570 MB, mantido no cache próprio da CLI, nunca em seu projeto). O sucesso é exibido como “running at http://127.0.0.1:9400”.
Abra em um navegador
http://127.0.0.1:9400 é um novo site WordPress; /wp-admin abre o painel já conectado. Coloque um plugin em wp-content/plugins e ele estará disponível no próximo recarregamento.
Em seguida, com um slot de hospedagem
zinnector login, zinnector link, zinnector check, zinnector push — faça a verificação prévia do que você construiu em relação ao slot, depois faça o deploy e acompanhe a conclusão.
A verificação prévia, em detalhes
Você desenvolveu no PHP 8.3. O slot executa o 8.1. Nada avisa até que o site fique com a tela em branco. Esse é o problema para o qual este comando existe, e foi exatamente o que o proprietário desta plataforma pediu nominalmente. O Zinnector® lê ambos os ambientes e os coloca lado a lado — e permite a implantação mesmo assim, caso você tenha um motivo para isso.
PHP, avaliado honestamente
Uma discrepância de versão principal é sinalizada como alta porque invariavelmente quebra um site; uma discrepância menor é sinalizada como mais baixa. Classificar tudo como crítico apenas ensina as pessoas a ignorarem o aviso.
Contagem de disco e arquivos, separadamente
Uma árvore do WordPress é composta por dezenas de milhares de arquivos pequenos, e um site pode esgotar seu limite de inodes mesmo estando bem abaixo do limite de disco. Ambos são verificados em relação ao que realmente resta no slot, e não em relação ao plano.
"Não foi possível verificar" é uma resposta por si só
Uma verificação que não consegue ver seu objeto relata como não verificada, nunca como aprovada. Uma execução limpa indica quantos itens não foi possível verificar, pois ninguém olha duas vezes para uma falsa liberação.
Avisa, nunca bloqueia
Cada constatação pode ser substituída com --force, e o resumo informa isso. No CI, o código de saída atua como barreira, para que um pipeline possa ser rigoroso enquanto uma pessoa mantém o controle.
Dois ambientes de execução locais, ambos reais
O WordPress Playground é o padrão: PHP compilado para WebAssembly, executado dentro do Node, para que um notebook apenas com o Node instalado passe do zero a um WordPress em execução no tempo aproximado de ler esta frase.
Quando você precisar de um PHP nativo — uma extensão como imagick, um MySQL real — passe --runtime docker e obtenha contêineres php-fpm e MariaDB. Ambos servem os mesmos arquivos do mesmo projeto, portanto, alternar entre eles altera o mecanismo e nada mais.
Tudo o mais que você já faz no painel
O Zinnector® foi desenvolvido com base na mesma API pública do painel, portanto, tudo o que o painel pode fazer, ele também pode — e cada comando é uma operação documentada na especificação da OpenAPI, em vez de um endpoint privado.
Sites e implantações
Liste sites, leia tudo o que a plataforma sabe sobre um site, faça uma nova implantação e leia o histórico de implantação e os registros de compilação.
Domínios, DNS e e-mail
Liste domínios, leia e altere registros DNS com o registro exibido antes de ser gravado, e leia seus serviços de e-mail.
PHP, cota, banco de dados e logs
Alterne versões do PHP, consulte o uso de disco e de inodes em relação ao que seu plano concede, obtenha links de uso único para o phpMyAdmin e acompanhe os logs de acesso e erros em tempo real.
WP-CLI e operações em massa
Execute comandos WP-CLI da lista de permissões em um site e limpe caches ou inicie verificações de malware em toda uma seleção em uma única chamada, em vez de uma por site.
Cada comando, exatamente como o --help lista
A lista completa, uma linha para cada. A referência completa — cada flag, um exemplo executável e o que cada comando exibe — é gerada a partir da própria CLI e reside na documentação do desenvolvedor e na base de conhecimento, de modo que não pode divergir da ferramenta que você instalou.
novo zinnector
Crie o esqueleto de um projeto WordPress que você possa executar imediatamente.
zinnector dev
Execute este projeto localmente — nenhum Docker é necessário.
início de sessão do zinnector
Faça login com uma chave de API da Zinn Digital®.
Sair do zinnector
Esquecer uma chave de API armazenada.
zinnector whoami
Mostrar como quem esta CLI está autenticada.
sites zinnector
Liste os sites que esta chave pode ver.
status do zinnector
Tudo o que a plataforma sabe sobre um site.
compartilhamento do zinnector
Dê acesso a uma pessoa a um único site — um desenvolvedor, um designer, um cliente — com uma função e um motivo.
colaboradores do zinnector
Veja quem recebeu acesso a um site, sua função e se essa pessoa já aceitou.
remover compartilhamento do zinnector
Revogue o acesso de uma pessoa, por e-mail ou ID de concessão.
convites do zinnector
Os convites que estão esperando por você, e aceite um.
vínculo zinnector
Aponte este projeto para um slot de hospedagem (e conecte seu repositório).
zinnector pull
Puxe os arquivos de um site hospedado para este projeto para desenvolvimento local e execute novamente para sincronizar novamente. Utiliza o caminho rápido quando o site sincroniza com seu próprio repositório; caso contrário, trabalha a partir do backup mais recente.
Sincronização do zinnector
Sincronização bidirecional entre os arquivos ativos de um site hospedado e seu repositório: veja o status atual, ative-a, confirme (commit) as alterações do site ou escolha qual lado prevalece.
zinnector mcp
Uma ponte para o servidor MCP da Zinn Digital® para o Claude Desktop e outros clientes de AI que iniciam apenas servidores locais.
clonar zinnector
Crie um projeto local a partir de um site hospedado em uma única etapa: clone seu repositório ou baixe seus arquivos, grave o arquivo do projeto e fique pronto para executar zinnector dev.
verificação do zinnector
Compare este projeto com o slot no qual você está prestes a implantar.
zinnector push
Faça a verificação prévia, envie seus commits e faça a implantação.
zinnector deploy
Reimplante o que a plataforma já possui, sem fazer push.
zinnector implanta
Histórico de implantação de um site.
zinnector php
Mostre ou altere a versão do PHP de um site.
cota do zinnector
Uso de disco, arquivos e banco de dados em relação ao limite do plano.
zinnector db
Tamanho do banco de dados e links de uso único para o phpMyAdmin e o gerenciador de arquivos.
logs do zinnector
Acompanhe em tempo real os logs de acesso e de erros de um site.
zinnector wp
Execute um comando WP-CLI permitido em um site.
backup do zinnector
Listar e criar backups do site. Subcomandos: list, now.
domínios zinnector
Liste os domínios que esta chave pode ver.
zinnector dns
Leia e altere registros DNS. Subcomandos: list, add, rm.
zinnector mail
Listar serviços de e-mail.
zinnector em lote
Execute uma operação em vários sites (cache_purge, malware_scan, sitemap, block_ip).
zinnector ai
Pergunte ao assistente do Zinn Digital®, com este projeto como contexto.
Perguntas
Preciso ser um cliente da Zinn Digital® para usá-lo?
Não. `zinnector new` e `zinnector dev` não precisam de nenhuma conta — crie a estrutura básica de um plugin, tema ou site inteiro e execute-o localmente, gratuitamente, para sempre. Uma chave de API só é necessária para os comandos que se comunicam com a sua hospedagem.
Requer Docker?
Não para o runtime padrão. O WordPress Playground compila o PHP para WebAssembly e roda dentro do Node, portanto, o `zinnector dev` inicializa um WordPress real em segundos, sem a necessidade de instalar mais nada. Se você precisar de um PHP nativo — para testar uma extensão como imagick ou ionCube —, o `--runtime docker` fornece contêineres php-fpm e MariaDB. Ambos são suportados; nenhum deles é uma alternativa secundária.
O que a verificação prévia realmente compara?
A sua versão local do PHP em comparação com a do slot, se o slot pode sequer mudar para a versão na qual você desenvolveu, se o PHP do slot ultrapassou o fim da vida útil e se a máquina realmente o aplicou, o tamanho e a contagem de arquivos do seu projeto em relação ao espaço livre restante de disco e de inodes, as versões do WordPress em cada lado, se o slot concluiu o provisionamento e se há um repositório git conectado para a implantação. Tudo o que não puder ser verificado é reportado como não verificado, em vez de ser contabilizado como aprovado.
Isso pode me impedir de fazer a implantação?
Não, e isso é deliberado. O pre-flight avisa e permite que você continue — o `--force` faz o deploy ignorando qualquer ocorrência. Você sabe coisas sobre o seu próprio site que um verificador não sabe, e uma ferramenta que se recusa a fazer deploy é uma ferramenta que as pessoas desinstalam.
Minha chave de API está segura?
A chave nunca é lida a partir da linha de comando — apenas de um prompt ou stdin redirecionado — portanto, não pode parar no seu histórico do shell ou em uma listagem de processos. Ela é armazenada em seu próprio diretório de configuração com permissões de arquivo 600, e o Zinnector® reafirma essas permissões sempre que grava.
Posso usá-lo no CI?
Sim. Defina `ZINNECTOR_TOKEN`, e cada comando aceitará `--json`. A saída legível para humanos vai para stderr e os dados para stdout, mantendo os pipes limpos. O comando `zinnector check` é encerrado com código diferente de zero quando encontra algo, funcionando como um pipeline gate, e o `--strict` também falha quando não for possível fazer uma comparação.
Relacionado
Instale-o e coloque um site em funcionamento no próximo minuto
Execute npm install -g zinnector ou experimente uma vez com npx zinnector new my-site. Gratuito, sob licença MIT e construído com base na API pública. Crie a estrutura de um projeto, execute-o localmente sem Docker e faça a validação prévia antes de implantar.
Leia a documentação