---
title: CLI
description: >-
  Namestite linkdash-cli iz npm, nato zaženite ukaz `linkdash`. Uspešni ukazi
  izpišejo JSON na stdout. Pomoč in napake so navadno besedilo na 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
```

Paket npm je `linkdash-cli`. Ukaz je `linkdash`.

Enakovreden HTTP: [HTTP API](/sl/api). MCP: [MCP](/sl/mcp). Veščina za agente: [Veščina za agente](/sl/skill). Cene: [Cene](/sl/pricing). Navaden markdown: [cli.md](https://linkdash.dev/cli.md).

Zastavice `--json` ni. Ob napakah je izhodna koda 1.

## Preverjanje pristnosti

```bash
linkdash auth create
linkdash auth login
linkdash auth whoami
linkdash auth logout
```

Še nimate računa? `auth create` odpre https://linkdash.dev/sign-up, nato pa vas vrne na https://linkdash.dev/device s kodo CLI, da lahko odobrite dostop. Račun že imate? `auth login` odpre `/device`. Brez brskalnika: v `LINKDASH_TOKEN` nastavite sejni žeton iz `auth create` ali `auth login`. Žetonov si ne izmišljujte.

Datoteka seje: `~/.config/linkdash/config.json` (način 0600).

CLI ne more spremeniti e-poštnega naslova, gesla ali obračunavanja. Uporabnika napotite na [nadzorno ploščo](https://linkdash.dev/dashboard/billing). Ključi API (HTTP in MCP): [Ključi API](https://linkdash.dev/dashboard/keys).

## Ukazi

```
linkdash <command> [options]
```

| Ukaz | Kaj naredi |
| --- | --- |
| `auth create` | Registracija v brskalniku, nato odobritev naprave |
| `auth login` | Prijava naprave v brskalniku |
| `auth logout` | Pozabi shranjeno sejo |
| `auth whoami` | JSON prijavljenega računa |
| `links list` | Izpiše povezave in mape, po eno stran naenkrat (`--limit`, `--cursor`) |
| `links get <id>` | Ena povezava |
| `links create --url <url>` | Kratka povezava iz URL-ja |
| `links create --file <path>` | Naloži datoteko in vrne povezavo |
| `links create --text <text>` | Shrani izsek |
| `links create --folder <name>` | Ustvari [mapo](/sl/folders) |
| `links create --variant <name> …` | Povezava z več različicami (razdelitev / ciljanje) |
| `links update <id>` | Spremeni cilj, datoteko, geslo, potek, domeno, stanje, lepljivost ali posredovane parametre |
| `links move <id> --in <folder-id>` | Premakne povezavo ali mapo v mapo (`--root` za najvišjo raven) |
| `links copy <id>` | Naredi kopijo z novim slugom v isti mapi |
| `links delete <id>` | Izbriše povezavo (elementi mape se premaknejo raven višje; `--with-contents` jih izbriše) |
| `links share <id> --email <email>` | [Deli](/sl/sharing) z osebami prek e-pošte (ponovite `--email`; `--role editor` jim omogoči spreminjanje; vsaka nova oseba prejme e-poštno povabilo) |
| `links unshare <id> --email <email>` | Odstrani dostop osebe |
| `links shares [id]` | Kdo jo lahko odpre poleg vas, tudi prek nadrejene mape. Brez id: vse, kamor ste povabili osebe, po eno stran naenkrat (`--limit`, `--cursor`) |
| `links shared` | Kar so drugi delili z vami, po eno stran naenkrat (`--limit`, `--cursor`) |
| `links leave <_id \| share URL>` | Odpove se nečemu, kar je bilo deljeno z vami |
| `links role <id> --email <e> --role viewer\|editor` | Osebo, ki ste jo povabili, nastavi kot gledalca ali urednika |
| `links unlock <_id \| share URL>` | Vnese geslo deljenega elementa, da lahko 30 minut vidite in urejate njegov cilj |
| `links activity <id>` | Kdo je spremenil element in kako |
| `links reset-link <id>` | Nov URL za deljenje; stari URL `linkdash.dev/s/` preneha delovati |
| `links stats <id>` | Skupno število obiskov, prenosov in predvajanj, tudi po različicah, ter pajki |
| `links export` | Izpiše vse povezave kot CSV (ena vrstica na različico) |
| `links import <file>` | Uvozi vrstice z URL-ji in besedilom iz CSV |
| `links variants list <id>` | Različice povezave |
| `links variants add <id> --name <n>` | Doda različico |
| `links variants update <id> <name>` | Spremeni različico |
| `links variants remove <id> <name>` | Odstrani različico |
| `webhooks list` | Izpiše končne točke webhookov (skrivnost je zakrita) |
| `webhooks get <id>` | Prikaže URL enega webhooka (skrivnost je zakrita) |
| `webhooks create --url <https>` | Doda končno točko HTTPS (skrivnost je prikazana samo enkrat) |
| `webhooks rotate <id>` | Izda novo podpisno skrivnost |
| `webhooks delete <id>` | Odstrani webhook |
| `domains list` | Izpiše gostiteljska imena po meri |
| `domains add <host>` | Doda gostiteljsko ime (1 v paketu Free) |
| `domains connect <host>` | URL za uveljavitev Domain Connect ali null |
| `domains verify <host>` | Preveri DNS z Unkey |
| `domains remove <host>` | Odstrani gostiteljsko ime |
| `-h, --help` | Pomoč (navadno besedilo) |
| `-v, --version` | Različica |

Če isti slug obstaja na dveh domenah lastnika, podajte `--domain`.

## Zastavice za ustvarjanje in posodabljanje

Slug je id povezave, ko je povezava javna, pa tudi njena javna pot. Ime je vidno samo vam. Nove povezave so omejene (glejte [Dostop in deljenje](#access-and-sharing)). Ukaz create sprejme **natanko eno** od naslednjega: `--url`, `--file` ali `--text` (to postane različica `main`), bloke `--variant` (glejte [Različice](#variants)) ali `--folder <name>` (glejte [Mape](#folders)).

| Zastavica | Opombe |
| --- | --- |
| `--url <url>` | Ciljni URL |
| `--file <path>` | Datoteka za nalaganje (pri ustvarjanju ali za zamenjavo vsebine pri posodabljanju) |
| `--text <text>` | Izsek |
| `--access <restricted\|link\|public>` | Kdo jo lahko odpre. Privzeto `restricted`. Glejte [Dostop in deljenje](#access-and-sharing) |
| `--reset-share-link` | Izda nov URL za deljenje (samo pri posodabljanju) |
| `--slug <id>` | Javna pot: `a-z0-9` in notranji vezaji, 1–64 znakov |
| `--name <label>` | Zasebna oznaka |
| `--tag <tag>` | Ponovljivo. Male črke, brez vejic. Največ 20 |
| `--starts <when>` | Aktivira se po `7d`, `24h`, `30m` ali na datum ISO |
| `--password <secret>` | Za odpiranje zahteva to geslo |
| `--expires <when>` | Preneha s strežbo po `7d`, `24h`, `30m` ali na datum ISO |
| `--max-openings <n>` | Zaustavi se po tolikšnem številu odpiranj. Izpustite za neomejeno |
| `--domain <host>` | Streže na tem gostitelju namesto na `lida.sh` |
| `--in <folder-id>` | Ustvari v tej mapi (samo pri ustvarjanju; `--in-domain <host>`, če se slug mape ponavlja) |
| `--status <active\|paused>` | Zaustavi ali nadaljuje (samo pri posodabljanju) |
| `--sticky` / `--no-sticky` | Obiskovalec, ki se vrne, obdrži isto različico (privzeto lepljivo) |
| `--restart-split` | Na novo premeša lepljive dodelitve (samo pri posodabljanju) |
| `--forward-params` / `--no-forward-params` | Različicam URL doda poizvedbeni niz obiskovalca (privzeto izklopljeno). Glejte [Posredovanje poizvedbenih parametrov](#forward-query-parameters) |
| `--variant <name>` | Začne blok različice (samo pri ustvarjanju). Glejte [Različice](#variants) |
| `--weight <n>` `--when <key=v1,v2>` | Za posamezno različico. Glejte [Različice](#variants) in [Pravila poizvedbenih parametrov](#query-parameter-rules) |
| `--preview-name <text>` | Javno ime predogleda |
| `--preview-description <text>` | Javni opis predogleda |
| `--preview-image <path>` | Javna slika predogleda |
| `--utm-source` `--utm-medium` `--utm-campaign` `--utm-term` `--utm-content` | Samo za povezave URL |
| `--clear-password` `--clear-expires` `--clear-starts` `--clear-tags` `--clear-preview` `--clear-name` `--clear-max-openings` | Samo pri posodabljanju |

`--status` sprejme samo `active` ali `paused`. Stanje »poteklo« izhaja iz `--expires`. Stanje »načrtovano« izhaja iz `--starts`. Javno razreševanje do začetka vrača »ni najdeno«. Ko je dosežena vrednost `--max-openings`, se povezava zaustavi; za ponovno strežbo povečajte število ali uporabite `--clear-max-openings`. Že porabljena odpiranja ostanejo šteta, dokler omejitve ne spremenite ali odstranite.

Slugi na `lida.sh` so skupni. Če je beseda zasedena, dodajte [domeno po meri](/sl/domains) in poskusite znova z `--domain`. Povezava na domeni z blagovno znamko ni hkrati objavljena tudi na `lida.sh`.

## Zastavice za izpis seznama

Izpiše eno stran, `{items, cursor}`: `--limit` je 1-100 (privzeto 50); `--cursor` podajajte z vrednostjo `cursor` s prejšnje strani, dokler ta ni `null`. Stran lahko vsebuje manj elementov, kot določa `--limit`, če filter nekatere preskoči. `--q` se ujema s celimi besedami, pri čemer zadnja velja kot predpona (`laun` najde `example.com/launch`), rezultati pa so razvrščeni po ustreznosti; `--in` izpiše eno mapo, najprej mape; sicer so najnovejši prvi.

| Zastavica | Opombe |
| --- | --- |
| `--limit <n>` | Število elementov na stran, 1-100 (privzeto 50) |
| `--cursor <c>` | Vrednost `cursor` s prejšnje strani |
| `--q <text>` | Išče besede v imenu, slugu, imenih in ciljih različic, imenih datotek, besedilu izsekov in oznakah |
| `--tag <tag>` | Filtrira po oznaki |
| `--kind <url\|file\|text\|folder\|group>` | Filtrira po vrsti (`group` = več različic) |
| `--status <status>` | `active`, `paused`, `expired`, `scheduled` ali `mixed` |
| `--in <folder-id\|root>` | Samo tisto, kar je neposredno v tej mapi ali na najvišji ravni. Brez te zastavice je izpisano vse |

## Različice

Vsaka povezava je vsebnik ene ali več **različic**. Različica je vsebina (URL, datoteka ali besedilo) skupaj z lastnimi omejitvami dostopa (`--password`, `--starts`, `--expires`, `--max-openings`), utežjo `--weight` in neobveznimi pogoji za obiskovalce (`--when`). Brez `--variant` ima povezava eno različico z imenom `main`, vsi zgornji ukazi pa so okrajšava zanjo. Obiskovalec dobi eno različico: različice, katerih `--when` se ujema, tvorijo nabor (če se ne ujema nobena, ga tvorijo brezpogojne različice), nato sledi utežena izbira. Z lepljivo dodelitvijo (privzeto) obiskovalec, ki se vrne, obdrži isto različico. Omejitve dostopa povezave imajo prednost pred omejitvami različic. Imena različic: male črke, števke, notranji vezaji, 1–40 znakov, edinstvena znotraj povezave. Največ 20 različic.

Vrednost `kind` povezave je pri eni različici vrsta te različice, pri več različicah pa `group`. Vrednost `status` povezave je stanje omejitve povezave, če je nastavljeno (`paused`, `scheduled`, `expired`), sicer skupno stanje različic, sicer `mixed`. `variantStatuses` šteje `{active, paused, expired, scheduled}`.

### Ustvarjanje z bloki različic

```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>` začne blok različice. Zastavice za njo pripadajo tej različici do naslednje `--variant`: `--url|--file|--text`, `--password`, `--starts`, `--expires`, `--max-openings`, `--weight <n>`, `--when <key=v1,v2>` (ponovljivo), `--utm-*`. Zastavice povezave (`--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params`) navedite pred prvo `--variant`.

### Podukazi za različice

```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>` sprejme eno od `--url`, `--file`, `--text` ter zastavice omejitev dostopa, `--weight`, `--when`, `--utm-*`. `variants update <id> <name>` sprejme `--name <new>`, vsebino, zastavice omejitev dostopa, `--status active|paused`, `--weight`, `--when`, `--clear-when`, `--clear-password`, `--clear-starts`, `--clear-expires`, `--clear-max-openings`. Povezava ima vedno vsaj eno različico.

### Ključi `--when`

| Ključ | Polje JSON | Vrednosti |
| --- | --- | --- |
| `country` | `countries` | Kode 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` | ujemanje predpone (`de`, `en-us`) |
| `referrer` | `referrerHosts` | pripona gostitelja (`twitter.com`) |

