CLI
Instalează linkdash-cli din npm, apoi rulează comanda `linkdash`. Comenzile reușite afișează JSON pe stdout. Ajutorul și erorile sunt text simplu pe stderr.
npm i -g linkdash-cli
# or: pnpm add -g linkdash-cli / bun add -g linkdash-cli / npx linkdash-cli@latest
Pachetul npm este linkdash-cli. Comanda este linkdash.
Echivalentul HTTP: API HTTP. MCP: MCP. Skill pentru agenți: Skill pentru agenți. Prețuri: Prețuri. Markdown simplu: cli.md.
Nu există flag-ul --json. Codul de ieșire este 1 la erori.
Autentificare
linkdash auth create
linkdash auth login
linkdash auth whoami
linkdash auth logout
Nu ai încă un cont? auth create deschide https://linkdash.dev/sign-up, apoi revine la https://linkdash.dev/device cu codul CLI, ca să poți aproba. Ai deja un cont? auth login deschide /device. Headless: setează LINKDASH_TOKEN la un token de sesiune obținut din auth create sau auth login. Nu inventa tokenuri.
Fișierul de sesiune: ~/.config/linkdash/config.json (mod 0600).
CLI-ul nu poate schimba emailul, parola sau facturarea. Trimite utilizatorul la dashboard. Chei API (HTTP și MCP): Chei API.
Comenzi
linkdash <command> [options]
| Comandă | Ce face |
|---|---|
auth create |
Înregistrare în browser, apoi aprobarea dispozitivului |
auth login |
Autentificare în browser prin dispozitiv |
auth logout |
Uită sesiunea salvată |
auth whoami |
JSON-ul contului autentificat |
links list |
Listează linkurile și folderele, câte o pagină odată (--limit, --cursor) |
links get <id> |
Un singur link |
links create --url <url> |
Link scurt dintr-un URL |
links create --file <path> |
Încarcă un fișier și primești un link |
links create --text <text> |
Salvează un snippet |
links create --folder <name> |
Creează un folder |
links create --variant <name> … |
Link cu mai multe variante (split / targetare) |
links update <id> |
Schimbă destinația, fișierul, parola, expirarea, domeniul, statusul, sticky sau parametrii transmiși mai departe |
links move <id> --in <folder-id> |
Pune un link sau un folder într-un folder (--root pentru nivelul de sus) |
links copy <id> |
Creează o copie cu un slug nou, în același folder |
links delete <id> |
Șterge un link (elementele unui folder urcă un nivel; --with-contents le șterge) |
links share <id> --email <email> |
Partajează cu persoane prin email (repetă --email; --role editor le permite să-l modifice; fiecare persoană nouă primește un email de invitație) |
links unshare <id> --email <email> |
Elimină accesul cuiva |
links shares [id] |
Cine îl poate deschide în afară de tine, inclusiv printr-un folder de deasupra. Fără id: tot ce ai partajat prin invitații, câte o pagină odată (--limit, --cursor) |
links shared |
Ce au partajat alții cu tine, câte o pagină odată (--limit, --cursor) |
links leave <_id | share URL> |
Renunță la ceva partajat cu tine |
links role <id> --email <e> --role viewer|editor |
Fă pe cineva pe care l-ai invitat viewer sau editor |
links unlock <_id | share URL> |
Introdu parola unui element partajat ca să-i vezi și să-i editezi ținta timp de 30 de minute |
links activity <id> |
Cine a modificat un element și cum |
links reset-link <id> |
URL de partajare nou; vechiul URL linkdash.dev/s/ nu mai funcționează |
links stats <id> |
Totalurile de vizite, descărcări și redări, inclusiv pe variante, plus crawlerele |
links export |
Afișează toate linkurile ca CSV (un rând per variantă) |
links import <file> |
Importă rânduri cu URL-uri și text din CSV |
links variants list <id> |
Variantele unui link |
links variants add <id> --name <n> |
Adaugă o variantă |
links variants update <id> <name> |
Modifică o variantă |
links variants remove <id> <name> |
Elimină o variantă |
webhooks list |
Listează endpointurile webhook (cu secretul mascat) |
webhooks get <id> |
Afișează URL-ul unui webhook (cu secretul mascat) |
webhooks create --url <https> |
Adaugă un endpoint HTTPS (secretul e afișat o singură dată) |
webhooks rotate <id> |
Emite un nou secret de semnare |
webhooks delete <id> |
Elimină un webhook |
domains list |
Listează hostname-urile personalizate |
domains add <host> |
Adaugă un hostname (1 pe Free) |
domains connect <host> |
URL-ul de aplicare Domain Connect, sau null |
domains verify <host> |
Verifică DNS-ul cu Unkey |
domains remove <host> |
Elimină un hostname |
-h, --help |
Ajutor (text simplu) |
-v, --version |
Versiune |
Dacă același slug există pe două domenii ale proprietarului, transmite --domain.
Flaguri pentru create și update
Slug-ul este id-ul linkului și calea lui publică atunci când linkul e public. Numele e vizibil doar pentru tine. Linkurile noi sunt restricționate (vezi Acces și partajare). Create acceptă exact una dintre variantele: --url, --file sau --text (aceasta devine varianta main), blocuri --variant (vezi Variante) sau --folder <name> (vezi Foldere).
| Flag | Note |
|---|---|
--url <url> |
URL-ul destinație |
--file <path> |
Fișierul de încărcat (la create, sau înlocuiește conținutul la update) |
--text <text> |
Snippet |
--access <restricted|link|public> |
Cine îl poate deschide. Implicit restricted. Vezi Acces și partajare |
--reset-share-link |
Emite un nou URL de partajare (doar la update) |
--slug <id> |
Calea publică: a-z0-9 și cratime interne, 1–64 |
--name <label> |
Etichetă privată |
--tag <tag> |
Repetabil. Litere mici, fără virgule. Maximum 20 |
--starts <when> |
Devine activ după 7d, 24h, 30m sau la o dată ISO |
--password <secret> |
Cere această parolă la deschidere |
--expires <when> |
Nu mai e servit după 7d, 24h, 30m sau după o dată ISO |
--max-openings <n> |
Se pune pe pauză după atâtea deschideri. Omite-l pentru nelimitat |
--domain <host> |
Servește pe acest host în loc de lida.sh |
--in <folder-id> |
Creează în acest folder (doar la create; --in-domain <host> dacă slug-ul folderului se repetă) |
--status <active|paused> |
Pune pe pauză sau reia (doar la update) |
--sticky / --no-sticky |
Vizitatorul care revine păstrează aceeași variantă (implicit sticky) |
--restart-split |
Reamestecă atribuirile sticky (doar la update) |
--forward-params / --no-forward-params |
Adaugă query string-ul vizitatorului la variantele URL (implicit dezactivat). Vezi Transmiterea parametrilor de query |
--variant <name> |
Începe un bloc de variantă (doar la create). Vezi Variante |
--weight <n> --when <key=v1,v2> |
Per variantă. Vezi Variante și Reguli pentru parametrii de query |
--preview-name <text> |
Numele public din unfurl |
--preview-description <text> |
Descrierea publică din unfurl |
--preview-image <path> |
Imaginea publică din unfurl |
--utm-source --utm-medium --utm-campaign --utm-term --utm-content |
Doar pentru linkuri URL |
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings |
Doar la update |
--status acceptă doar active sau paused. Statusul expirat vine din --expires. Statusul programat vine din --starts. Rezolvarea publică întoarce not-found până la start. După ce se atinge --max-openings, linkul se pune pe pauză; mărește numărul sau folosește --clear-max-openings ca să fie servit din nou. Deschiderile deja folosite rămân numărate până când schimbi sau elimini limita.
Slug-urile lida.sh sunt comune pentru toți utilizatorii. Dacă un cuvânt e deja luat, adaugă un domeniu personalizat și încearcă din nou cu --domain. Un link pe un domeniu de brand nu se publică și pe lida.sh.
Flaguri pentru list
Afișează o pagină, {items, cursor}: --limit este 1-100 (implicit 50); transmite --cursor cu valoarea cursor din pagina anterioară până când aceasta devine null. O pagină poate conține mai puține elemente decât --limit când un filtru exclude unele. --q caută cuvinte întregi, ultimul fiind tratat ca prefix (laun găsește example.com/launch), cu rezultatele ordonate după relevanță; --in listează un singur folder, cu folderele primele; altfel, cele mai noi apar primele.
| Flag | Note |
|---|---|
--limit <n> |
Elemente per pagină, 1-100 (implicit 50) |
--cursor <c> |
cursor-ul din pagina anterioară |
--q <text> |
Caută cuvinte în nume, slug, numele și țintele variantelor, numele fișierelor, textul snippeturilor și taguri |
--tag <tag> |
Filtrează după tag |
--kind <url|file|text|folder|group> |
Filtrează după tip (group = mai multe variante) |
--status <status> |
active, paused, expired, scheduled sau mixed |
--in <folder-id|root> |
Doar ce se află direct în acest folder sau la nivelul de sus. Fără el, se listează tot |
Variante
Fiecare link este un container cu una sau mai multe variante. O variantă înseamnă conținutul (URL, fișier sau text) plus propriile restricții de acces (--password, --starts, --expires, --max-openings), un --weight și condiții opționale pentru vizitatori (--when). Fără --variant, un link are o singură variantă numită main, iar fiecare comandă de mai sus e o prescurtare pentru ea. Un vizitator primește o singură variantă: variantele al căror --when se potrivește formează pool-ul (dacă niciuna nu se potrivește, îl formează variantele fără condiții), apoi urmează o alegere ponderată. Cu atribuirea sticky (implicită), un vizitator care revine păstrează aceeași variantă. Restricțiile linkului au prioritate față de cele ale variantelor. Numele variantelor: litere mici, cifre, cratime interne, 1–40 de caractere, unice per link. Maximum 20 de variante.
kind-ul linkului este tipul variantei când există o singură variantă și group când sunt mai multe. status-ul linkului este cel dat de restricția linkului când aceasta e setată (paused, scheduled, expired), altfel statusul comun al variantelor, altfel mixed. variantStatuses numără {active, paused, expired, scheduled}.
Creare cu blocuri de variante
linkdash links create --slug promo --variant a --url https://example.com/a --variant b --url https://example.com/b --weight 3
linkdash links create --slug hi --variant de --url https://example.de --when country=DE,AT --variant rest --url https://example.com
--variant <name> începe un bloc de variantă. Flagurile de după el aparțin acelei variante până la următorul --variant: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (repetabil), --utm-*. Flagurile linkului (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) se pun înainte de primul --variant.
Subcomenzi pentru variante
linkdash links variants list promo
linkdash links variants add promo --name mobile --url https://m.example.com --when device=mobile
linkdash links variants update promo mobile --when country=DE,AT --when device=mobile --weight 2
linkdash links variants update promo b --status paused
linkdash links variants remove promo b
variants add <id> --name <n> acceptă una dintre opțiunile --url, --file, --text, plus flagurile de restricție, --weight, --when, --utm-*. variants update <id> <name> acceptă --name <new>, conținut, flagurile de restricție, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires, --clear-max-openings. Un link păstrează cel puțin o variantă.
Cheile --when
| Cheie | Câmp JSON | Valori |
|---|---|---|
country |
countries |
Coduri ISO-2 (DE, AT) |
device |
devices |
mobile tablet desktop |
os |
os |
windows macos android ios linux other |
browser |
browsers |
edge chrome firefox safari other |
language |
languages |
potrivire după prefix (de, en-us) |
referrer |
referrerHosts |
sufix de host (twitter.com) |
Fiecare cheie setată trebuie să se potrivească. --when country=DE,AT --when device=mobile înseamnă { "countries": ["DE","AT"], "devices": ["mobile"] }.
Reguli pentru parametrii de query
--when acceptă și reguli param: aplicate pe query string-ul vizitatorului (lida.sh/promo?src=newsletter). Cheile sunt case-sensitive, valorile se compară exact, maximum 10 reguli per variantă. Virgulele separă valorile din --when, așa că valoarea unui parametru nu poate conține virgulă; folosește | pentru liste.
| Sintaxă | op JSON |
Se potrivește când |
|---|---|---|
param:KEY=VALUE |
equals |
valoarea este exact VALUE |
param:KEY!=VALUE |
notEquals |
valoarea diferă sau cheia lipsește |
param:KEY~=VALUE |
includes |
valoarea conține VALUE |
param:KEY^=VALUE |
startsWith |
valoarea începe cu VALUE |
param:KEY$=VALUE |
endsWith |
valoarea se termină cu VALUE |
param:KEY=v1|v2 |
in |
valoarea este una din listă |
param:KEY? or param:KEY |
exists |
cheia este prezentă |
param:!KEY |
missing |
cheia lipsește |
linkdash links variants add promo --name news --url https://example.com/news --when param:src=newsletter
linkdash links variants add promo --name pro --url https://example.com/pro --when "param:plan~=pro"
linkdash links variants add promo --name ref --url https://example.com/ref --when "param:ref?"
Forma JSON: "when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] } (value lipsește pentru exists / missing). Valorile parametrilor sunt verificate în momentul deschiderii și nu sunt stocate niciodată în analytics.
Transmiterea parametrilor de query
--forward-params / --no-forward-params la links create și links update (la nivel de link, dezactivat implicit) adaugă întregul query string al vizitatorului la variantele URL: lida.sh/promo?src=nl deschide https://example.com/?src=nl. Valorile vizitatorului le suprascriu pe cele salvate, inclusiv --utm-*. Variantele de tip fișier și text îl ignoră. Asta e rutare, nu control al accesului: oricine poate adăuga parametri. Valorile parametrilor nu sunt stocate în analytics. links get îl afișează ca forwardParams.
Sticky și restart split
links update <id> --sticky / --no-sticky stabilește dacă un vizitator care revine păstrează aceeași variantă. links update <id> --restart-split reamestecă atribuirile sticky. Flagurile de conținut din links update funcționează doar pentru linkurile cu o singură variantă; altfel folosește links variants update <id> <name>.
Foldere
Un folder este un link care listează elementele pe care le pui în el. Vezi Foldere ca să afli cum funcționează pagina publică și accesul.
linkdash links create --folder "Q4 launch" --slug q4
linkdash links create --file ./deck.pdf --in q4
linkdash links move k3m9xq --in q4
linkdash links move k3m9xq --root
linkdash links list --in q4
linkdash links copy k3m9xq
linkdash links delete q4 --with-contents
--folder <name> setează numele folderului (nu --name) și acceptă --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* și --in. Nu poate fi combinat cu --url, --file, --text sau --variant. links move afișează {id, folder}. links copy păstrează nivelul de acces, dar primește un URL de partajare nou; persoanele nu sunt copiate. links delete pe un folder mută elementele lui cu un nivel mai sus; --with-contents le șterge și pe ele. Rândurile din list, get și create includ folder (slug-ul folderului care îl conține, sau null); rândurile de folder includ și items.
Acces și partajare
Linkurile și folderele noi sunt restricted: url-ul lor este https://linkdash.dev/s/<token>, pe care îl pot deschide doar tu și persoanele cu care îl partajezi, după autentificare. --access link face acel URL accesibil oricui îl are. --access public servește linkul la URL-ul scurt (lida.sh/<slug> sau domeniul tău personalizat). Folosește --access public pentru linkurile pe care le publici. Slug-ul rămâne id-ul folosit în fiecare comandă, iar URL-ul lui scurt rămâne rezervat cât timp linkul nu e public. Vezi Partajare și acces pentru modelul complet.
linkdash links create --url https://example.com/launch --access public
linkdash links share q4 --email anna@example.com --email ben@example.com
linkdash links shares q4
linkdash links unshare q4 --email ben@example.com
linkdash links shared
linkdash links leave https://linkdash.dev/s/<token>
linkdash links share q4 --email cara@example.com --role editor
linkdash links role q4 --email cara@example.com --role viewer
linkdash links unlock https://linkdash.dev/s/<token>
linkdash links activity q4
linkdash links shares
linkdash links update q4 --access link
linkdash links reset-link q4
| Comandă | Afișează |
|---|---|
links share <id> --email <e> [--email <e> …] |
{id, url, access, invited, alreadyShared} |
links unshare <id> --email <e> |
{id, email, removed: true} |
links shares <id> |
{id, access, url, people: [{email, role: "viewer", accepted, invitedAt, viaFolder?}]} |
links shares (fără id) |
{items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}, cele partajate cel mai recent primele |
links shared |
{items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, cele mai noi primele |
links leave <_id | share URL> |
{_id, left: true} |
links role <id> --email <e> --role <r> |
{id, email, role} |
links unlock <_id | share URL> |
{_id, variant, unlocked: true, minutes: 30, kind, destinationUrl? | textContent? | fileName?} |
links activity <id> |
{items: [{_id, _creationTime, action, detail?, actor}], cursor} |
links reset-link <id> (sau links update <id> --reset-share-link) |
{id, access, url} |
--role editor face pe cineva editor: poate modifica elementul și îi poate vedea statisticile, dar nu poate schimba parolele, slug-ul, domeniul, accesul sau partajarea și nu poate șterge, muta sau copia elementul, iar pentru o țintă protejată cu parolă are nevoie mai întâi de links unlock (30 de minute). Editorii folosesc _id-ul sau URL-ul de partajare din links shared. Toate comenzile acceptă --domain <host> când slug-ul se repetă. url din outputul comenzilor create, get, list, update, copy și share este URL-ul de partajare, iar dacă linkul e public, URL-ul scurt; rândurile includ access. Până la 200 de persoane per element, 50 de emailuri per apel, 100 de emailuri de invitație per cont pe zi. Cele două liste afișează câte o pagină: --limit este 1-100 (implicit 50); transmite --cursor din pagina anterioară până când cursor devine null. links leave acceptă _id-ul sau url-ul din links shared; accesul obținut printr-un folder partajat de deasupra rămâne. Partajarea, anularea partajării, o schimbare de acces și o resetare contează fiecare ca un eveniment; părăsirea nu.
Statistici
linkdash links stats <id> --last 24h
--last este o durată (24h, 7d). Implicit 24h. JSON-ul include visits, downloads, plays, visitsInLast, countries, referrers, variants (totaluri per variantă), visitors (fiecare cu variant) și crawlers ([{crawler, company, category, hits, lastSeen}]: boți și preview-uri de linkuri care au accesat linkul, niciodată numărați ca vizite).
CSV
Coloane: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Un rând per variantă. kind, status, url, text, fileName, weight și when (string JSON) sunt per variantă; restul sunt per link și se repetă. folder este slug-ul folderului în care se află linkul. access este restricted, link sau public. Nu se exportă parole, tokenuri de partajare sau persoane.
linkdash links export > links.csv
linkdash links import links.csv
Importul grupează rândurile după slug + domeniu. Primul rând creează linkul cu varianta lui; rândurile următoare adaugă variante. Pentru un link existent, primul rând actualizează câmpurile linkului, apoi fiecare rând actualizează varianta cu numele respectiv dacă există, altfel o adaugă. Rândurile de fișier fără conținut sunt sărite, cu o eroare per rând. Rândurile cu kind = folder (cu un name) creează foldere; coloana folder plasează fiecare link în folderul lui după ce toate rândurile au fost create. Un access gol face linkurile noi restricționate și le lasă neschimbate pe cele existente.
Exemple
linkdash links create --url https://example.com/q4/deck.pdf --slug deck --name "Q4 deck"
linkdash links create --file ./deck.pdf --expires 7d --starts 1d
linkdash links create --url https://example.com --max-openings 1
linkdash links update k3m9xq --max-openings 5
linkdash links update k3m9xq --clear-max-openings
linkdash links create --text "release checklist" --tag launch --tag q4
linkdash links list --q deck --tag launch --kind file --status paused
linkdash links get welcome --domain go.example.com
linkdash links update deck --file ./new.pdf
linkdash links update k3m9xq --status paused
linkdash links create --slug promo --variant a --url https://example.com/a --variant b --url https://example.com/b --weight 3
linkdash links variants add promo --name mobile --url https://m.example.com --when device=mobile
linkdash links update promo --no-sticky --restart-split
linkdash links create --folder "Q4 launch" --slug q4
linkdash links move k3m9xq --in q4
linkdash links create --url https://example.com/launch --access public
linkdash links share q4 --email anna@example.com
Vezi și foldere, partajare și acces, webhookuri și domenii personalizate.

