---
title: CLI
description: >-
  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.
sidebar:
  label: CLI
  order: 3
---
```bash
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](/ro/api). MCP: [MCP](/ro/mcp). Skill pentru agenți: [Skill pentru agenți](/ro/skill). Prețuri: [Prețuri](/ro/pricing). Markdown simplu: [cli.md](https://linkdash.dev/cli.md).

Nu există flag-ul `--json`. Codul de ieșire este 1 la erori.

## Autentificare

```bash
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](https://linkdash.dev/dashboard/billing). Chei API (HTTP și MCP): [Chei API](https://linkdash.dev/dashboard/keys).

## 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](/ro/folders) |
| `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ă](/ro/sharing) 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](#access-and-sharing)). Create acceptă **exact una** dintre variantele: `--url`, `--file` sau `--text` (aceasta devine varianta `main`), blocuri `--variant` (vezi [Variante](#variants)) sau `--folder <name>` (vezi [Foldere](#folders)).

| 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](#access-and-sharing) |
| `--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](#forward-query-parameters) |
| `--variant <name>` | Începe un bloc de variantă (doar la create). Vezi [Variante](#variants) |
| `--weight <n>` `--when <key=v1,v2>` | Per variantă. Vezi [Variante](#variants) și [Reguli pentru parametrii de query](#query-parameter-rules) |
| `--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](/ro/domains) ș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

```bash
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

```bash
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 |

```bash
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](/ro/folders) ca să afli cum funcționează pagina publică și accesul.

```bash
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](/ro/sharing) pentru modelul complet.

```bash
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

```bash
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.

```bash
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

```bash
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](/ro/folders), [partajare și acces](/ro/sharing), [webhookuri](/ro/webhooks) și [domenii personalizate](/ro/domains).