Ujemati se mora vsak nastavljeni ključ. `--when country=DE,AT --when device=mobile` je `{ "countries": ["DE","AT"], "devices": ["mobile"] }`.

### Pravila poizvedbenih parametrov

`--when` sprejme tudi pravila `param:` za poizvedbeni niz obiskovalca (`lida.sh/promo?src=newsletter`). Ključi razlikujejo med velikimi in malimi črkami, vrednosti se primerjajo natančno, dovoljenih je največ 10 pravil na različico. Vejice ločujejo `--when`, zato vrednost parametra ne sme vsebovati vejice; za sezname uporabite `|`.

| Sintaksa | JSON `op` | Ujema se, ko |
| --- | --- | --- |
| `param:KEY=VALUE` | `equals` | je vrednost natanko `VALUE` |
| `param:KEY!=VALUE` | `notEquals` | se vrednost razlikuje ali ključ manjka |
| `param:KEY~=VALUE` | `includes` | vrednost vsebuje `VALUE` |
| `param:KEY^=VALUE` | `startsWith` | se vrednost začne z `VALUE` |
| `param:KEY$=VALUE` | `endsWith` | se vrednost konča z `VALUE` |
| `param:KEY=v1\|v2` | `in` | je vrednost ena od vrednosti s seznama |
| `param:KEY?` ali `param:KEY` | `exists` | je ključ prisoten |
| `param:!KEY` | `missing` | ključ manjka |

