<!-- generated by cli/scripts/command-reference.mjs from the CLI's own command definitions — do not edit by hand -->
Fiecare comandă pe care Zinnector® 0.1.6 o recunoaște — 43 în total, exact așa cum le afișează zinnector --help — împreună cu opțiunile sale, un exemplu executabil și ceea ce ar trebui să vedeți. Această pagină este generată direct din CLI, așadar nu poate fi în contradicție cu instrumentul pe care îl aveți instalat; dacă o comandă de aici lipsește de pe computerul dumneavoastră, rulați npm install -g zinnector@latest.
Înainte de a începe
Instalați-l cu npm install -g zinnector pe Node 24 sau mai recent, apoi verificați instalarea cu zinnector --version și zinnector --help. Ghidul introductiv prezintă primii pași parcurși în cinci minute; această pagină este documentul de referință la care reveniți.
Fiecare comandă acceptă -h, --help. Aceste opțiuni globale se plasează înaintea numelui comenzii:
| option | what it does |
|---|
-V, --version | afișează versiunea |
--profile <name> | utilizează un profil de autentificare denumit |
Comenzile
zinnector new
Generați structura unui proiect WordPress pe care îl puteți rula imediat.
zinnector new [options] [name]
| argument | obligatoriu | ce este |
|---|
name | nu | directorul în care se va crea proiectul și numele proiectului — obligatoriu, cu excepția cazului în care se folosește --here |
| opțiune | ce face | prestabilit |
|---|
-t, --template <kind> | una dintre: site, plugin, theme | "site" |
--php <version> | versiunea PHP utilizată pentru dezvoltare | "8.3" |
--wp <version> | versiunea WordPress pentru mediul de execuție local | "latest" |
--runtime <name> | playground sau docker | "playground" |
--here | generează structura în directorul curent în loc de unul nou | |
Exemplu
zinnector new my-site
Ceea ce vedeți — capturat — 0.1.2 pe 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
Rulați acest proiect local — nu este necesar Docker.
zinnector dev [options]
| opțiune | ce face | prestabilit |
|---|
--php <version> | versiunea PHP de rulat (5.2–8.5 pe playground, 7.4–8.5 pe docker) | |
--wp <version> | versiunea WordPress | |
-p, --port <port> | portul pe care se servește | |
--runtime <name> | playground (prestabilit) sau docker | |
--login | autentificare automată ca administrator | true |
--no-login | nu vă autentificați automat | |
--once | inițializați, raportați ce rulează, apoi opriți | |
--yes | instalați mediul runtime local fără confirmare | |
--reset-runtime | ștergeți mediul runtime instalat și instalați-l din nou | |
-v, --verbose | afișați ieșirea proprie a mediului runtime | |
Exemplu
cd my-site
zinnector dev
Ceea ce vedeți — capturat — 0.1.2. La prima rulare se solicită o dată descărcarea mediului de execuție WordPress (~570 MB); transmiteți --yes pentru a omite întrebarea
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
Autentificați-vă — cu propriul cont în browser sau cu o cheie API.
zinnector login [options]
| opțiune | ce face | implicit |
|---|
--profile <name> | stochează sub un profil denumit (implicit: default) | |
--api <url> | adresa URL de bază a API-ului | "https://api.zinndigital.com" |
--api-key | lipiți o cheie API per organizație în loc să vă conectați ca dumneavoastră | |
--issuer <url> | serviciul de conectare | "https://auth.zinndigital.com/realms/zinn" |
--no-browser | afișează linkul de conectare fără a încerca să deschidă un browser | |
Exemplu
zinnector login
Ce vedeți — cheia se introduce la solicitare, niciodată pe linia de comandă. În CI, transmiteți-o prin conductă: 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
Uitați o conectare salvată.
zinnector logout [options]
| opțiune | ce face | prestabilit |
|---|
--profile <name> | ce profil să se uite (prestabilit: default) | |
Exemplu
zinnector logout
Ceea ce vedeți
✔ signed out of profile “default”
zinnector whoami
Afișează cu ce cont este conectată această interfață CLI și ce poate accesa.
zinnector whoami [options]
| opțiune | ce face | implicit |
|---|
--profile <name> | utilizați un profil denumit | |
--scopes | afișați permisiunile asociate unei chei API | |
--json | ieșire care poate fi citită automat | |
Exemplu
zinnector whoami --scopes
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție la 2026-09-14; domeniile, ID-urile și linkurile de unică folosință au fost înlocuite
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
Listează site-urile pe care această cheie le poate vedea.
zinnector sites [options]
| opțiune | ce face | implicit |
|---|
--json | ieșire lizibilă automat | |
--status <status> | numai site-urile cu această stare | |
Exemplu
zinnector sites
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție la 2026-09-14; domeniile, ID-urile și linkurile de unică folosință au fost înlocuite
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
Tot ce știe platforma despre un site.
zinnector status [options] [site]
| argument | obligatoriu | ce este |
|---|
site | nu | un id de site, domeniu principal sau nume — implicit este site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--json | ieșire care poate fi citită automat de mașină | |
Exemplu
zinnector status example.com
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție la 2026-09-14; domeniile, ID-urile și linkurile de unică folosință au fost înlocuite
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
Oferiți unei persoane acces la UN SINGUR site — un dezvoltator, un designer, un client.
zinnector share [options] <site> <email>
| argument | obligatoriu | ce este |
|---|
site | da | site-ul de partajat — un id, domeniu principal sau nume |
email | da | cui i se acordă acces — i se trimite o invitație prin e-mail dacă nu are încă un cont |
| opțiune | ce face | implicit |
|---|
--role <role> | ce poate face: viewer, editor, manager | |
--reason <text> | de ce are nevoie de acesta — păstrat împreună cu permisiunea pentru pista de audit |
--until <date> | când accesul se încheie de la sine (AAAA-LL-ZZ); omiteți pentru valabilitate până la revocare |
--json | ieșire care poate fi citită de mașină |
Exemplu
zinnector share example.com dev@agency.test --role editor --reason "rebuild the checkout"
Ceea ce vedeți — forma exactă afișată de comandă, din sursă (W40-DEVTOOL le-a adăugat după ce acest fișier a fost capturat ultima dată); domeniile, ID-urile și datele dumneavoastră vor fi diferite
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
Cine a primit acces la un site și dacă a acceptat.
zinnector collaborators [options] [site]
| argument | obligatoriu | ce este |
|---|
site | nu | un id de site, domeniu principal sau nume — implicit este site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--json | ieșire care poate fi citită automat de mașină | |
Exemplu
zinnector collaborators example.com
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție pe 2026-09-14; domenii, id-uri și linkuri de unică folosință au fost înlocuite. forma exactă pe care o afișează comanda, din sursă (W40-DEVTOOL le-a adăugat după ce acest fișier a fost capturat ultima dată); domeniile, id-urile și datele dumneavoastră vor diferi
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
Revocați accesul unei persoane la un site — prin e-mail sau ID de acordare (grant id).
zinnector unshare [options] <site> <who>
| argument | obligatoriu | ce reprezintă |
|---|
site | da | site-ul pentru care se revocă accesul — un id, domeniu principal sau nume |
who | da | persoana de eliminat — adresa sa de e-mail sau id-ul de acordare din zinnector collaborators |
| opțiune | ce face | implicit |
|---|
--yes | nu întreba | |
Exemplu
zinnector unshare example.com dev@agency.test --yes
Ceea ce vedeți — forma exactă afișată de comandă, din sursă (W40-DEVTOOL le-a adăugat după ce acest fișier a fost capturat ultima dată); domeniile, ID-urile și datele dumneavoastră vor fi diferite
✔ withdrew the invitation to dev@agency.test
zinnector invitations
Invitațiile care vă așteaptă și acceptarea uneia dintre ele.
zinnector invitations [options] [command]
Exemplu
zinnector invitations
Ce vedeți — capturat dintr-o rulare reală a 0.1.5 pe producție la 2026-09-14; domenii, id-uri și linkuri de unică folosință au fost înlocuite. forma exactă afișată de comandă, din sursă (W40-DEVTOOL le-a adăugat după ce acest fișier a fost capturat ultima dată); domeniile, id-urile și datele dumneavoastră vor fi diferite; fără o subcomandă, rulează list
Invitations · 0
──────────────────
● nothing waiting for you
zinnector invitations list
Invitații adresate contului cu care sunteți conectat.
zinnector invitations list [options]
| opțiune | ce face | implicit |
|---|
--json | ieșire care poate fi citită automat | |
Exemplu
zinnector invitations list
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție pe 2026-09-14; domenii, id-uri și linkuri de unică folosință au fost înlocuite. forma exactă pe care o afișează comanda, din sursă (W40-DEVTOOL le-a adăugat după ce acest fișier a fost capturat ultima dată); domeniile, id-urile și datele dumneavoastră vor diferi
Invitations · 0
──────────────────
● nothing waiting for you
zinnector invitations accept
Acceptați o invitație — site-ul vă aparține din momentul în care această comandă se finalizează.
zinnector invitations accept [options] <id>
| argument | obligatoriu | ce este |
|---|
id | da | id-ul invitației din zinnector invitations — un prefix unic al acestuia este suficient |
Exemplu
zinnector invitations accept 01a03f39-9c11-7b02-a7e0-2e4d0c5f1b77
Ceea ce vedeți — forma exactă afișată de comandă, din sursă (W40-DEVTOOL le-a adăugat după ce acest fișier a fost capturat ultima dată); domeniile, ID-urile și datele dumneavoastră vor fi diferite
✔ you now have access to example.com
zinnector link
Indicați acest proiect către un slot de găzduire (și conectați depozitul acestuia).
zinnector link [options] [site]
| argument | obligatoriu | ce este |
|---|
site | nu | un id de site, domeniu principal sau nume — implicit site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--repo <owner/name> | conectează acest depozit la site-ul de pe platformă | |
--provider <name> | contul conectat prin care se face implementarea: github_app, github sau gitlab (implicit: cel conectat de organizația dumneavoastră) | |
--branch <name> | ramura din care se implementează un push | |
--no-repo | scrie doar zinnector.json; nu atinge platforma | |
Exemplu
zinnector link example.com --repo acme/example-site --branch main
Ceea ce vedeți
✔ 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
Preluati fișierele unui site găzduit în acest proiect pentru dezvoltare locală — și rulați din nou pentru a resincroniza.
zinnector pull [options] [site]
| argument | obligatoriu | ce este |
|---|
site | nu | un id de site, domeniu principal sau nume — implicit este site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--via <seam> | auto (implicit), git sau backup | "auto" |
--fresh | efectuează o copie de rezervă nouă în loc să o utilizeze pe cea mai recentă (consumă un slot la cerere) | |
--max-age <hours> | acceptă cea mai recentă copie de rezervă dacă este mai nouă de atât | "24" |
--full | întreaga rădăcină a documentului, inclusiv nucleul WordPress (implicit: doar wp-content) | |
--no-uploads | exclude wp-content/uploads (media) | |
--no-database | exclude baza de date a site-ului — preia doar fișierele | |
--live-config | scrie de asemenea wp-config.php — conține datele de autentificare pentru baza de date LIVE | |
--clean | golește wp-content înainte de extragere, astfel încât ștergerile de pe site să fie reflectate | |
--dry-run | afișează ce s-ar întâmpla și se oprește | |
--yes | nu solicita confirmare | |
Exemplu
zinnector pull
Ceea ce vedeți
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
Creați un proiect local dintr-un site găzduit: clonați depozitul acestuia sau preluați fișierele acestuia.
zinnector clone [options] <site> [dir]
| argument | obligatoriu | ce reprezintă |
|---|
site | da | site-ul găzduit care urmează să fie copiat — un id, domeniu principal sau nume |
dir | nu | director de creat — implicit este domeniul principal al site-ului |
| opțiune | ce face | implicit |
|---|
--via <seam> | auto (implicit), git sau backup | "auto" |
--fresh | realizează o copie de rezervă nouă în loc să o utilizeze pe cea mai recentă | |
--full | întregul director rădăcină al documentelor, inclusiv nucleul WordPress | |
--no-uploads | omite wp-content/uploads (media) | |
--no-database | omite baza de date a site-ului — preia doar fișierele | |
--live-config | scrie de asemenea wp-config.php — acesta conține datele de autentificare pentru baza de date LIVE | |
--yes | nu întreba | |
Exemplu
zinnector clone client.example.com
Ceea ce vedeți
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
Sincronizare bidirecțională între fișierele active ale unui site și depozitul acestuia.
zinnector sync [options] [command]
Exemplu
zinnector sync --help
Ce vedeți — fără nicio subcomandă, zinnector sync <site> este 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
Starea sincronizării bidirecționale și ultimele sale rulări.
zinnector sync status [options] [site]
| argument | obligatoriu | ce este |
|---|
site | nu | un id de site, domeniu principal sau nume — implicit este site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--json | ieșire care poate fi citită automat de mașină | |
Exemplu
zinnector sync status example.com
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.4 pe un site de testare pe 2026-09-12; domeniul și identificatorii sunt înlocuiți cu valori demonstrative
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
Activați sincronizarea bidirecțională (nu trimite nimic de la sine).
zinnector sync on [options] [site]
| argument | obligatoriu | ce este |
|---|
site | nu | un id de site, domeniu principal sau nume — valoarea implicită este site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--subdir <path> | sincronizează doar acest subdirector al site-ului | |
--json | ieșire care poate fi citită de computer | |
Exemplu
zinnector sync on example.com
Ceea ce vedeți — necesită un depozit conectat pe propriul cont GitHub; nu transmite nimic de la sine
✔ two-way sync is on
Two-way sync — example.com
…
→ next: zinnector sync run
zinnector sync off
Dezactivați sincronizarea bidirecțională.
zinnector sync off [options] [site]
| argument | obligatoriu | ce este |
|---|
site | nu | un id de site, domeniu principal sau nume — valoarea implicită este site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--subdir <path> | sincronizează doar acest subdirector al site-ului | |
--json | ieșire care poate fi citită de computer | |
Exemplu
zinnector sync off example.com
Ceea ce vedeți
✔ two-way sync is off
zinnector sync run
Comiteți acum fișierele live ale site-ului în depozitul său.
zinnector sync run [options] [site]
| argument | obligatoriu | ce este |
|---|
site | nu | un id de site, domeniu principal sau nume — implicit este site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--json | ieșire care poate fi citită automat de mașină | |
Exemplu
zinnector sync run example.com
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.4 pe un site de testare la data de 2026-09-12; domeniul și id-urile sunt înlocuite cu valori demonstrative. O rulare peste care depozitul a trecut deja este în schimb HELD: nimic nu este transmis sau suprascris, comanda se încheie cu codul 1 și indică următorul pas
✔ committed 2 changed files da85d73cef5f
Two-way sync — example.com
…
→ next: git pull in your clone
zinnector sync resolve
Ștergeți o sincronizare reținută alegând care parte câștigă.
zinnector sync resolve [options] [site]
| argument | obligatoriu | ce este |
|---|
site | nu | un id de site, domeniu principal sau nume — implicit este site-ul conectat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--keep <side> | site (comiteți site-ul deasupra) sau repository (abandonați modificările nesincronizate ale site-ului) | |
--yes | nu întrebați | |
--json | ieșire care poate fi citită de computer | |
Exemplu
zinnector sync resolve example.com --keep repository --yes
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.4 pe un site de testare la 2026-09-12; domeniul și id-urile sunt înlocuite cu valori demonstrative. Fără --yes, se solicită confirmarea în prealabil și refuză direct atunci când nu există un terminal în care să se solicite confirmarea
✔ kept the repository
Two-way sync — example.com
…
state synced
zinnector check
Comparați acest proiect cu slotul în care urmează să efectuați implementarea.
zinnector check [options] [site]
| argument | obligatoriu | ce este |
|---|
site | nu | un ID de site, domeniu principal sau nume — valoarea implicită este site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--probe | inițializează mediul de execuție local și îi MĂSOARĂ php-ul, în loc să aibă încredere în zinnector.json | |
--all | afișează și verificările trecute cu succes | |
--strict | eșuează și atunci când ceva nu a putut fi verificat | |
--json | ieșire care poate fi citită automat de mașină | |
Exemplu
zinnector check
Ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în mediul de producție la data de 2026-09-14; domeniile, ID-urile și linkurile de unică folosință au fost înlocuite — rularea a detectat o neconcordanță reală (PHP 8.3 în proiect față de 8.4 pe slot), acesta fiind întregul scop al comenzii
→ 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
Efectuați verificarea preliminară, trimiteți comiterele și implementați.
zinnector push [options] [site]
| argument | obligatoriu | ce reprezintă |
|---|
site | nu | un id de site, domeniu principal sau nume — implicit este site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
-f, --force | implementați chiar dacă pre-flight are constatări | |
--skip-checks | nu rulați deloc pre-flight | |
--probe | măsurați mediul de rulare local în timpul pre-flight în loc să vă bazați pe zinnector.json | |
--no-wait | declanșați implementarea și ieșiți fără a o urmări | |
--no-git | nu rulați git push; implementați ceea ce platforma deține deja | |
--dry-run | efectuați totul, cu excepția implementării propriu-zise | |
Exemplu
zinnector push
Ceea ce vedeți
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
Redesfășurați ceea ce platforma are deja, fără a trimite.
zinnector deploy [options] [site]
| argument | obligatoriu | ce reprezintă |
|---|
site | nu | un ID de site, domeniu principal sau nume — valoarea implicită este site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--no-wait | declanșează și iese | |
Exemplu
zinnector deploy example.com
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție la 2026-09-14; domeniile, ID-urile și linkurile de unică folosință au fost înlocuite
Redeploy example.com · 01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────
→ starting the deploy
✔ deploy started
zinnector deploys
Istoricul implementărilor unui site.
zinnector deploys [options] [site]
| argument | required | what it is |
|---|
site | nu | un ID de site, domeniu principal sau nume — valoarea implicită este site-ul asociat în zinnector.json |
| option | what it does | default |
|---|
--json | ieșire care poate fi citită automat | |
-n, --limit <n> | câte să fie afișate | "10" |
Exemplu
zinnector deploys example.com
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție la 2026-09-14; domeniile, ID-urile și linkurile de unică folosință au fost înlocuite
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
Afișați sau schimbați versiunea PHP a unui site.
zinnector php [options] [version]
| argument | obligatoriu | descriere |
|---|
version | nu | versiunea PHP la care să fie comutat site-ul, de ex. 8.4 — omiteți pentru a o afișa pe cea curentă |
| opțiune | ce face | implicit |
|---|
-s, --site <site> | id site sau domeniu | |
--list | listează versiunile pe care le oferă platforma | |
--json | ieșire care poate fi citită automat |
Exemplu
zinnector php 8.3 --site example.com
Ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în mediul de producție la 2026-09-14; domenii, ID-uri și linkuri de unică folosință au fost înlocuite. fără o versiune, o afișează pe cea curentă; --list arată ceea ce oferă platforma pentru linia de produse a acestui 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
Utilizarea spațiului pe disc, a fișierelor și a bazei de date în raport cu resursele alocate prin plan.
zinnector quota [options] [site]
| argument | obligatoriu | ce este |
|---|
site | nu | un id de site, domeniu principal sau nume — implicit este site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--json | ieșire care poate fi citită automat de mașină | |
Exemplu
zinnector quota example.com
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție la 2026-09-14; domeniile, ID-urile și linkurile de unică folosință au fost înlocuite
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
Dimensiunea bazei de date și linkuri de unică folosință către phpMyAdmin și managerul de fișiere.
zinnector db [options] [site]
| argument | obligatoriu | ce este |
|---|
site | nu | un id de site, domeniu principal sau nume — implicit este site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--json | ieșire care poate fi citită automat de mașină | |
Exemplu
zinnector db example.com
Ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în mediul de producție la 2026-09-14; domenii, id-uri și linkuri de unică folosință au fost înlocuite. linkurile phpMyAdmin și de gestionare a fișierelor sunt de unică folosință și expiră; nu le inserați nicăieri
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
Urmăriți în timp real jurnalele de acces și de erori ale unui site.
zinnector logs [options] [site]
| argument | obligatoriu | ce reprezintă |
|---|
site | nu | un id de site, domeniu principal sau nume — valoarea implicită este site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--access | doar jurnalul de acces | |
--error | doar jurnalul de erori | |
--build | în schimb, jurnalul de compilare al celei mai recente implementări | |
--json | ieșire care poate fi citită automat | |
Exemplu
zinnector logs example.com --error
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție pe 2026-09-14; domeniile, id-urile și linkurile de unică folosință au fost înlocuite. --access pentru jurnalul de acces, --build pentru jurnalul de compilare al ultimei implementări (un site necompilat de un furnizor de compilare afișează pașii proprii ai implementării); fără niciun parametru sunt afișate ambele jurnale ale site-ului, iar un jurnal care nu a putut fi citit indică acest lucru în loc să pară gol
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
Rulați o comandă WP-CLI permisă pe un site.
zinnector wp [options] [command...]
| argument | obligatoriu | ce este |
|---|
command... | nu | comanda WP-CLI și argumentele sale, de exemplu plugin list — omiteți-o cu --commands |
| opțiune | ce face | implicit |
|---|
-s, --site <site> | id site sau domeniu |
--commands | listează ceea ce va rula platforma |
--json | ieșire care poate fi citită de computer |
Exemplu
zinnector wp plugin list --site example.com
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție la 2026-09-14; domenii, ID-uri și linkuri de unică folosință au fost înlocuite. lista de permisiuni este furnizată de platformă — comanda zinnector wp --commands o afișează
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
Listați și creați copii de rezervă ale site-ului.
zinnector backup [options] [command]
Exemplu
zinnector backup list example.com
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție la 2026-09-14; domeniile, id-urile și linkurile de unică folosință au fost înlocuite. Comanda backup de sine stătătoare afișează subcomenzile sale; consultați backup list și backup now mai jos
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
Afișați copiile de rezervă ale unui site și ceea ce oferă planul acestuia.
zinnector backup list [options] [site]
| argument | obligatoriu | ce este |
|---|
site | nu | un id de site, domeniu principal sau nume — implicit este site-ul asociat în zinnector.json |
| opțiune | ce face | implicit |
|---|
--json | ieșire care poate fi citită automat de mașină | |
Exemplu
zinnector backup list example.com
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție la 2026-09-14; domeniile, ID-urile și linkurile de unică folosință au fost înlocuite
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
Creați o copie de rezervă la cerere.
zinnector backup now [options] [site]
| argument | obligatoriu | ce reprezintă |
|---|
site | nu | un id de site, domeniu principal sau nume — valoarea implicită este site-ul asociat în zinnector.json |
Exemplu
zinnector backup now example.com
Ceea ce vedeți
✔ backup started — zinnector backup list example.com shows it when it completes
zinnector domains
Listați domeniile pe care această cheie le poate vedea.
zinnector domains [options]
| opțiune | ce face | implicit |
|---|
--json | ieșire care poate fi citită automat | |
Exemplu
zinnector domains
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție la 2026-09-14; domeniile, ID-urile și linkurile de unică folosință au fost înlocuite
Domains · 1
──────────────
domain status ownership renewal expires
example.com connected connected no auto-renew —
zinnector dns
Citiți și modificați înregistrările DNS.
zinnector dns [options] [command]
Exemplu
zinnector dns list example.com
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție la 2026-09-14; domenii, id-uri și linkuri de unică folosință au fost înlocuite. Comanda dns de sine stătătoare afișează subcomenzile sale; consultați dns list, dns add și dns rm mai jos
DNS — example.com · 1 records
────────────────────────────────────────
type name value ttl
TXT w4357-verify zinn-w4357-updated ttl 3600
zinnector dns list
Listează înregistrările DNS ale unui domeniu.
zinnector dns list [options] <domain>
| argument | obligatoriu | ce reprezintă |
|---|
domain | da | domeniul, după nume sau id |
| opțiune | ce face | implicit |
|---|
--type <type> | doar înregistrările de acest tip | |
--json | ieșire care poate fi citită de mașină | |
Exemplu
zinnector dns list example.com
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție la 2026-09-14; domeniile, ID-urile și linkurile de unică folosință au fost înlocuite
DNS — example.com · 1 records
────────────────────────────────────────
type name value ttl
TXT w4357-verify zinn-w4357-updated ttl 3600
zinnector dns add
Creați o înregistrare DNS.
zinnector dns add [options] <domain> <type> <name> <value>
| argument | obligatoriu | ce este |
|---|
domain | da | domeniul, după nume sau id |
type | da | tipul de înregistrare: A, AAAA, CNAME, MX, TXT, SRV,… |
name | da | numele înregistrării — @ pentru domeniul propriu-zis, sau o etichetă de subdomeniu |
value | da | spre ce indică înregistrarea — o adresă, un nume de gazdă sau text |
| opțiune | ce face | implicit |
|---|
--ttl <seconds> | timp de viață (time to live) | "3600" |
--priority <n> | prioritate, pentru MX și SRV | |
--proxied | direcționează prin CDN | |
-y, --yes | nu întreba | |
Exemplu
zinnector dns add example.com TXT _acme "token" --ttl 300
Ceea ce vedeți — înregistrarea este afișată și confirmată înainte de a fi scrisă; transmiteți --yes pentru a sări peste întrebare
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
Ștergeți o înregistrare DNS.
zinnector dns rm [options] <domain> <recordId>
| argument | obligatoriu | ce este |
|---|
domain | da | domeniul, după nume sau id |
recordId | da | id-ul înregistrării, așa cum îl afișează zinnector dns list |
| opțiune | ce face | prestabilit |
|---|
-y, --yes | nu întreba | |
Exemplu
zinnector dns rm example.com rec_7f3a
Ceea ce vedeți
⚠ deleting A @ 203.0.113.10 from example.com
delete it? [y/N] y
✔ deleted
zinnector mail
Listează serviciile de e-mail.
zinnector mail [options]
| opțiune | ce face | implicit |
|---|
--json | ieșire care poate fi citită automat | |
Exemplu
zinnector mail
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție la 2026-09-14; domeniile, ID-urile și linkurile de unică folosință au fost înlocuite
Mail services · 0
────────────────────
● no mail services
zinnector bulk
Executați o operațiune pe mai multe site-uri (cache_purge, malware_scan, sitemap, block_ip).
zinnector bulk [options] <operation>
| argument | obligatoriu | ce este |
|---|
operation | da | ce se execută pe fiecare site selectat: cache_purge, malware_scan, sitemap sau block_ip |
| opțiune | ce face | prestabilit |
|---|
--all | fiecare site pe care această cheie îl poate vedea | |
--site <site...> | site-uri specifice, după id sau domeniu | |
--status <status> | fiecare site aflat în această stare | |
-y, --yes | nu întrebați | |
--json | rezultat care poate fi citit de mașină | |
Exemplu
zinnector bulk cache_purge --all
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 în producție pe 2026-09-14; domenii, ID-uri și linkuri de unică folosință înlocuite. un singur apel către platformă pentru întreaga selecție, nu câte unul per site; selecția este afișată și confirmată mai întâi
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
Întrebați asistentul Zinn Digital®, având acest proiect drept context.
zinnector ai [options] <question...>
| argument | obligatoriu | ce reprezintă |
|---|
question... | da | ceea ce doriți să întrebați, în cuvinte simple — punerea între ghilimele este opțională |
| opțiune | ce face | prestabilit |
|---|
-s, --site <site> | întrebați despre un anumit site | |
--org <id> | organizația în numele căreia întrebați, când contul dumneavoastră aparține mai multora | |
--no-context | nu trimiteți nimic despre proiectul local | |
--json | ieșire care poate fi citită de mașină | |
Exemplu
zinnector ai "why is my deploy failing?"
Ceea ce vedeți — capturat dintr-o rulare reală a versiunii 0.1.5 pe producție la 2026-09-14; domenii, ID-uri și linkuri de unică folosință au fost înlocuite. Asistentul răspunde în limba CONTULUI — configurarea regională a acestui cont este araba, astfel încât răspunsul capturat este în arabă la o întrebare în engleză
→ 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
Rulați o punte stdio către serverul MCP găzduit — pentru Claude Desktop și alți clienți exclusiv locali.
zinnector mcp [options]
Exemplu
ZINN_MCP_TOKEN=zmcp_live_… zinnector mcp
Ceea ce vedeți — pornit DE un client AI precum Claude Desktop, niciodată manual — comunică prin MCP pe stdin și stdout. Dovedit din Claude Code 2.1.270 pe serverul activ la 2026-09-12
zinnector 0.1.4: MCP bridge to https://api.zinndigital.com/v1/mcp
Variabile de mediu
| variabilă | efect |
|---|
ZINNECTOR_TOKEN | o cheie API, utilizată în locul unui profil stocat — așa se autentifică CI |
ZINNECTOR_API | URL-ul de bază al API-ului (implicit https://api.zinndigital.com) |
ZINNECTOR_DEBUG=1 | afișează urmele stivei (stack traces) și ieșirea proprie a instalatorului runtime-ului |
ZINNECTOR_CACHE_DIR | unde sunt păstrate runtime-ul WordPress și orice Node gestionat (implicit ~/.cache/zinnector) |
ZINNECTOR_CONFIG_DIR | unde se află fișierul de profil al cheii API (implicit ~/.config/zinnector) |
NO_COLOR | dezactivează culorile |
Coduri de ieșire
0 succes · 1 o constatare sau un refuz · 70 o eroare internă · 77 autentificare sau permisiune · 78 Node neacceptat.