CLI
Installeer linkdash-cli via npm en voer daarna het `linkdash`-commando uit. Geslaagde commando's printen JSON op stdout. Help en fouten zijn platte tekst op stderr.
npm i -g linkdash-cli
# or: pnpm add -g linkdash-cli / bun add -g linkdash-cli / npx linkdash-cli@latest
Het npm-pakket heet linkdash-cli. Het commando is linkdash.
HTTP-equivalent: HTTP API. MCP: MCP. Agent-skill: Agent-skill. Prijzen: Prijzen. Platte markdown: cli.md.
Er is geen --json-flag. Bij fouten is de exitcode 1.
Auth
linkdash auth create
linkdash auth login
linkdash auth whoami
linkdash auth logout
Nog geen account? auth create opent https://linkdash.dev/sign-up en brengt je daarna terug naar https://linkdash.dev/device met de CLI-code, zodat je kunt goedkeuren. Heb je al een account? auth login opent /device. Headless: zet LINKDASH_TOKEN op een sessietoken uit auth create of auth login. Verzin geen tokens.
Sessiebestand: ~/.config/linkdash/config.json (mode 0600).
De CLI kan geen e-mailadres, wachtwoord of facturering wijzigen. Stuur de gebruiker daarvoor naar het dashboard. API-sleutels (HTTP en MCP): API-sleutels.
Commando’s
linkdash <command> [options]
| Commando | Wat het doet |
|---|---|
auth create |
Registratie in de browser, daarna goedkeuring van het apparaat |
auth login |
Apparaatlogin via de browser |
auth logout |
De opgeslagen sessie vergeten |
auth whoami |
JSON van het ingelogde account |
links list |
Links en mappen weergeven, één pagina per keer (--limit, --cursor) |
links get <id> |
Eén link |
links create --url <url> |
Korte link van een URL |
links create --file <path> |
Een bestand uploaden en een link krijgen |
links create --text <text> |
Een snippet opslaan |
links create --folder <name> |
Een map maken |
links create --variant <name> … |
Link met meerdere varianten (split / targeting) |
links update <id> |
Bestemming, bestand, wachtwoord, verloopdatum, domein, status, sticky of doorgestuurde parameters wijzigen |
links move <id> --in <folder-id> |
Een link of map in een map plaatsen (--root voor het hoogste niveau) |
links copy <id> |
Een kopie maken met een nieuwe slug, in dezelfde map |
links delete <id> |
Een link verwijderen (de items van een map gaan een niveau omhoog; --with-contents verwijdert ze) |
links share <id> --email <email> |
Met mensen delen via e-mail (herhaal --email; met --role editor kunnen ze het wijzigen; elke nieuwe persoon krijgt een uitnodigingsmail) |
links unshare <id> --email <email> |
Iemands toegang intrekken |
links shares [id] |
Wie het naast jou kan openen, ook via een bovenliggende map. Zonder id: alles waarvoor je mensen hebt uitgenodigd, één pagina per keer (--limit, --cursor) |
links shared |
Wat anderen met je hebben gedeeld, één pagina per keer (--limit, --cursor) |
links leave <_id | share URL> |
Afstand doen van iets dat met je is gedeeld |
links role <id> --email <e> --role viewer|editor |
Iemand die je hebt uitgenodigd viewer of editor maken |
links unlock <_id | share URL> |
Het wachtwoord van een gedeeld item invoeren om het doel 30 minuten te kunnen zien en bewerken |
links activity <id> |
Wie een item heeft gewijzigd en hoe |
links reset-link <id> |
Nieuwe deel-URL; de oude linkdash.dev/s/-URL werkt niet meer |
links stats <id> |
Totalen voor bezoeken, downloads en keren afgespeeld, ook per variant, plus crawlers |
links export |
Alle links als CSV printen (één rij per variant) |
links import <file> |
URL- en tekstrijen uit CSV importeren |
links variants list <id> |
Varianten van een link |
links variants add <id> --name <n> |
Een variant toevoegen |
links variants update <id> <name> |
Een variant wijzigen |
links variants remove <id> <name> |
Een variant verwijderen |
webhooks list |
Webhook-endpoints weergeven (secret gemaskeerd) |
webhooks get <id> |
Eén webhook-URL tonen (secret gemaskeerd) |
webhooks create --url <https> |
Een HTTPS-endpoint toevoegen (secret wordt één keer getoond) |
webhooks rotate <id> |
Een nieuw signing secret uitgeven |
webhooks delete <id> |
Een webhook verwijderen |
domains list |
Eigen hostnamen weergeven |
domains add <host> |
Een hostnaam toevoegen (1 op Free) |
domains connect <host> |
Domain Connect-apply-URL, of null |
domains verify <host> |
DNS controleren met Unkey |
domains remove <host> |
Een hostnaam verwijderen |
-h, --help |
Help (platte tekst) |
-v, --version |
Versie |
Bestaat dezelfde slug op twee domeinen van de eigenaar, geef dan --domain mee.
Flags voor create en update
De slug is de id van de link, en het openbare pad als de link openbaar is. De naam is alleen voor jou zichtbaar. Nieuwe links zijn beperkt (zie Toegang en delen). Create accepteert precies één van --url, --file of --text (dat wordt de variant main), --variant-blokken (zie Varianten) of --folder <name> (zie Mappen).
| Flag | Opmerkingen |
|---|---|
--url <url> |
Bestemmings-URL |
--file <path> |
Te uploaden bestand (bij create, of vervangt de bytes bij update) |
--text <text> |
Snippet |
--access <restricted|link|public> |
Wie het kan openen. Standaard restricted. Zie Toegang en delen |
--reset-share-link |
Een nieuwe deel-URL uitgeven (alleen update) |
--slug <id> |
Openbaar pad: a-z0-9 en koppeltekens binnenin, 1–64 |
--name <label> |
Privélabel |
--tag <tag> |
Herhaalbaar. Kleine letters, geen komma’s. Max. 20 |
--starts <when> |
Live gaan na 7d, 24h, 30m of op een ISO-datum |
--password <secret> |
Dit wachtwoord vereisen om te openen |
--expires <when> |
Stoppen met serveren na 7d, 24h, 30m of op een ISO-datum |
--max-openings <n> |
Pauzeren na zoveel keer openen. Laat weg voor onbeperkt |
--domain <host> |
Op deze host serveren in plaats van lida.sh |
--in <folder-id> |
In deze map aanmaken (alleen create; --in-domain <host> als de map-slug vaker voorkomt) |
--status <active|paused> |
Pauzeren of hervatten (alleen update) |
--sticky / --no-sticky |
Terugkerende bezoeker houdt dezelfde variant (standaard sticky) |
--restart-split |
Sticky toewijzingen opnieuw verdelen (alleen update) |
--forward-params / --no-forward-params |
De querystring van de bezoeker toevoegen aan URL-varianten (standaard uit). Zie Queryparameters doorsturen |
--variant <name> |
Een variantblok starten (alleen create). Zie Varianten |
--weight <n> --when <key=v1,v2> |
Per variant. Zie Varianten en Regels voor queryparameters |
--preview-name <text> |
Openbare naam voor de linkpreview |
--preview-description <text> |
Openbare beschrijving voor de linkpreview |
--preview-image <path> |
Openbare afbeelding voor de linkpreview |
--utm-source --utm-medium --utm-campaign --utm-term --utm-content |
Alleen URL-links |
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings |
Alleen update |
--status accepteert alleen active of paused. Verlopen volgt uit --expires. Gepland volgt uit --starts. Openbaar resolven geeft not-found tot de starttijd. Zodra --max-openings is bereikt, pauzeert de link; verhoog het aantal, of gebruik --clear-max-openings, om hem weer te serveren. Openingen die al gebruikt zijn, blijven meetellen totdat je de limiet wijzigt of verwijdert.
lida.sh-slugs worden gedeeld. Is een woord al bezet, voeg dan een eigen domein toe en probeer het opnieuw met --domain. Een link op een eigen domein wordt niet ook op lida.sh gepubliceerd.
Flags voor list
Print één pagina, {items, cursor}: --limit is 1-100 (standaard 50); geef --cursor mee met de cursor van de vorige pagina, totdat die null is. Een pagina kan minder items bevatten dan --limit als een filter er een paar overslaat. --q matcht hele woorden, waarbij het laatste woord als prefix telt (laun vindt example.com/launch), gerangschikt op relevantie; --in toont één map, met mappen eerst; anders staat het nieuwste bovenaan.
| Flag | Opmerkingen |
|---|---|
--limit <n> |
Items per pagina, 1-100 (standaard 50) |
--cursor <c> |
De cursor van de vorige pagina |
--q <text> |
Zoekt woorden in de naam, slug, variantnamen en -doelen, bestandsnamen, snippettekst en tags |
--tag <tag> |
Filteren op tag |
--kind <url|file|text|folder|group> |
Filteren op soort (group = meerdere varianten) |
--status <status> |
active, paused, expired, scheduled of mixed |
--in <folder-id|root> |
Alleen wat direct in deze map staat, of op het hoogste niveau. Zonder deze flag wordt alles weergegeven |
Varianten
Elke link is een container met een of meer varianten. Een variant is de content (URL, bestand of tekst) plus een eigen gate (--password, --starts, --expires, --max-openings), een --weight en optionele voorwaarden voor bezoekers (--when). Zonder --variant heeft een link één variant met de naam main, en elk commando hierboven is daar een afkorting voor. Een bezoeker krijgt één variant: de varianten waarvan --when matcht vormen de pool (matcht er geen, dan vormen de onvoorwaardelijke varianten de pool), en daaruit volgt een gewogen keuze. Met sticky toewijzing (standaard) houdt een terugkerende bezoeker dezelfde variant. De gate van de link zelf gaat voor op de gates van varianten. Variantnamen: kleine letters, cijfers, koppeltekens binnenin, 1–40 tekens, uniek per link. Max. 20 varianten.
De kind van een link is bij één variant de soort van die variant, en bij meerdere varianten group. De status van een link is de linkgate als die is ingesteld (paused, scheduled, expired), anders de gezamenlijke status van de varianten, anders mixed. variantStatuses telt {active, paused, expired, scheduled}.
Aanmaken met variantblokken
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> start een variantblok. Flags daarna horen bij die variant tot de volgende --variant: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (herhaalbaar), --utm-*. Linkflags (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) komen vóór de eerste --variant.
Variant-subcommando’s
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> accepteert één van --url, --file of --text, plus gateflags, --weight, --when en --utm-*. variants update <id> <name> accepteert --name <new>, content, gateflags, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires en --clear-max-openings. Een link houdt altijd minstens één variant.
--when-keys
| Key | JSON-veld | Waarden |
|---|---|---|
country |
countries |
ISO-2-codes (DE, AT) |
device |
devices |
mobile tablet desktop |
os |
os |
windows macos android ios linux other |
browser |
browsers |
edge chrome firefox safari other |
language |
languages |
prefix-match (de, en-us) |
referrer |
referrerHosts |
host-suffix (twitter.com) |
Elke ingestelde key moet matchen. --when country=DE,AT --when device=mobile wordt { "countries": ["DE","AT"], "devices": ["mobile"] }.
Regels voor queryparameters
--when accepteert ook param:-regels op de querystring van de bezoeker (lida.sh/promo?src=newsletter). Keys zijn hoofdlettergevoelig, waarden worden exact vergeleken, en je kunt max. 10 regels per variant gebruiken. Komma’s splitsen --when, dus een parameterwaarde kan geen komma bevatten; gebruik | voor lijsten.
| Syntaxis | JSON-op |
Matcht als |
|---|---|---|
param:KEY=VALUE |
equals |
de waarde precies VALUE is |
param:KEY!=VALUE |
notEquals |
de waarde afwijkt, of de key ontbreekt |
param:KEY~=VALUE |
includes |
de waarde VALUE bevat |
param:KEY^=VALUE |
startsWith |
de waarde begint met VALUE |
param:KEY$=VALUE |
endsWith |
de waarde eindigt op VALUE |
param:KEY=v1|v2 |
in |
de waarde in de lijst staat |
param:KEY? of param:KEY |
exists |
de key aanwezig is |
param:!KEY |
missing |
de key ontbreekt |
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?"
JSON-vorm: "when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] } (value wordt weggelaten bij exists / missing). Parameterwaarden worden gematcht op het moment van openen en nooit opgeslagen in analytics.
Queryparameters doorsturen
--forward-params / --no-forward-params op links create en links update (op linkniveau, standaard uit) voegt de volledige querystring van de bezoeker toe aan URL-varianten: lida.sh/promo?src=nl opent https://example.com/?src=nl. Waarden van de bezoeker overschrijven opgeslagen waarden, ook die van --utm-*. Bestands- en tekstvarianten negeren deze instelling. Dit is routing, geen toegangscontrole: iedereen kan parameters toevoegen. Parameterwaarden worden niet opgeslagen in analytics. links get toont dit als forwardParams.
Sticky en split herstarten
links update <id> --sticky / --no-sticky bepaalt of een terugkerende bezoeker dezelfde variant houdt. links update <id> --restart-split verdeelt de sticky toewijzingen opnieuw. Contentflags op links update werken alleen voor links met één variant; gebruik anders links variants update <id> <name>.
Mappen
Een map is een link die de items toont die je erin zet. Zie Mappen voor hoe de openbare pagina en de toegang werken.
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> stelt de mapnaam in (niet --name) en accepteert --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* en --in. Je kunt het niet combineren met --url, --file, --text of --variant. links move print {id, folder}. links copy behoudt het toegangsniveau maar krijgt een nieuwe deel-URL; mensen worden niet meegekopieerd. links delete op een map verplaatst de items een niveau omhoog; met --with-contents worden ze ook verwijderd. Rijen van list, get en create bevatten folder (de slug van de map waarin het item staat, of null); maprijen bevatten ook items.
Toegang en delen
Nieuwe links en mappen zijn restricted: hun url is https://linkdash.dev/s/<token>, die alleen jij en de mensen met wie je deelt kunnen openen, mits ingelogd. Met --access link kan iedereen die de URL heeft hem openen. --access public serveert de link op zijn korte URL (lida.sh/<slug> of je eigen domein). Gebruik --access public voor links die je openbaar post. De slug blijft voor elk commando de id, en de korte URL blijft gereserveerd zolang de link niet openbaar is. Zie Delen en toegang voor het volledige model.
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
| Commando | |
|---|---|
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 (zonder id) |
{items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}, meest recent gedeeld eerst |
links shared |
{items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, nieuwste eerst |
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> (of links update <id> --reset-share-link) |
{id, access, url} |
--role editor maakt iemand editor: die kan het item wijzigen en de statistieken zien, maar niet aan wachtwoorden, slug, domein, toegang of delen komen, en ook niet verwijderen, verplaatsen of kopiëren. Voor een doel met een wachtwoord is eerst links unlock nodig (30 minuten). Editors gebruiken de _id of de deel-URL uit links shared. Al deze commando’s accepteren --domain <host> als de slug vaker voorkomt. url in de output van create, get, list, update, copy en share is de deel-URL, tenzij de link openbaar is; dan is het de korte URL. Rijen bevatten access. Maximaal 200 mensen per item, 50 e-mailadressen per aanroep en 100 uitnodigingsmails per account per dag. De twee lijsten printen één pagina: --limit is 1-100 (standaard 50); geef --cursor van de vorige pagina mee totdat cursor null is. links leave accepteert de _id of url uit links shared; toegang via een bovenliggende gedeelde map blijft bestaan. Delen, delen intrekken, een toegangswijziging en een reset tellen elk als één event; een item verlaten telt niet.
Statistieken
linkdash links stats <id> --last 24h
--last is een tijdsduur (24h, 7d). Standaard 24h. De JSON bevat visits, downloads, plays, visitsInLast, countries, referrers, variants (totalen per variant), visitors (elk met variant) en crawlers ([{crawler, company, category, hits, lastSeen}]: bots en linkpreviews die de link hebben opgehaald; die tellen nooit als bezoek).
CSV
Kolommen: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Eén rij per variant. kind, status, url, text, fileName, weight en when (JSON-string) gelden per variant; de rest geldt per link en wordt herhaald. folder is de slug van de map waarin de link staat. access is restricted, link of public. Geen wachtwoorden, deeltokens of mensen.
linkdash links export > links.csv
linkdash links import links.csv
Import groepeert rijen op slug + domein. De eerste rij maakt de link aan met zijn variant; volgende rijen voegen varianten toe. Bij een bestaande link werkt de eerste rij de linkvelden bij; daarna werkt elke rij de variant met die naam bij als die bestaat, en voegt hem anders toe. Bestandsrijen zonder bytes worden overgeslagen met een foutmelding per rij. Rijen met kind = folder (en een name) maken mappen aan; de kolom folder plaatst elke link in zijn map zodra alle rijen bestaan. Een lege access maakt nieuwe links beperkt en laat bestaande links ongewijzigd.
Voorbeelden
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
Zie ook mappen, delen en toegang, webhooks en eigen domeinen.