```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?"
```

Oblika JSON: `"when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }` (`value` se pri `exists` / `missing` izpusti). Vrednosti parametrov se preverijo ob odpiranju in se nikoli ne shranijo v analitiko.

### Posredovanje poizvedbenih parametrov

`--forward-params` / `--no-forward-params` pri `links create` in `links update` (na ravni povezave, privzeto izklopljeno) različicam URL doda celoten poizvedbeni niz obiskovalca: `lida.sh/promo?src=nl` odpre `https://example.com/?src=nl`. Vrednosti obiskovalca preglasijo shranjene, vključno z `--utm-*`. Različice z datoteko in besedilom to nastavitev prezrejo. To je usmerjanje, ne nadzor dostopa: parametre lahko doda kdorkoli. Vrednosti parametrov se ne shranijo v analitiko. `links get` to prikaže kot `forwardParams`.

### Lepljivost in ponovni zagon razdelitve

`links update <id> --sticky` / `--no-sticky` določa, ali obiskovalec, ki se vrne, obdrži isto različico. `links update <id> --restart-split` na novo premeša lepljive dodelitve. Zastavice vsebine pri `links update` delujejo samo za povezave z eno različico; sicer uporabite `links variants update <id> <name>`.

## Mape

Mapa je povezava, ki navaja elemente, ki ste jih dali vanjo. Za delovanje javne strani in dostopa glejte [Mape](/sl/folders).

