CLI
Installera linkdash-cli från npm och kör sedan kommandot `linkdash`. Lyckade kommandon skriver JSON till stdout. Hjälp och fel skrivs som vanlig text till stderr.
npm i -g linkdash-cli
# or: pnpm add -g linkdash-cli / bun add -g linkdash-cli / npx linkdash-cli@latest
npm-paketet heter linkdash-cli. Kommandot heter linkdash.
Motsvarighet över HTTP: HTTP API. MCP: MCP. Agent-skill: Agent skill. Priser: Priser. Ren markdown: cli.md.
Det finns ingen --json-flagga. Vid fel blir exitkoden 1.
Autentisering
linkdash auth create
linkdash auth login
linkdash auth whoami
linkdash auth logout
Har du inget konto än? auth create öppnar https://linkdash.dev/sign-up och skickar dig sedan tillbaka till https://linkdash.dev/device med CLI-koden så att du kan godkänna. Har du redan ett konto? auth login öppnar /device. Utan webbläsare: sätt LINKDASH_TOKEN till en sessionstoken från auth create eller auth login. Hitta inte på tokens.
Sessionsfil: ~/.config/linkdash/config.json (läge 0600).
CLI kan inte ändra e-post, lösenord eller fakturering. Hänvisa användaren till dashboarden. API-nycklar (HTTP och MCP): API-nycklar.
Kommandon
linkdash <command> [options]
| Kommando | Vad det gör |
|---|---|
auth create |
Registrering i webbläsaren, sedan godkännande av enheten |
auth login |
Enhetsinloggning i webbläsaren |
auth logout |
Glömmer den sparade sessionen |
auth whoami |
JSON för det inloggade kontot |
links list |
Listar länkar och mappar, en sida i taget (--limit, --cursor) |
links get <id> |
En länk |
links create --url <url> |
Kortlänk från en URL |
links create --file <path> |
Ladda upp en fil och få en länk |
links create --text <text> |
Spara ett textutdrag |
links create --folder <name> |
Skapa en mapp |
links create --variant <name> … |
Länk med flera varianter (split / targeting) |
links update <id> |
Ändra destination, fil, lösenord, utgångstid, domän, status, sticky eller vidarebefordrade parametrar |
links move <id> --in <folder-id> |
Lägg en länk eller mapp i en mapp (--root för toppnivån) |
links copy <id> |
Gör en kopia med en ny slug, i samma mapp |
links delete <id> |
Ta bort en länk (en mapps innehåll flyttas upp en nivå; --with-contents tar bort det) |
links share <id> --email <email> |
Dela med personer via e-post (upprepa --email; --role editor låter dem ändra den; varje ny person får ett inbjudningsmejl) |
links unshare <id> --email <email> |
Ta bort någons åtkomst |
links shares [id] |
Vilka utöver du som kan öppna den, även via en mapp ovanför. Utan id: allt du har bjudit in personer till, en sida i taget (--limit, --cursor) |
links shared |
Det som andra har delat med dig, en sida i taget (--limit, --cursor) |
links leave <_id | share URL> |
Lämna något som delats med dig |
links role <id> --email <e> --role viewer|editor |
Gör någon du har bjudit in till läsare eller redigerare |
links unlock <_id | share URL> |
Ange lösenordet för ett delat objekt för att se och redigera dess mål i 30 minuter |
links activity <id> |
Vem som ändrade ett objekt och hur |
links reset-link <id> |
Ny delnings-URL; den gamla linkdash.dev/s/-URL slutar fungera |
links stats <id> |
Totalt antal besök, nedladdningar och uppspelningar, även per variant, plus crawlers |
links export |
Skriver ut alla länkar som CSV (en rad per variant) |
links import <file> |
Importera URL- och textrader från CSV |
links variants list <id> |
En länks varianter |
links variants add <id> --name <n> |
Lägg till en variant |
links variants update <id> <name> |
Ändra en variant |
links variants remove <id> <name> |
Ta bort en variant |
webhooks list |
Listar webhook-endpoints (hemligheten maskerad) |
webhooks get <id> |
Visar en webhook-URL (hemligheten maskerad) |
webhooks create --url <https> |
Lägg till en HTTPS-endpoint (hemligheten visas en gång) |
webhooks rotate <id> |
Utfärda en ny signeringshemlighet |
webhooks delete <id> |
Ta bort en webhook |
domains list |
Listar egna värdnamn |
domains add <host> |
Lägg till ett värdnamn (1 på Free) |
domains connect <host> |
Domain Connect-URL för att tillämpa, eller null |
domains verify <host> |
Kontrollera DNS med Unkey |
domains remove <host> |
Ta bort ett värdnamn |
-h, --help |
Hjälp (vanlig text) |
-v, --version |
Version |
Om samma slug finns på två av ägarens domäner anger du --domain.
Flaggor för create och update
Slug är länkens id, och dess publika sökväg när länken är publik. Namnet syns bara för dig. Nya länkar är begränsade (se Åtkomst och delning). Create tar exakt en av --url, --file eller --text (den blir varianten main), --variant-block (se Varianter) eller --folder <name> (se Mappar).
| Flagga | Anteckningar |
|---|---|
--url <url> |
Destinations-URL |
--file <path> |
Fil att ladda upp (vid create, eller för att ersätta innehållet vid update) |
--text <text> |
Textutdrag |
--access <restricted|link|public> |
Vem som kan öppna den. Standard är restricted. Se Åtkomst och delning |
--reset-share-link |
Utfärda en ny delnings-URL (endast update) |
--slug <id> |
Publik sökväg: a-z0-9 och bindestreck inuti, 1–64 |
--name <label> |
Privat etikett |
--tag <tag> |
Kan upprepas. Gemener, inga kommatecken. Max 20 |
--starts <when> |
Gå live efter 7d, 24h, 30m eller ett ISO-datum |
--password <secret> |
Kräv det här lösenordet för att öppna |
--expires <when> |
Sluta servera efter 7d, 24h, 30m eller ett ISO-datum |
--max-openings <n> |
Pausa efter så här många öppningar. Utelämna för obegränsat |
--domain <host> |
Servera på den här värden i stället för lida.sh |
--in <folder-id> |
Skapa inuti den här mappen (endast create; --in-domain <host> om mappens slug förekommer flera gånger) |
--status <active|paused> |
Pausa eller återuppta (endast update) |
--sticky / --no-sticky |
En återkommande besökare behåller samma variant (standard är sticky) |
--restart-split |
Blanda om sticky-tilldelningarna (endast update) |
--forward-params / --no-forward-params |
Lägg till besökarens query string på URL-varianter (av som standard). Se Vidarebefordra query-parametrar |
--variant <name> |
Starta ett variantblock (endast create). Se Varianter |
--weight <n> --when <key=v1,v2> |
Per variant. Se Varianter och Regler för query-parametrar |
--preview-name <text> |
Publikt namn i förhandsvisningen |
--preview-description <text> |
Publik beskrivning i förhandsvisningen |
--preview-image <path> |
Publik bild i förhandsvisningen |
--utm-source --utm-medium --utm-campaign --utm-term --utm-content |
Endast URL-länkar |
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings |
Endast update |
--status accepterar bara active eller paused. Expired kommer från --expires. Scheduled kommer från --starts. Publik uppslagning ger not-found fram till starten. När --max-openings har nåtts pausas länken; höj antalet, eller använd --clear-max-openings, för att servera den igen. Öppningar som redan har använts räknas tills du ändrar eller tar bort gränsen.
Slugs på lida.sh är gemensamma. Om ett ord är upptaget lägger du till en egen domän och försöker igen med --domain. En länk på en egen domän publiceras inte också på lida.sh.
Flaggor för list
Skriver ut en sida, {items, cursor}: --limit är 1-100 (standard 50); skicka --cursor med cursor från föregående sida tills den är null. En sida kan innehålla färre objekt än --limit när ett filter hoppar över några. --q matchar hela ord, där det sista ordet räknas som prefix (laun hittar example.com/launch), sorterat efter relevans; --in listar en mapp, mappar först; annars nyast först.
| Flagga | Anteckningar |
|---|---|
--limit <n> |
Objekt per sida, 1-100 (standard 50) |
--cursor <c> |
cursor från föregående sida |
--q <text> |
Sök efter ord i namn, slug, variantnamn och mål, filnamn, text i utdrag och taggar |
--tag <tag> |
Filtrera på tagg |
--kind <url|file|text|folder|group> |
Filtrera på typ (group = flera varianter) |
--status <status> |
active, paused, expired, scheduled eller mixed |
--in <folder-id|root> |
Bara det som ligger direkt i den här mappen, eller på toppnivån. Utan den listas allt |
Varianter
Varje länk är en behållare för en eller flera varianter. En variant är innehållet (URL, fil eller text) plus en egen spärr (--password, --starts, --expires, --max-openings), en --weight och valfria villkor för besökaren (--when). Utan --variant har en länk en variant som heter main, och alla kommandon ovan är förkortningar för den. En besökare får en variant: varianter vars --when matchar bildar urvalet (om ingen matchar används de villkorslösa varianterna), och sedan görs ett viktat val. Med sticky-tilldelning (standard) behåller en återkommande besökare samma variant. Länkens egen spärr går före variantens spärrar. Variantnamn: gemener, siffror, bindestreck inuti, 1–40 tecken, unika per länk. Max 20 varianter.
Länkens kind är variantens typ när det finns en variant och group när det finns flera. Länkens status är länkspärren när den är satt (paused, scheduled, expired), annars den gemensamma variantstatusen, annars mixed. variantStatuses räknar {active, paused, expired, scheduled}.
Skapa med variantblock
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> startar ett variantblock. Flaggor efter den hör till den varianten fram till nästa --variant: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (kan upprepas), --utm-*. Länkflaggor (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) ska stå före första --variant.
Underkommandon för varianter
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> tar en av --url, --file, --text, plus spärrflaggor, --weight, --when, --utm-*. variants update <id> <name> tar --name <new>, innehåll, spärrflaggor, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires, --clear-max-openings. En länk har alltid minst en variant kvar.
Nycklar för --when
| Nyckel | JSON-fält | Värden |
|---|---|---|
country |
countries |
ISO-2-koder (DE, AT) |
device |
devices |
mobile tablet desktop |
os |
os |
windows macos android ios linux other |
browser |
browsers |
edge chrome firefox safari other |
language |
languages |
prefixmatchning (de, en-us) |
referrer |
referrerHosts |
suffix på värdnamnet (twitter.com) |
Alla angivna nycklar måste matcha. --when country=DE,AT --when device=mobile blir { "countries": ["DE","AT"], "devices": ["mobile"] }.
Regler för query-parametrar
--when tar också param:-regler för besökarens query string (lida.sh/promo?src=newsletter). Nycklar är skiftlägeskänsliga, värden jämförs exakt, max 10 regler per variant. Kommatecken delar upp --when, så ett parametervärde kan inte innehålla kommatecken; använd | för listor.
| Syntax | JSON op |
Matchar när |
|---|---|---|
param:KEY=VALUE |
equals |
värdet är exakt VALUE |
param:KEY!=VALUE |
notEquals |
värdet skiljer sig, eller nyckeln saknas |
param:KEY~=VALUE |
includes |
värdet innehåller VALUE |
param:KEY^=VALUE |
startsWith |
värdet börjar med VALUE |
param:KEY$=VALUE |
endsWith |
värdet slutar med VALUE |
param:KEY=v1|v2 |
in |
värdet är ett av dem i listan |
param:KEY? eller param:KEY |
exists |
nyckeln finns |
param:!KEY |
missing |
nyckeln saknas |
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-format: "when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] } (value utelämnas för exists / missing). Parametervärden matchas när länken öppnas och sparas aldrig i statistiken.
Vidarebefordra query-parametrar
--forward-params / --no-forward-params på links create och links update (på länknivå, av som standard) lägger till besökarens hela query string på URL-varianter: lida.sh/promo?src=nl öppnar https://example.com/?src=nl. Besökarens värden går före sparade värden, även --utm-*. Fil- och textvarianter ignorerar det. Det här är routing, inte åtkomstkontroll: vem som helst kan lägga till parametrar. Parametervärden sparas inte i statistiken. links get visar det som forwardParams.
Sticky och omstart av split
links update <id> --sticky / --no-sticky styr om en återkommande besökare behåller samma variant. links update <id> --restart-split blandar om sticky-tilldelningarna. Innehållsflaggor på links update fungerar bara för länkar med en variant; annars använder du links variants update <id> <name>.
Mappar
En mapp är en länk som listar objekten du lägger i den. Se Mappar för hur den publika sidan och åtkomsten fungerar.
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> sätter mappens namn (inte --name) och tar --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* och --in. Den kan inte kombineras med --url, --file, --text eller --variant. links move skriver ut {id, folder}. links copy behåller åtkomstnivån men får en ny delnings-URL; personer kopieras inte. links delete på en mapp flyttar dess objekt upp en nivå; --with-contents tar bort dem också. Rader från list, get och create innehåller folder (slug för mappen som innehåller dem, eller null); mapprader innehåller också items.
Åtkomst och delning
Nya länkar och mappar är restricted: deras url är https://linkdash.dev/s/<token>, som bara du och de du delar med kan öppna, inloggade. --access link öppnar den URL för alla som har den. --access public serverar länken på dess korta URL (lida.sh/<slug> eller din egen domän). Använd --access public för länkar som du publicerar öppet. Slugen är fortfarande id för alla kommandon, och dess korta URL är reserverad så länge länken inte är publik. Se Delning och åtkomst för hela modellen.
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
| Kommando | Skriver ut |
|---|---|
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 (utan id) |
{items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}, senast delade först |
links shared |
{items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, nyast först |
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> (eller links update <id> --reset-share-link) |
{id, access, url} |
--role editor gör någon till redigerare: de kan ändra objektet och se dess statistik, men inte lösenord, slug, domän, åtkomst eller delning, och inte heller ta bort, flytta eller kopiera. Ett lösenordsskyddat mål kräver links unlock först (30 minuter). Redigerare använder _id eller delnings-URL från links shared. Alla tar --domain <host> när slugen förekommer flera gånger. url i utdata från create, get, list, update, copy och share är delnings-URL, utom när länken är publik, då är det den korta URL; raderna innehåller access. Upp till 200 personer per objekt, 50 e-postadresser per anrop, 100 inbjudningsmejl per konto och dag. De två listorna skriver ut en sida: --limit är 1-100 (standard 50); skicka --cursor från föregående sida tills cursor är null. links leave tar _id eller url från links shared; åtkomst via en delad mapp ovanför finns kvar. Delning, borttagen delning, en ändrad åtkomst och en återställning räknas var och en som en händelse; att lämna gör det inte.
Statistik
linkdash links stats <id> --last 24h
--last är en tidsperiod (24h, 7d). Standard är 24h. JSON innehåller visits, downloads, plays, visitsInLast, countries, referrers, variants (totaler per variant), visitors (var och en med variant) och crawlers ([{crawler, company, category, hits, lastSeen}]: botar och länkförhandsvisningar som hämtade länken, räknas aldrig som besök).
CSV
Kolumner: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. En rad per variant. kind, status, url, text, fileName, weight och when (JSON-sträng) gäller per variant; resten gäller per länk och upprepas. folder är slugen för mappen som länken ligger i. access är restricted, link eller public. Inga lösenord, delningstokens eller personer.
linkdash links export > links.csv
linkdash links import links.csv
Importen grupperar rader efter slug + domän. Den första raden skapar länken med sin variant; fler rader lägger till varianter. För en befintlig länk uppdaterar den första raden länkfälten, och sedan uppdaterar varje rad varianten med samma namn om den finns, annars läggs den till. Filrader utan innehåll hoppas över med ett fel för den raden. Rader med kind = folder (med ett name) skapar mappar; kolumnen folder placerar varje länk i sin mapp när alla rader finns. Ett tomt access gör nya länkar begränsade och lämnar befintliga länkar som de är.
Exempel
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
Se även mappar, delning och åtkomst, webhooks och egna domäner.

