---
title: CLI
description: >-
  Nainstalujte linkdash-cli z npm a poté spusťte příkaz `linkdash`. Úspěšné
  příkazy vypisují JSON na stdout. Nápověda a chyby se vypisují jako prostý text
  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
```

Balíček npm se jmenuje `linkdash-cli`. Příkaz se jmenuje `linkdash`.

Ekvivalent přes HTTP: [HTTP API](/cs/api). MCP: [MCP](/cs/mcp). Skill pro agenty: [Skill pro agenty](/cs/skill). Ceník: [Ceník](/cs/pricing). Čistý markdown: [cli.md](https://linkdash.dev/cli.md).

Příznak `--json` neexistuje. Při chybě je návratový kód 1.

## Ověření

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

Ještě nemáte účet? `auth create` otevře https://linkdash.dev/sign-up a poté se vrátí na https://linkdash.dev/device s kódem z CLI, abyste mohli přístup schválit. Účet už máte? `auth login` otevře `/device`. Bez prohlížeče: nastavte `LINKDASH_TOKEN` na token relace z `auth create` nebo `auth login`. Tokeny si nevymýšlejte.

Soubor relace: `~/.config/linkdash/config.json` (režim 0600).

CLI nemůže měnit e-mail, heslo ani fakturaci. Pošlete uživatele na [nástěnku](https://linkdash.dev/dashboard/billing). Klíče API (HTTP a MCP): [Klíče API](https://linkdash.dev/dashboard/keys).

## Příkazy

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

| Příkaz | Co dělá |
| --- | --- |
| `auth create` | Registrace v prohlížeči a poté schválení zařízení |
| `auth login` | Přihlášení zařízení přes prohlížeč |
| `auth logout` | Zapomene uloženou relaci |
| `auth whoami` | JSON přihlášeného účtu |
| `links list` | Vypíše odkazy a složky po stránkách (`--limit`, `--cursor`) |
| `links get <id>` | Jeden odkaz |
| `links create --url <url>` | Krátký odkaz z URL |
| `links create --file <path>` | Nahraje soubor a vrátí odkaz |
| `links create --text <text>` | Uloží úryvek textu |
| `links create --folder <name>` | Vytvoří [složku](/cs/folders) |
| `links create --variant <name> …` | Odkaz s několika variantami (rozdělení / cílení) |
| `links update <id>` | Změní cíl, soubor, heslo, expiraci, doménu, stav, sticky nebo předávané parametry |
| `links move <id> --in <folder-id>` | Přesune odkaz nebo složku do složky (`--root` pro nejvyšší úroveň) |
| `links copy <id>` | Vytvoří kopii s novým slugem ve stejné složce |
| `links delete <id>` | Smaže odkaz (položky složky se přesunou o úroveň výš; `--with-contents` je smaže) |
| `links share <id> --email <email>` | [Sdílí](/cs/sharing) s lidmi podle e-mailu (opakujte `--email`; `--role editor` jim umožní položku měnit; každý nový člověk dostane e-mail s pozvánkou) |
| `links unshare <id> --email <email>` | Odebere někomu přístup |
| `links shares [id]` | Kdo kromě vás může položku otevřít, včetně přístupu přes nadřazenou složku. Bez id: vše, k čemu jste lidi pozvali, po stránkách (`--limit`, `--cursor`) |
| `links shared` | Co s vámi sdíleli ostatní, po stránkách (`--limit`, `--cursor`) |
| `links leave <_id \| share URL>` | Vzdá se položky, která je s vámi sdílená |
| `links role <id> --email <e> --role viewer\|editor` | Nastaví pozvanému člověku roli čtenáře nebo editora |
| `links unlock <_id \| share URL>` | Zadá heslo sdílené položky, abyste na 30 minut viděli a mohli upravit její cíl |
| `links activity <id>` | Kdo položku změnil a jak |
| `links reset-link <id>` | Nová URL pro sdílení; stará URL `linkdash.dev/s/` přestane fungovat |
| `links stats <id>` | Celkové počty návštěv, stažení a přehrání, také po variantách, plus crawlery |
| `links export` | Vypíše všechny odkazy jako CSV (jeden řádek na variantu) |
| `links import <file>` | Importuje řádky s URL a textem z CSV |
| `links variants list <id>` | Varianty odkazu |
| `links variants add <id> --name <n>` | Přidá variantu |
| `links variants update <id> <name>` | Změní variantu |
| `links variants remove <id> <name>` | Odebere variantu |
| `webhooks list` | Vypíše koncové body webhooků (tajný klíč skrytý) |
| `webhooks get <id>` | Zobrazí URL jednoho webhooku (tajný klíč skrytý) |
| `webhooks create --url <https>` | Přidá koncový bod HTTPS (tajný klíč se zobrazí jednou) |
| `webhooks rotate <id>` | Vydá nový podpisový tajný klíč |
| `webhooks delete <id>` | Odebere webhook |
| `domains list` | Vypíše vlastní názvy hostitelů |
| `domains add <host>` | Přidá název hostitele (1 v tarifu Free) |
| `domains connect <host>` | URL pro použití Domain Connect, nebo null |
| `domains verify <host>` | Zkontroluje DNS pomocí Unkey |
| `domains remove <host>` | Odebere název hostitele |
| `-h, --help` | Nápověda (prostý text) |
| `-v, --version` | Verze |

Pokud stejný slug existuje na dvou doménách vlastníka, zadejte `--domain`.

## Příznaky pro vytvoření a úpravu

Slug je id odkazu a u veřejného odkazu také jeho veřejná cesta. Název vidíte jen vy. Nové odkazy jsou omezené (viz [Přístup a sdílení](#access-and-sharing)). Vytvoření přijímá **právě jedno** z `--url`, `--file` nebo `--text` (z toho se stane varianta `main`), bloky `--variant` (viz [Varianty](#variants)), nebo `--folder <name>` (viz [Složky](#folders)).

| Příznak | Poznámky |
| --- | --- |
| `--url <url>` | Cílová URL |
| `--file <path>` | Soubor k nahrání (při vytvoření, nebo nahrazení obsahu při úpravě) |
| `--text <text>` | Úryvek textu |
| `--access <restricted\|link\|public>` | Kdo může položku otevřít. Výchozí `restricted`. Viz [Přístup a sdílení](#access-and-sharing) |
| `--reset-share-link` | Vydá novou URL pro sdílení (jen při úpravě) |
| `--slug <id>` | Veřejná cesta: `a-z0-9` a vnitřní pomlčky, 1–64 |
| `--name <label>` | Soukromý popisek |
| `--tag <tag>` | Lze opakovat. Malá písmena, bez čárek. Max. 20 |
| `--starts <when>` | Zveřejní po `7d`, `24h`, `30m` nebo k datu ISO |
| `--password <secret>` | K otevření vyžaduje toto heslo |
| `--expires <when>` | Přestane obsluhovat po `7d`, `24h`, `30m` nebo k datu ISO |
| `--max-openings <n>` | Pozastaví po tomto počtu otevření. Vynechte pro neomezený počet |
| `--domain <host>` | Obsluhuje na tomto hostiteli místo `lida.sh` |
| `--in <folder-id>` | Vytvoří uvnitř této složky (jen při vytvoření; `--in-domain <host>`, pokud se slug složky opakuje) |
| `--status <active\|paused>` | Pozastaví nebo obnoví (jen při úpravě) |
| `--sticky` / `--no-sticky` | Vracející se návštěvník dostane stejnou variantu (výchozí sticky) |
| `--restart-split` | Znovu zamíchá sticky přiřazení (jen při úpravě) |
| `--forward-params` / `--no-forward-params` | Připojí query string návštěvníka k URL variantám (výchozí vypnuto). Viz [Předávání parametrů dotazu](#forward-query-parameters) |
| `--variant <name>` | Zahájí blok varianty (jen při vytvoření). Viz [Varianty](#variants) |
| `--weight <n>` `--when <key=v1,v2>` | Pro každou variantu. Viz [Varianty](#variants) a [Pravidla pro parametry dotazu](#query-parameter-rules) |
| `--preview-name <text>` | Veřejný název v náhledu odkazu |
| `--preview-description <text>` | Veřejný popis v náhledu odkazu |
| `--preview-image <path>` | Veřejný obrázek v náhledu odkazu |
| `--utm-source` `--utm-medium` `--utm-campaign` `--utm-term` `--utm-content` | Jen pro URL odkazy |
| `--clear-password` `--clear-expires` `--clear-starts` `--clear-tags` `--clear-preview` `--clear-name` `--clear-max-openings` | Jen při úpravě |

`--status` přijímá pouze `active` nebo `paused`. Stav vypršení plyne z `--expires`. Stav naplánování plyne z `--starts`. Veřejné rozlišení vrací do začátku „nenalezeno“. Po dosažení `--max-openings` se odkaz pozastaví; chcete-li jej znovu obsluhovat, zvyšte číslo nebo použijte `--clear-max-openings`. Již využitá otevření zůstávají započítaná, dokud limit nezměníte nebo neodstraníte.

Slugy na `lida.sh` jsou sdílené. Pokud je slovo obsazené, přidejte [vlastní doménu](/cs/domains) a zkuste to znovu s `--domain`. Odkaz na vlastní doméně se nepublikuje zároveň na `lida.sh`.

## Příznaky pro výpis

Vypíše jednu stránku, `{items, cursor}`: `--limit` je 1–100 (výchozí 50); předávejte `--cursor` s hodnotou `cursor` z předchozí stránky, dokud není `null`. Stránka může obsahovat méně položek než `--limit`, pokud filtr některé přeskočí. `--q` hledá celá slova, přičemž poslední slovo se bere jako prefix (`laun` najde `example.com/launch`), řazeno podle relevance; `--in` vypíše jednu složku, složky jako první; jinak od nejnovějších.

| Příznak | Poznámky |
| --- | --- |
| `--limit <n>` | Položek na stránku, 1–100 (výchozí 50) |
| `--cursor <c>` | Hodnota `cursor` z předchozí stránky |
| `--q <text>` | Hledá slova v názvu, slugu, názvech a cílech variant, názvech souborů, textu úryvků a štítcích |
| `--tag <tag>` | Filtruje podle štítku |
| `--kind <url\|file\|text\|folder\|group>` | Filtruje podle druhu (`group` = několik variant) |
| `--status <status>` | `active`, `paused`, `expired`, `scheduled` nebo `mixed` |
| `--in <folder-id\|root>` | Jen to, co je přímo v této složce, nebo na nejvyšší úrovni. Bez něj se vypíše vše |

## Varianty

Každý odkaz je kontejner jedné nebo více **variant**. Varianta je obsah (URL, soubor nebo text) plus vlastní brána (`--password`, `--starts`, `--expires`, `--max-openings`), váha `--weight` a volitelné podmínky pro návštěvníka (`--when`). Bez `--variant` má odkaz jednu variantu s názvem `main` a každý výše uvedený příkaz je pro ni zkratkou. Návštěvník dostane jednu variantu: varianty, jejichž `--when` odpovídá, tvoří množinu kandidátů (pokud žádná neodpovídá, použijí se varianty bez podmínek), a z ní se provede vážený výběr. Při sticky přiřazení (výchozí) dostane vracející se návštěvník stejnou variantu. Brána samotného odkazu má přednost před branami variant. Názvy variant: malá písmena, číslice, vnitřní pomlčky, 1–40 znaků, jedinečné v rámci odkazu. Max. 20 variant.

`kind` odkazu je u jedné varianty druh této varianty a u více variant `group`. `status` odkazu je brána odkazu, pokud je nastavená (`paused`, `scheduled`, `expired`), jinak společný stav variant, jinak `mixed`. `variantStatuses` počítá `{active, paused, expired, scheduled}`.

### Vytvoření s bloky variant

```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>` zahájí blok varianty. Příznaky za ním patří k této variantě až do dalšího `--variant`: `--url|--file|--text`, `--password`, `--starts`, `--expires`, `--max-openings`, `--weight <n>`, `--when <key=v1,v2>` (lze opakovat), `--utm-*`. Příznaky odkazu (`--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params`) patří před první `--variant`.

### Podpříkazy variant

```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>` přijímá jedno z `--url`, `--file`, `--text`, plus příznaky brány, `--weight`, `--when`, `--utm-*`. `variants update <id> <name>` přijímá `--name <new>`, obsah, příznaky brány, `--status active|paused`, `--weight`, `--when`, `--clear-when`, `--clear-password`, `--clear-starts`, `--clear-expires`, `--clear-max-openings`. Odkaz si vždy ponechá alespoň jednu variantu.

### Klíče `--when`

| Klíč | Pole JSON | Hodnoty |
| --- | --- | --- |
| `country` | `countries` | Kódy 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` | shoda prefixu (`de`, `en-us`) |
| `referrer` | `referrerHosts` | přípona hostitele (`twitter.com`) |