```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>` nastavi ime mape (ne `--name`) in sprejme `--slug`, `--domain`, `--password`, `--starts`, `--expires`, `--max-openings`, `--tag`, `--preview-*` in `--in`. Ni je mogoče kombinirati z `--url`, `--file`, `--text` ali `--variant`. `links move` izpiše `{id, folder}`. `links copy` ohrani raven dostopa, vendar kopija dobi nov URL za deljenje; osebe se ne kopirajo. `links delete` za mapo premakne njene elemente raven višje; `--with-contents` jih prav tako izbriše. Vrstice izpisov list, get in create vsebujejo `folder` (slug mape, ki vsebuje element, ali `null`); vrstice map vsebujejo tudi `items`.

## Dostop in deljenje

Nove povezave in mape so `restricted`: njihov `url` je `https://linkdash.dev/s/<token>`, ki ga lahko odprete samo vi in osebe, s katerimi ga delite, ko so prijavljene. `--access link` ta URL odpre vsakomur, ki ga ima. `--access public` streže povezavo na njenem kratkem URL-ju (`lida.sh/<slug>` ali vaša domena po meri). `--access public` uporabite za povezave, ki jih objavljate javno. Slug ostane id za vse ukaze, njegov kratki URL pa ostane rezerviran, dokler povezava ni javna. Celoten model je opisan v [Deljenje in dostop](/sl/sharing).

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

