CLI
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.
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. MCP: MCP. Skill pro agenty: Skill pro agenty. Ceník: Ceník. Čistý markdown: cli.md.
Příznak --json neexistuje. Při chybě je návratový kód 1.
Ověření
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. Klíče API (HTTP a MCP): Klíče API.
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 |
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í 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í). Vytvoření přijímá právě jedno z --url, --file nebo --text (z toho se stane varianta main), bloky --variant (viz Varianty), nebo --folder <name> (viz Složky).
| 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í |
--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 |
--variant <name> |
Zahájí blok varianty (jen při vytvoření). Viz Varianty |
--weight <n> --when <key=v1,v2> |
Pro každou variantu. Viz Varianty a Pravidla pro parametry dotazu |
--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 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
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
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í |
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.
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.
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
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í.
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
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, sdílení a přístup, webhooky a vlastní domény.