Každý nastavený klíč musí odpovídat. `--when country=DE,AT --when device=mobile` odpovídá `{ "countries": ["DE","AT"], "devices": ["mobile"] }`.

### Pravidla pro parametry dotazu

`--when` přijímá také pravidla `param:` pro query string návštěvníka (`lida.sh/promo?src=newsletter`). Klíče rozlišují velikost písmen, hodnoty se porovnávají přesně, max. 10 pravidel na variantu. Čárky rozdělují `--when`, takže hodnota parametru nemůže obsahovat čárku; pro seznamy použijte `|`.

| Syntaxe | JSON `op` | Odpovídá, když |
| --- | --- | --- |
| `param:KEY=VALUE` | `equals` | hodnota je přesně `VALUE` |
| `param:KEY!=VALUE` | `notEquals` | hodnota se liší, nebo klíč chybí |
| `param:KEY~=VALUE` | `includes` | hodnota obsahuje `VALUE` |
| `param:KEY^=VALUE` | `startsWith` | hodnota začíná na `VALUE` |
| `param:KEY$=VALUE` | `endsWith` | hodnota končí na `VALUE` |
| `param:KEY=v1\|v2` | `in` | hodnota je jednou z položek seznamu |
| `param:KEY?` nebo `param:KEY` | `exists` | klíč je přítomen |
| `param:!KEY` | `missing` | klíč chybí |

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

