CLI
Nainštalujte linkdash-cli z npm a potom spustite príkaz `linkdash`. Úspešné príkazy vypisujú JSON na stdout. Nápoveda a chyby sú obyčajný text na stderr.
npm i -g linkdash-cli
# or: pnpm add -g linkdash-cli / bun add -g linkdash-cli / npx linkdash-cli@latest
Balík npm sa volá linkdash-cli. Príkaz je linkdash.
Ekvivalent cez HTTP: HTTP API. MCP: MCP. Skill pre agentov: Skill pre agentov. Ceny: Ceny. Čistý markdown: cli.md.
Príznak --json neexistuje. Pri chybách je návratový kód 1.
Autentifikácia
linkdash auth create
linkdash auth login
linkdash auth whoami
linkdash auth logout
Ešte nemáte účet? auth create otvorí https://linkdash.dev/sign-up a potom vás vráti na https://linkdash.dev/device s kódom CLI, aby ste mohli prihlásenie schváliť. Už máte účet? auth login otvorí /device. Bez prehliadača (headless): nastavte LINKDASH_TOKEN na token relácie z auth create alebo auth login. Tokeny si nevymýšľajte.
Súbor relácie: ~/.config/linkdash/config.json (režim 0600).
CLI nedokáže zmeniť e-mail, heslo ani fakturáciu. Pošlite používateľa na nástenku. Kľúče API (HTTP a MCP): Kľúče API.
Príkazy
linkdash <command> [options]
| Príkaz | Čo robí |
|---|---|
auth create |
Registrácia v prehliadači, potom schválenie zariadenia |
auth login |
Prihlásenie zariadenia v prehliadači |
auth logout |
Zabudne uloženú reláciu |
auth whoami |
JSON prihláseného účtu |
links list |
Vypíše odkazy a priečinky po stránkach (--limit, --cursor) |
links get <id> |
Jeden odkaz |
links create --url <url> |
Krátky odkaz z URL |
links create --file <path> |
Nahrá súbor a vráti odkaz |
links create --text <text> |
Uloží úryvok |
links create --folder <name> |
Vytvorí priečinok |
links create --variant <name> … |
Odkaz s viacerými variantmi (rozdelenie / cielenie) |
links update <id> |
Zmení cieľ, súbor, heslo, expiráciu, doménu, stav, sticky priradenie alebo preposielané parametre |
links move <id> --in <folder-id> |
Presunie odkaz alebo priečinok do priečinka (--root pre najvyššiu úroveň) |
links copy <id> |
Vytvorí kópiu s novým slugom v tom istom priečinku |
links delete <id> |
Odstráni odkaz (položky priečinka sa presunú o úroveň vyššie; --with-contents ich odstráni) |
links share <id> --email <email> |
Zdieľa s ľuďmi podľa e-mailu (--email opakujte; --role editor im umožní položku meniť; každý nový človek dostane e-mail s pozvánkou) |
links unshare <id> --email <email> |
Odoberie niekomu prístup |
links shares [id] |
Kto ho okrem vás môže otvoriť, vrátane prístupu cez nadradený priečinok. Bez id: všetko, k čomu ste pozvali ľudí, po stránkach (--limit, --cursor) |
links shared |
Čo s vami zdieľali iní ľudia, po stránkach (--limit, --cursor) |
links leave <_id | share URL> |
Vzdá sa niečoho, čo s vami niekto zdieľal |
links role <id> --email <e> --role viewer|editor |
Nastaví niekoho, koho ste pozvali, ako čitateľa alebo editora |
links unlock <_id | share URL> |
Zadá heslo zdieľanej položky, aby ste jej cieľ mohli 30 minút vidieť a upravovať |
links activity <id> |
Kto položku zmenil a ako |
links reset-link <id> |
Nová URL na zdieľanie; stará URL linkdash.dev/s/ prestane fungovať |
links stats <id> |
Súčty návštev, stiahnutí a prehratí, aj za jednotlivé varianty, plus crawlery |
links export |
Vypíše všetky odkazy ako CSV (jeden riadok na variant) |
links import <file> |
Importuje riadky s URL a textom z CSV |
links variants list <id> |
Varianty odkazu |
links variants add <id> --name <n> |
Pridá variant |
links variants update <id> <name> |
Zmení variant |
links variants remove <id> <name> |
Odstráni variant |
webhooks list |
Vypíše koncové body webhookov (tajný kľúč je maskovaný) |
webhooks get <id> |
Zobrazí URL jedného webhooku (tajný kľúč je maskovaný) |
webhooks create --url <https> |
Pridá koncový bod HTTPS (tajný kľúč sa zobrazí iba raz) |
webhooks rotate <id> |
Vydá nový podpisový tajný kľúč |
webhooks delete <id> |
Odstráni webhook |
domains list |
Vypíše vlastné názvy hostiteľov |
domains add <host> |
Pridá názov hostiteľa (1 v pláne Free) |
domains connect <host> |
URL na použitie Domain Connect alebo null |
domains verify <host> |
Skontroluje DNS cez Unkey |
domains remove <host> |
Odstráni názov hostiteľa |
-h, --help |
Nápoveda (obyčajný text) |
-v, --version |
Verzia |
Ak rovnaký slug existuje na dvoch doménach vlastníka, zadajte --domain.
Príznaky pre vytváranie a úpravu
Slug je id odkazu a zároveň jeho verejná cesta, keď je odkaz verejný. Názov vidíte iba vy. Nové odkazy sú obmedzené (pozrite Prístup a zdieľanie). Príkaz create prijíma práve jedno z týchto: --url, --file alebo --text (z toho sa stane variant main), bloky --variant (pozrite Varianty) alebo --folder <name> (pozrite Priečinky).
| Príznak | Poznámky |
|---|---|
--url <url> |
Cieľová URL |
--file <path> |
Súbor na nahratie (pri vytvorení), pri úprave nahradí obsah súboru |
--text <text> |
Úryvok |
--access <restricted|link|public> |
Kto ho môže otvoriť. Predvolene restricted. Pozrite Prístup a zdieľanie |
--reset-share-link |
Vydá novú URL na zdieľanie (iba update) |
--slug <id> |
Verejná cesta: a-z0-9 a vnútorné spojovníky, 1–64 |
--name <label> |
Súkromný štítok |
--tag <tag> |
Opakovateľný. Malé písmená, bez čiarok. Max. 20 |
--starts <when> |
Spustí sa po 7d, 24h, 30m alebo k dátumu ISO |
--password <secret> |
Na otvorenie vyžaduje toto heslo |
--expires <when> |
Prestane sa poskytovať po 7d, 24h, 30m alebo k dátumu ISO |
--max-openings <n> |
Po tomto počte otvorení sa pozastaví. Ak ho vynecháte, počet je neobmedzený |
--domain <host> |
Poskytuje sa na tomto hostiteľovi namiesto lida.sh |
--in <folder-id> |
Vytvorí v tomto priečinku (iba create; --in-domain <host>, ak sa slug priečinka opakuje) |
--status <active|paused> |
Pozastaví alebo obnoví (iba update) |
--sticky / --no-sticky |
Vracajúci sa návštevník dostane ten istý variant (predvolene sticky) |
--restart-split |
Znova premieša sticky priradenia (iba update) |
--forward-params / --no-forward-params |
Pripojí query string návštevníka k URL variantom (predvolene vypnuté). Pozrite Preposielanie parametrov dopytu |
--variant <name> |
Začne blok variantu (iba create). Pozrite Varianty |
--weight <n> --when <key=v1,v2> |
Pre každý variant zvlášť. Pozrite Varianty a Pravidlá pre parametre dopytu |
--preview-name <text> |
Verejný názov v náhľade odkazu |
--preview-description <text> |
Verejný popis v náhľade odkazu |
--preview-image <path> |
Verejný obrázok v náhľade odkazu |
--utm-source --utm-medium --utm-campaign --utm-term --utm-content |
Iba odkazy na URL |
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings |
Iba update |
--status prijíma iba active alebo paused. Stav expired vyplýva z --expires. Stav scheduled vyplýva z --starts. Verejné rozlíšenie vracia až do spustenia not-found. Po dosiahnutí --max-openings sa odkaz pozastaví; ak ho chcete znova poskytovať, zvýšte počet alebo použite --clear-max-openings. Už využité otvorenia zostávajú započítané, kým limit nezmeníte alebo neodstránite.
Slugy na lida.sh sú spoločné pre všetkých. Ak je slovo obsadené, pridajte vlastnú doménu a skúste to znova s --domain. Odkaz na vlastnej doméne sa zároveň nezverejní na lida.sh.
Príznaky pre výpis
Vypíše jednu stránku {items, cursor}: --limit je 1-100 (predvolene 50); zadávajte --cursor s hodnotou cursor z predchádzajúcej stránky, kým nie je null. Stránka môže obsahovať menej položiek než --limit, ak filter niektoré preskočí. --q hľadá celé slová, pričom posledné sa berie ako predpona (laun nájde example.com/launch), a výsledky radí podľa relevancie; --in vypíše jeden priečinok, najprv priečinky; inak sa radí od najnovších.
| Príznak | Poznámky |
|---|---|
--limit <n> |
Položky na stránku, 1-100 (predvolene 50) |
--cursor <c> |
cursor z predchádzajúcej stránky |
--q <text> |
Hľadá slová v názve, slugu, názvoch a cieľoch variantov, názvoch súborov, texte úryvkov a štítkoch |
--tag <tag> |
Filtruje podľa štítka |
--kind <url|file|text|folder|group> |
Filtruje podľa druhu (group = viacero variantov) |
--status <status> |
active, paused, expired, scheduled alebo mixed |
--in <folder-id|root> |
Iba to, čo je priamo v tomto priečinku alebo na najvyššej úrovni. Bez neho sa vypíše všetko |
Varianty
Každý odkaz je kontajner pre jeden alebo viac variantov. Variant tvorí obsah (URL, súbor alebo text) plus jeho vlastné obmedzenia (--password, --starts, --expires, --max-openings), --weight a voliteľné podmienky pre návštevníka (--when). Bez --variant má odkaz jeden variant s názvom main a každý vyššie uvedený príkaz je preň skratkou. Návštevník dostane jeden variant: varianty, ktorých --when sa zhoduje, tvoria výberovú skupinu (ak sa nezhoduje žiadny, tvoria ju varianty bez podmienok), z ktorej sa potom vyberá podľa váhy. Pri sticky priradení (predvolené) dostane vracajúci sa návštevník ten istý variant. Obmedzenia samotného odkazu majú prednosť pred obmedzeniami variantov. Názvy variantov: malé písmená, číslice, vnútorné spojovníky, 1–40 znakov, jedinečné v rámci odkazu. Max. 20 variantov.
Hodnota kind odkazu je pri jednom variante druh tohto variantu a pri viacerých group. Hodnota status odkazu je stav obmedzenia odkazu, ak je nastavené (paused, scheduled, expired), inak spoločný stav variantov, inak mixed. variantStatuses počíta {active, paused, expired, scheduled}.
Vytvorenie s blokmi variantov
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čína blok variantu. Príznaky za ním patria k tomuto variantu až po ďalší --variant: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (opakovateľný), --utm-*. Príznaky odkazu (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) patria pred prvý --variant.
Podpríkazy pre varianty
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> prijíma jedno z --url, --file, --text, plus príznaky obmedzení, --weight, --when, --utm-*. variants update <id> <name> prijíma --name <new>, obsah, príznaky obmedzení, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires, --clear-max-openings. Odkaz si vždy ponechá aspoň jeden variant.
Kľúče --when
| Kľúč | 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 |
zhoda predpony (de, en-us) |
referrer |
referrerHosts |
prípona hostiteľa (twitter.com) |
Každý nastavený kľúč sa musí zhodovať. --when country=DE,AT --when device=mobile zodpovedá { "countries": ["DE","AT"], "devices": ["mobile"] }.
Pravidlá pre parametre dopytu
--when prijíma aj pravidlá param: pre query string návštevníka (lida.sh/promo?src=newsletter). Kľúče rozlišujú veľké a malé písmená, hodnoty sa porovnávajú presne, max. 10 pravidiel na variant. Čiarky rozdeľujú --when, takže hodnota parametra nemôže obsahovať čiarku; pre zoznamy použite |.
| Syntax | op v JSON |
Zhoduje sa, keď |
|---|---|---|
param:KEY=VALUE |
equals |
hodnota je presne VALUE |
param:KEY!=VALUE |
notEquals |
hodnota sa líši alebo kľúč chýba |
param:KEY~=VALUE |
includes |
hodnota obsahuje VALUE |
param:KEY^=VALUE |
startsWith |
hodnota začína na VALUE |
param:KEY$=VALUE |
endsWith |
hodnota končí na VALUE |
param:KEY=v1|v2 |
in |
hodnota je jednou zo zoznamu |
param:KEY? or param:KEY |
exists |
kľúč je prítomný |
param:!KEY |
missing |
kľúč chýba |
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" }] } (pri exists / missing sa value vynecháva). Hodnoty parametrov sa porovnávajú v čase otvorenia a nikdy sa neukladajú do analytiky.
Preposielanie parametrov dopytu
--forward-params / --no-forward-params pri links create a links update (na úrovni odkazu, predvolene vypnuté) pripája celý query string návštevníka k URL variantom: lida.sh/promo?src=nl otvorí https://example.com/?src=nl. Hodnoty od návštevníka prepíšu uložené hodnoty vrátane --utm-*. Varianty so súborom a textom toto nastavenie ignorujú. Ide o smerovanie, nie o riadenie prístupu: parametre môže pridať ktokoľvek. Hodnoty parametrov sa neukladajú do analytiky. links get toto nastavenie zobrazuje ako forwardParams.
Sticky priradenie a reštart rozdelenia
links update <id> --sticky / --no-sticky určuje, či vracajúci sa návštevník dostane ten istý variant. links update <id> --restart-split znova premieša sticky priradenia. Príznaky obsahu pri links update fungujú iba pre odkazy s jedným variantom; inak použite links variants update <id> <name>.
Priečinky
Priečinok je odkaz, ktorý zobrazuje zoznam položiek, ktoré doň vložíte. Ako funguje verejná stránka a prístup, nájdete v časti Priečinky.
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ázov priečinka (nie --name) a prijíma --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* a --in. Nedá sa kombinovať s --url, --file, --text ani --variant. links move vypíše {id, folder}. links copy zachová úroveň prístupu, ale kópia dostane novú URL na zdieľanie; ľudia sa nekopírujú. links delete pri priečinku presunie jeho položky o úroveň vyššie; --with-contents ich tiež odstráni. Riadky z list, get a create obsahujú folder (slug priečinka, v ktorom sa položka nachádza, alebo null); riadky priečinkov obsahujú aj items.
Prístup a zdieľanie
Nové odkazy a priečinky sú restricted: ich url je https://linkdash.dev/s/<token>, ktorú môžete otvoriť iba vy a ľudia, s ktorými ju zdieľate, a to po prihlásení. --access link sprístupní túto URL každému, kto ju má. --access public poskytuje odkaz na jeho krátkej URL (lida.sh/<slug> alebo na vašej vlastnej doméne). Pre odkazy, ktoré zverejňujete, použite --access public. Slug zostáva id pre všetky príkazy a jeho krátka URL zostáva rezervovaná, kým odkaz nie je verejný. Celý model nájdete v časti Zdieľanie a prí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
| Prí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}, od naposledy zdieľaných |
links shared |
{items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, od najnovší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> (alebo links update <id> --reset-share-link) |
{id, access, url} |
--role editor urobí z niekoho editora: môže meniť položku a vidieť jej štatistiky, ale nie heslá, slug, doménu, prístup ani zdieľanie, položku nemôže odstrániť, presunúť ani kopírovať a cieľ chránený heslom musí najprv odomknúť cez links unlock (na 30 minút). Editori používajú _id alebo URL na zdieľanie z links shared. Všetky príkazy prijímajú --domain <host>, ak sa slug opakuje. url vo výstupe create, get, list, update, copy a share je URL na zdieľanie, pokiaľ odkaz nie je verejný; vtedy je to krátka URL. Riadky obsahujú access. Najviac 200 ľudí na položku, 50 e-mailov na jedno volanie, 100 e-mailov s pozvánkou na účet za deň. Oba zoznamy vypisujú jednu stránku: --limit je 1-100 (predvolene 50); zadávajte --cursor z predchádzajúcej stránky, kým cursor nie je null. links leave prijíma _id alebo url z links shared; prístup cez zdieľaný nadradený priečinok zostáva zachovaný. Zdieľanie, zrušenie zdieľania, zmena prístupu a reset sa rátajú každé ako jedna udalosť; opustenie nie.
Štatistiky
linkdash links stats <id> --last 24h
--last je trvanie (24h, 7d). Predvolene 24h. JSON obsahuje visits, downloads, plays, visitsInLast, countries, referrers, variants (súčty za jednotlivé varianty), visitors (každý s variant) a crawlers ([{crawler, company, category, hits, lastSeen}]: boty a náhľady odkazov, ktoré odkaz načítali; nikdy sa nerátajú ako návštevy).
CSV
Stĺpce: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Jeden riadok na variant. kind, status, url, text, fileName, weight a when (reťazec JSON) sa viažu na variant; ostatné stĺpce sa viažu na odkaz a opakujú sa. folder je slug priečinka, v ktorom sa odkaz nachádza. access je restricted, link alebo public. Bez hesiel, tokenov na zdieľanie a ľudí.
linkdash links export > links.csv
linkdash links import links.csv
Import zoskupuje riadky podľa slugu a domény. Prvý riadok vytvorí odkaz s jeho variantom; ďalšie riadky pridajú varianty. Pri existujúcom odkaze prvý riadok aktualizuje polia odkazu a potom každý riadok aktualizuje variant podľa názvu, ak existuje, inak ho pridá. Riadky so súbormi bez obsahu sa preskočia s chybou pre daný riadok. Riadky s kind = folder (s hodnotou name) vytvoria priečinky; stĺpec folder umiestni každý odkaz do jeho priečinka, keď už existujú všetky riadky. Prázdne access nastaví nové odkazy ako obmedzené a existujúce odkazy ponechá bez zmeny.
Prí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
Pozrite aj priečinky, zdieľanie a prístup, webhooky a vlastné domény.

