---
title: CLI
description: >-
  Installer linkdash-cli fra npm, og kjør deretter `linkdash`-kommandoen.
  Vellykkede kommandoer skriver JSON til stdout. Hjelp og feil er ren tekst på
  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-pakken heter `linkdash-cli`. Kommandoen heter `linkdash`.

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

Det finnes ikke noe `--json`-flagg. Avslutningskoden er 1 ved feil.

## Autentisering

```bash
linkdash auth create
linkdash auth login
linkdash auth whoami
linkdash auth logout
```

Har du ikke konto ennå? `auth create` åpner https://linkdash.dev/sign-up og sender deg deretter tilbake til https://linkdash.dev/device med CLI-koden, slik at du kan godkjenne. Har du allerede en konto? `auth login` åpner `/device`. Uten nettleser (headless): sett `LINKDASH_TOKEN` til et sesjonstoken fra `auth create` eller `auth login`. Ikke dikt opp tokens.

Sesjonsfil: `~/.config/linkdash/config.json` (modus 0600).

CLI-et kan ikke endre e-post, passord eller fakturering. Send brukeren til [dashbordet](https://linkdash.dev/dashboard/billing). API-nøkler (HTTP og MCP): [API-nøkler](https://linkdash.dev/dashboard/keys).

## Kommandoer

```
linkdash <command> [options]
```

| Kommando | Hva den gjør |
| --- | --- |
| `auth create` | Registrering i nettleseren, deretter enhetsgodkjenning |
| `auth login` | Enhetsinnlogging i nettleseren |
| `auth logout` | Glem den lagrede sesjonen |
| `auth whoami` | JSON for den innloggede kontoen |
| `links list` | List lenker og mapper, én side om gangen (`--limit`, `--cursor`) |
| `links get <id>` | Én lenke |
| `links create --url <url>` | Kortlenke fra en URL |
| `links create --file <path>` | Last opp en fil og få en lenke |
| `links create --text <text>` | Lagre en tekstbit |
| `links create --folder <name>` | Opprett en [mappe](/no/folders) |
| `links create --variant <name> …` | Lenke med flere varianter (splitt / målretting) |
| `links update <id>` | Endre mål, fil, passord, utløp, domene, status, sticky eller videresendte parametere |
| `links move <id> --in <folder-id>` | Legg en lenke eller mappe i en mappe (`--root` for toppnivået) |
| `links copy <id>` | Lag en kopi med ny slug, i samme mappe |
| `links delete <id>` | Slett en lenke (elementene i en mappe flyttes opp; `--with-contents` sletter dem) |
| `links share <id> --email <email>` | [Del](/no/sharing) med personer via e-post (gjenta `--email`; `--role editor` lar dem endre det; hver nye person får en invitasjon på e-post) |
| `links unshare <id> --email <email>` | Fjern noens tilgang |
| `links shares [id]` | Hvem andre enn deg som kan åpne det, også via en mappe over det. Uten id: alt du har invitert folk til, én side om gangen (`--limit`, `--cursor`) |
| `links shared` | Det andre har delt med deg, én side om gangen (`--limit`, `--cursor`) |
| `links leave <_id \| share URL>` | Gi fra deg noe som er delt med deg |
| `links role <id> --email <e> --role viewer\|editor` | Gjør en du har invitert til leser eller redaktør |
| `links unlock <_id \| share URL>` | Oppgi passordet til et delt element for å se og redigere målet i 30 minutter |
| `links activity <id>` | Hvem som endret et element, og hvordan |
| `links reset-link <id>` | Ny delings-URL; den gamle `linkdash.dev/s/`-URL-en slutter å virke |
| `links stats <id>` | Totalt antall besøk, nedlastinger og avspillinger, også per variant, pluss crawlere |
| `links export` | Skriv ut alle lenker som CSV (én rad per variant) |
| `links import <file>` | Importer URL- og tekstrader fra CSV |
| `links variants list <id>` | Variantene til en lenke |
| `links variants add <id> --name <n>` | Legg til en variant |
| `links variants update <id> <name>` | Endre en variant |
| `links variants remove <id> <name>` | Fjern en variant |
| `webhooks list` | List webhook-endepunkter (hemmeligheten er maskert) |
| `webhooks get <id>` | Vis én webhook-URL (hemmeligheten er maskert) |
| `webhooks create --url <https>` | Legg til et HTTPS-endepunkt (hemmeligheten vises én gang) |
| `webhooks rotate <id>` | Utsted en ny signeringshemmelighet |
| `webhooks delete <id>` | Fjern en webhook |
| `domains list` | List egendefinerte vertsnavn |
| `domains add <host>` | Legg til et vertsnavn (1 på Free) |
| `domains connect <host>` | Domain Connect-URL for å ta i bruk domenet, eller null |
| `domains verify <host>` | Sjekk DNS med Unkey |
| `domains remove <host>` | Fjern et vertsnavn |
| `-h, --help` | Hjelp (ren tekst) |
| `-v, --version` | Versjon |

Hvis samme slug finnes på to av eierens domener, sender du med `--domain`.

## Flagg for opprettelse og oppdatering

Slug er lenkens id, og den offentlige stien når lenken er offentlig. Navnet er bare synlig for deg. Nye lenker er begrensede (se [Tilgang og deling](#access-and-sharing)). Create tar **nøyaktig én** av `--url`, `--file` eller `--text` (som blir varianten `main`), `--variant`-blokker (se [Varianter](#variants)) eller `--folder <name>` (se [Mapper](#folders)).

| Flagg | Merknader |
| --- | --- |
| `--url <url>` | Mål-URL |
| `--file <path>` | Fil som skal lastes opp (ved opprettelse, eller for å erstatte innholdet ved oppdatering) |
| `--text <text>` | Tekstbit |
| `--access <restricted\|link\|public>` | Hvem som kan åpne den. Standard er `restricted`. Se [Tilgang og deling](#access-and-sharing) |
| `--reset-share-link` | Utsted en ny delings-URL (kun update) |
| `--slug <id>` | Offentlig sti: `a-z0-9` og bindestreker inni, 1–64 tegn |
| `--name <label>` | Privat etikett |
| `--tag <tag>` | Kan gjentas. Små bokstaver, ingen kommaer. Maks 20 |
| `--starts <when>` | Gå live etter `7d`, `24h`, `30m` eller på en ISO-dato |
| `--password <secret>` | Krev dette passordet for å åpne |
| `--expires <when>` | Slutt å levere etter `7d`, `24h`, `30m` eller på en ISO-dato |
| `--max-openings <n>` | Sett på pause etter så mange åpninger. Utelat for ubegrenset |
| `--domain <host>` | Lever på denne verten i stedet for `lida.sh` |
| `--in <folder-id>` | Opprett i denne mappen (kun create; `--in-domain <host>` hvis mappens slug går igjen) |
| `--status <active\|paused>` | Sett på pause eller gjenoppta (kun update) |
| `--sticky` / `--no-sticky` | En besøkende som kommer tilbake, beholder samme variant (standard er sticky) |
| `--restart-split` | Stokk om sticky-tildelingene (kun update) |
| `--forward-params` / `--no-forward-params` | Legg den besøkendes spørrestreng til URL-varianter (standard av). Se [Videresend spørreparametere](#forward-query-parameters) |
| `--variant <name>` | Start en variantblokk (kun create). Se [Varianter](#variants) |
| `--weight <n>` `--when <key=v1,v2>` | Per variant. Se [Varianter](#variants) og [Regler for spørreparametere](#query-parameter-rules) |
| `--preview-name <text>` | Offentlig navn i lenkeforhåndsvisningen |
| `--preview-description <text>` | Offentlig beskrivelse i lenkeforhåndsvisningen |
| `--preview-image <path>` | Offentlig bilde i lenkeforhåndsvisningen |
| `--utm-source` `--utm-medium` `--utm-campaign` `--utm-term` `--utm-content` | Kun URL-lenker |
| `--clear-password` `--clear-expires` `--clear-starts` `--clear-tags` `--clear-preview` `--clear-name` `--clear-max-openings` | Kun update |

`--status` godtar bare `active` eller `paused`. Utløpt kommer fra `--expires`. Planlagt kommer fra `--starts`. Offentlig oppslag gir not-found frem til start. Når `--max-openings` er nådd, settes lenken på pause; øk tallet, eller bruk `--clear-max-openings`, for å levere den igjen. Åpninger som allerede er brukt, telles med til du endrer eller fjerner grensen.

`lida.sh`-slugs er delte. Hvis et ord er tatt, legger du til et [egendefinert domene](/no/domains) og prøver igjen med `--domain`. En lenke på et merkevaredomene publiseres ikke i tillegg på `lida.sh`.

## Flagg for listing

Skriver ut én side, `{items, cursor}`: `--limit` er 1-100 (standard 50); send med `--cursor` med `cursor` fra forrige side til den er `null`. En side kan inneholde færre elementer enn `--limit` når et filter hopper over noen. `--q` matcher hele ord, der det siste ordet behandles som prefiks (`laun` finner `example.com/launch`), rangert etter relevans; `--in` lister én mappe, med mapper først; ellers vises nyeste først.

| Flagg | Merknader |
| --- | --- |
| `--limit <n>` | Elementer per side, 1-100 (standard 50) |
| `--cursor <c>` | `cursor` fra forrige side |
| `--q <text>` | Søk etter ord i navn, slug, variantnavn og -mål, filnavn, tekstbiter og tagger |
| `--tag <tag>` | Filtrer etter tagg |
| `--kind <url\|file\|text\|folder\|group>` | Filtrer etter type (`group` = flere varianter) |
| `--status <status>` | `active`, `paused`, `expired`, `scheduled` eller `mixed` |
| `--in <folder-id\|root>` | Bare det som ligger direkte i denne mappen, eller på toppnivået. Uten flagget listes alt |

## Varianter

Hver lenke er en beholder for én eller flere **varianter**. En variant er innholdet (URL, fil eller tekst) pluss egne tilgangsbetingelser (`--password`, `--starts`, `--expires`, `--max-openings`), en `--weight` og valgfrie betingelser for besøkende (`--when`). Uten `--variant` har en lenke én variant som heter `main`, og hver kommando over er en kortform for den. En besøkende får én variant: variantene der `--when` matcher, utgjør utvalget (hvis ingen matcher, brukes de ubetingede variantene), og deretter gjøres et vektet valg. Med sticky-tildeling (standard) beholder en besøkende som kommer tilbake, samme variant. Lenkens egne tilgangsbetingelser går foran variantenes. Variantnavn: små bokstaver, sifre og bindestreker inni, 1–40 tegn, unike per lenke. Maks 20 varianter.

Lenkens `kind` er variantens type når det er én variant, og `group` når det er flere. Lenkens `status` er lenkens tilgangsbetingelse når den er satt (`paused`, `scheduled`, `expired`), ellers den felles variantstatusen, ellers `mixed`. `variantStatuses` teller `{active, paused, expired, scheduled}`.

### Opprett med variantblokker

```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>` starter en variantblokk. Flagg etter den hører til den varianten frem til neste `--variant`: `--url|--file|--text`, `--password`, `--starts`, `--expires`, `--max-openings`, `--weight <n>`, `--when <key=v1,v2>` (kan gjentas), `--utm-*`. Lenkeflagg (`--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params`) kommer før første `--variant`.

### Underkommandoer for 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 én av `--url`, `--file`, `--text`, pluss flagg for tilgangsbetingelser, `--weight`, `--when`, `--utm-*`. `variants update <id> <name>` tar `--name <new>`, innhold, flagg for tilgangsbetingelser, `--status active|paused`, `--weight`, `--when`, `--clear-when`, `--clear-password`, `--clear-starts`, `--clear-expires`, `--clear-max-openings`. En lenke beholder alltid minst én variant.

### `--when`-nøkler

| Nøkkel | JSON-felt | Verdier |
| --- | --- | --- |
| `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` | prefiksmatch (`de`, `en-us`) |
| `referrer` | `referrerHosts` | vertssuffiks (`twitter.com`) |

Alle nøkler som er satt, må matche. `--when country=DE,AT --when device=mobile` blir `{ "countries": ["DE","AT"], "devices": ["mobile"] }`.

### Regler for spørreparametere

`--when` tar også `param:`-regler for den besøkendes spørrestreng (`lida.sh/promo?src=newsletter`). Nøkler skiller mellom store og små bokstaver, verdier sammenlignes eksakt, og det er maks 10 regler per variant. Komma deler opp `--when`, så en parameterverdi kan ikke inneholde komma; bruk `|` for lister.

| Syntaks | JSON `op` | Matcher når |
| --- | --- | --- |
| `param:KEY=VALUE` | `equals` | verdien er nøyaktig `VALUE` |
| `param:KEY!=VALUE` | `notEquals` | verdien er en annen, eller nøkkelen mangler |
| `param:KEY~=VALUE` | `includes` | verdien inneholder `VALUE` |
| `param:KEY^=VALUE` | `startsWith` | verdien starter med `VALUE` |
| `param:KEY$=VALUE` | `endsWith` | verdien slutter med `VALUE` |
| `param:KEY=v1\|v2` | `in` | verdien er en av verdiene i listen |
| `param:KEY?` or `param:KEY` | `exists` | nøkkelen finnes |
| `param:!KEY` | `missing` | nøkkelen mangler |

```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-form: `"when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }` (`value` utelates for `exists` / `missing`). Parameterverdier matches når lenken åpnes, og lagres aldri i analysedataene.

### Videresend spørreparametere

`--forward-params` / `--no-forward-params` på `links create` og `links update` (på lenkenivå, av som standard) legger hele den besøkendes spørrestreng til URL-varianter: `lida.sh/promo?src=nl` åpner `https://example.com/?src=nl`. Verdier fra den besøkende overstyrer lagrede verdier, også `--utm-*`. Fil- og tekstvarianter ignorerer innstillingen. Dette er ruting, ikke tilgangskontroll: hvem som helst kan legge til parametere. Parameterverdier lagres ikke i analysedataene. `links get` viser innstillingen som `forwardParams`.

### Sticky og omstart av splitt

`links update <id> --sticky` / `--no-sticky` angir om en besøkende som kommer tilbake, beholder samme variant. `links update <id> --restart-split` stokker om sticky-tildelingene. Innholdsflagg på `links update` virker bare for lenker med én variant; ellers bruker du `links variants update <id> <name>`.

## Mapper

En mappe er en lenke som lister elementene du legger i den. Se [Mapper](/no/folders) for hvordan den offentlige siden og tilgangen fungerer.

```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>` angir mappenavnet (ikke `--name`) og tar `--slug`, `--domain`, `--password`, `--starts`, `--expires`, `--max-openings`, `--tag`, `--preview-*` og `--in`. Det kan ikke kombineres med `--url`, `--file`, `--text` eller `--variant`. `links move` skriver ut `{id, folder}`. `links copy` beholder tilgangsnivået, men får en ny delings-URL; personer kopieres ikke. `links delete` på en mappe flytter elementene ett nivå opp; `--with-contents` sletter dem også. Rader fra list, get og create inkluderer `folder` (sluggen til mappen elementet ligger i, eller `null`); mapperader inkluderer også `items`.

## Tilgang og deling

Nye lenker og mapper er `restricted`: `url` er `https://linkdash.dev/s/<token>`, som bare du og de du deler med kan åpne, når de er innlogget. `--access link` åpner den URL-en for alle som har den. `--access public` leverer lenken på kort-URL-en (`lida.sh/<slug>` eller ditt egendefinerte domene). Bruk `--access public` for lenker du legger ut offentlig. Sluggen er fortsatt id-en for alle kommandoer, og kort-URL-en forblir reservert så lenge lenken ikke er offentlig. Se [Deling og tilgang](/no/sharing) for hele 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` (uten id) | `{items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}`, sist delt først |
| `links shared` | `{items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}`, nyeste 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` gjør noen til redaktør: de kan endre elementet og se statistikken, men ikke passord, slug, domene, tilgang eller deling, og de kan ikke slette, flytte eller kopiere. Et passordbeskyttet mål krever dessuten `links unlock` først (30 minutter). Redaktører bruker `_id` eller delings-URL-en fra `links shared`. Alle kommandoene tar `--domain <host>` når sluggen går igjen. `url` i utdata fra `create`, `get`, `list`, `update`, `copy` og `share` er delings-URL-en, med mindre lenken er offentlig – da er det kort-URL-en; rader inkluderer `access`. Opptil 200 personer per element, 50 e-postadresser per kall og 100 invitasjoner på e-post per konto per dag. De to listene skriver ut én side: `--limit` er 1-100 (standard 50); send med `--cursor` fra forrige side til `cursor` er `null`. `links leave` tar `_id` eller `url` fra `links shared`; tilgang via en delt mappe lenger opp beholdes. Deling, oppheving av deling, en tilgangsendring og en tilbakestilling teller hver som én hendelse; å forlate gjør det ikke.

## Statistikk

```bash
linkdash links stats <id> --last 24h
```

`--last` er en varighet (`24h`, `7d`). Standard er `24h`. JSON inkluderer `visits`, `downloads`, `plays`, `visitsInLast`, `countries`, `referrers`, `variants` (totaler per variant), `visitors` (hver med `variant`) og `crawlers` (`[{crawler, company, category, hits, lastSeen}]`: boter og lenkeforhåndsvisninger som har hentet lenken, og som aldri telles som besøk).

## CSV

Kolonner: `slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access`. Én rad per variant. `kind`, `status`, `url`, `text`, `fileName`, `weight` og `when` (JSON-streng) gjelder per variant; resten gjelder per lenke og gjentas. `folder` er sluggen til mappen lenken ligger i. `access` er `restricted`, `link` eller `public`. Ingen passord, delingstokens eller personer.

```bash
linkdash links export > links.csv
linkdash links import links.csv
```

Import grupperer rader etter slug + domene. Den første raden oppretter lenken med varianten sin; flere rader legger til varianter. For en eksisterende lenke oppdaterer den første raden lenkefeltene, og deretter oppdaterer hver rad varianten med det navnet hvis den finnes, ellers legges den til. Filrader uten innhold hoppes over med en feil for den enkelte raden. Rader med `kind` = `folder` (med en `name`) oppretter mapper; `folder`-kolonnen plasserer hver lenke i mappen sin etter at alle radene finnes. En tom `access` gjør nye lenker begrensede og lar eksisterende lenker være som de er.

## Eksempler

```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 også [mapper](/no/folders), [deling og tilgang](/no/sharing), [webhooks](/no/webhooks) og [egendefinerte domener](/no/domains).