Tvar JSON: `"when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }` (`value` se u `exists` / `missing` vynechává). Hodnoty parametrů se porovnávají v okamžiku otevření a nikdy se neukládají do analytiky.

### Předávání parametrů dotazu

`--forward-params` / `--no-forward-params` u `links create` a `links update` (na úrovni odkazu, ve výchozím stavu vypnuto) připojí celý query string návštěvníka k URL variantám: `lida.sh/promo?src=nl` otevře `https://example.com/?src=nl`. Hodnoty návštěvníka přepisují uložené hodnoty, včetně `--utm-*`. Varianty se souborem a textem to ignorují. Jde o směrování, nikoli o řízení přístupu: parametry může přidat kdokoli. Hodnoty parametrů se neukládají do analytiky. `links get` to zobrazuje jako `forwardParams`.

### Sticky a nové rozdělení

`links update <id> --sticky` / `--no-sticky` nastavuje, zda vracející se návštěvník dostane stejnou variantu. `links update <id> --restart-split` znovu zamíchá sticky přiřazení. Příznaky obsahu u `links update` fungují jen u odkazů s jedinou variantou; jinak použijte `links variants update <id> <name>`.

## Složky

Složka je odkaz, který vypisuje položky, které do ní vložíte. Jak funguje veřejná stránka a přístup, najdete v části [Složky](/cs/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>` nastavuje název složky (ne `--name`) a přijímá `--slug`, `--domain`, `--password`, `--starts`, `--expires`, `--max-openings`, `--tag`, `--preview-*` a `--in`. Nelze jej kombinovat s `--url`, `--file`, `--text` ani `--variant`. `links move` vypíše `{id, folder}`. `links copy` zachová úroveň přístupu, ale dostane novou URL pro sdílení; lidé se nekopírují. `links delete` u složky přesune její položky o úroveň výš; `--with-contents` je smaže také. Řádky výpisu, získání a vytvoření obsahují `folder` (slug nadřazené složky, nebo `null`); řádky složek obsahují také `items`.

## Přístup a sdílení

Nové odkazy a složky jsou `restricted`: jejich `url` je `https://linkdash.dev/s/<token>`, kterou můžete po přihlášení otevřít jen vy a lidé, se kterými ji sdílíte. `--access link` zpřístupní tuto URL každému, kdo ji má. `--access public` obsluhuje odkaz na jeho krátké URL (`lida.sh/<slug>` nebo vaše vlastní doména). Pro odkazy, které zveřejňujete, použijte `--access public`. Slug zůstává id pro všechny příkazy a jeho krátká URL zůstává rezervovaná, dokud odkaz není veřejný. Úplný model najdete v části [Sdílení a přístup](/cs/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
```

| Příkaz | Vypíš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` (bez id) | `{items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}`, naposledy sdílené jako první |
| `links shared` | `{items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}`, od nejnovějších |
| `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>` (nebo `links update <id> --reset-share-link`) | `{id, access, url}` |

`--role editor` udělá z člověka editora: může položku měnit a vidět její statistiky, ale ne hesla, slug, doménu, přístup, sdílení, mazání, přesun ani kopírování, a cíl chráněný heslem musí nejprve odemknout pomocí `links unlock` (30 minut). Editoři používají `_id` nebo URL pro sdílení z `links shared`. Všechny příkazy přijímají `--domain <host>`, pokud se slug opakuje. `url` ve výstupu `create`, `get`, `list`, `update`, `copy` a `share` je URL pro sdílení, pokud odkaz není veřejný, jinak krátká URL; řádky obsahují `access`. Až 200 lidí na položku, 50 e-mailů na volání, 100 e-mailů s pozvánkou na účet za den. Oba seznamy vypisují jednu stránku: `--limit` je 1–100 (výchozí 50); předávejte `--cursor` z předchozí stránky, dokud `cursor` není `null`. `links leave` přijímá `_id` nebo `url` z `links shared`; přístup přes nadřazenou sdílenou složku zůstává. Sdílení, zrušení sdílení, změna přístupu a reset se každý počítají jako jedna událost; opuštění ne.

## Statistiky

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

`--last` je doba trvání (`24h`, `7d`). Výchozí `24h`. JSON obsahuje `visits`, `downloads`, `plays`, `visitsInLast`, `countries`, `referrers`, `variants` (celkové počty po variantách), `visitors` (každý s `variant`) a `crawlers` (`[{crawler, company, category, hits, lastSeen}]`: boti a náhledy odkazů, které odkaz načetly; nikdy se nepočítají jako návštěvy).

## CSV

Sloupce: `slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access`. Jeden řádek na variantu. `kind`, `status`, `url`, `text`, `fileName`, `weight` a `when` (řetězec JSON) se vztahují k variantě; ostatní se vztahují k odkazu a opakují se. `folder` je slug složky, ve které odkaz je. `access` je `restricted`, `link` nebo `public`. Bez hesel, tokenů pro sdílení a lidí.

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

Import seskupuje řádky podle slugu + domény. První řádek vytvoří odkaz s jeho variantou; další řádky přidávají varianty. U existujícího odkazu první řádek aktualizuje pole odkazu a poté každý řádek aktualizuje variantu podle názvu, pokud existuje, jinak ji přidá. Řádky se soubory bez obsahu se přeskočí s chybou pro daný řádek. Řádky s `kind` = `folder` (s `name`) vytvoří složky; sloupec `folder` umístí každý odkaz do jeho složky poté, co existují všechny řádky. Prázdný `access` nastaví nové odkazy jako omezené a existující odkazy ponechá beze změny.

## Příklady

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

Viz také [složky](/cs/folders), [sdílení a přístup](/cs/sharing), [webhooky](/cs/webhooks) a [vlastní domény](/cs/domains).