| Ukaz | Izpiše |
| --- | --- |
| `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` (brez id) | `{items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}`, najprej nazadnje deljeni |
| `links shared` | `{items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}`, najprej najnovejši |
| `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>` (ali `links update <id> --reset-share-link`) | `{id, access, url}` |

`--role editor` osebo nastavi kot urednika: lahko spreminja element in si ogleduje njegovo statistiko, ne more pa upravljati gesel, sluga, domene, dostopa in deljenja niti brisati, premikati ali kopirati, za cilj, zaščiten z geslom, pa mora najprej uporabiti `links unlock` (30 minut). Uredniki uporabljajo `_id` ali URL za deljenje iz `links shared`. Vsi ukazi sprejmejo `--domain <host>`, če se slug ponavlja. `url` v izpisu `create`, `get`, `list`, `update`, `copy` in `share` je URL za deljenje, razen če je povezava javna – takrat je to kratki URL; vrstice vsebujejo `access`. Do 200 oseb na element, 50 e-poštnih naslovov na klic, 100 e-poštnih povabil na račun na dan. Oba seznama izpišeta eno stran: `--limit` je 1-100 (privzeto 50); `--cursor` s prejšnje strani podajajte, dokler `cursor` ni `null`. `links leave` sprejme `_id` ali `url` iz `links shared`; dostop prek deljene nadrejene mape ostane. Deljenje, preklic deljenja, sprememba dostopa in ponastavitev štejejo vsak kot en dogodek; zapustitev ne.

## Statistika

```bash
linkdash links stats <id> --last 24h
```

`--last` je trajanje (`24h`, `7d`). Privzeto `24h`. JSON vsebuje `visits`, `downloads`, `plays`, `visitsInLast`, `countries`, `referrers`, `variants` (seštevki po različicah), `visitors` (vsak z `variant`) in `crawlers` (`[{crawler, company, category, hits, lastSeen}]`: boti in predogledi povezav, ki so pridobili povezavo; nikoli se ne štejejo kot obiski).

## CSV

Stolpci: `slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access`. Ena vrstica na različico. `kind`, `status`, `url`, `text`, `fileName`, `weight` in `when` (niz JSON) veljajo za posamezno različico; ostali veljajo za povezavo in se ponavljajo. `folder` je slug mape, v kateri je povezava. `access` je `restricted`, `link` ali `public`. Gesla, žetoni za deljenje in osebe niso vključeni.

```bash
linkdash links export > links.csv
linkdash links import links.csv
```

Uvoz združi vrstice po slugu in domeni. Prva vrstica ustvari povezavo z njeno različico; nadaljnje vrstice dodajo različice. Pri obstoječi povezavi prva vrstica posodobi polja povezave, nato vsaka vrstica posodobi različico z istim imenom, če obstaja, sicer jo doda. Vrstice datotek brez vsebine se preskočijo z napako za posamezno vrstico. Vrstice s `kind` = `folder` (z `name`) ustvarijo mape; stolpec `folder` vsako povezavo umesti v njeno mapo, ko obstajajo vse vrstice. Prazen `access` nove povezave nastavi kot omejene, obstoječe pa pusti nespremenjene.

## Primeri

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

Glejte tudi [mape](/sl/folders), [deljenje in dostop](/sl/sharing), [webhooke](/sl/webhooks) in [domene po meri](/sl/domains).
