---
title: CLI
description: >-
  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.
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
```

npm-paketet heter `linkdash-cli`. Kommandot heter `linkdash`.

Motsvarighet över HTTP: [HTTP API](/sv/api). MCP: [MCP](/sv/mcp). Agent-skill: [Agent skill](/sv/skill). Priser: [Priser](/sv/pricing). Ren markdown: [cli.md](https://linkdash.dev/cli.md).

Det finns ingen `--json`-flagga. Vid fel blir exitkoden 1.

## Autentisering

```bash
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:t kan inte ändra e-post, lösenord eller fakturering. Hänvisa användaren till [dashboarden](https://linkdash.dev/dashboard/billing). API-nycklar (HTTP och MCP): [API-nycklar](https://linkdash.dev/dashboard/keys).

## 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](/sv/folders) |
| `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](/sv/sharing) 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:en 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](#access-and-sharing)). Create tar **exakt en** av `--url`, `--file` eller `--text` (den blir varianten `main`), `--variant`-block (se [Varianter](#variants)) eller `--folder <name>` (se [Mappar](#folders)).

| 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](#access-and-sharing) |
| `--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](#forward-query-parameters) |
| `--variant <name>` | Starta ett variantblock (endast create). Se [Varianter](#variants) |
| `--weight <n>` `--when <key=v1,v2>` | Per variant. Se [Varianter](#variants) och [Regler för query-parametrar](#query-parameter-rules) |
| `--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](/sv/domains) 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

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

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

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

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](/sv/folders) för hur den publika sidan och åtkomsten fungerar.

```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>` 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:en 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:t för alla kommandon, och dess korta URL är reserverad så länge länken inte är publik. Se [Delning och åtkomst](/sv/sharing) för hela modellen.

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

| 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:en 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:en, utom när länken är publik, då är det den korta URL:en; 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

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

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

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

Se även [mappar](/sv/folders), [delning och åtkomst](/sv/sharing), [webhooks](/sv/webhooks) och [egna domäner](/sv/domains).
