Saltar al contenido
LinkdashLinkdash
Español
Esc
↑↓navegar↵abrir⌘Jvista previa
En esta página

CLI

Instala linkdash-cli desde npm y luego ejecuta el comando `linkdash`. Los comandos exitosos imprimen JSON en stdout. La ayuda y los errores son texto plano en stderr.

npm i -g linkdash-cli
# or: pnpm add -g linkdash-cli / bun add -g linkdash-cli / npx linkdash-cli@latest

El paquete de npm es linkdash-cli. El comando es linkdash.

Equivalente HTTP: API HTTP. MCP: MCP. Skill para agentes: Skill para agentes. Precios: Precios. Markdown plano: cli.md.

No existe el flag --json. Código de salida 1 en caso de error.

Autenticación

linkdash auth create
linkdash auth login
linkdash auth whoami
linkdash auth logout

¿Todavía no tienes cuenta? auth create abre https://linkdash.dev/sign-up y luego regresa a https://linkdash.dev/device con el código de la CLI para que puedas aprobarlo. ¿Ya tienes cuenta? auth login abre /device. Sin interfaz gráfica: define LINKDASH_TOKEN con un token de sesión obtenido de auth create o auth login. No inventes tokens.

Archivo de sesión: ~/.config/linkdash/config.json (modo 0600).

La CLI no puede cambiar el correo, la contraseña ni la facturación. Envía al usuario al panel. Claves de API (HTTP y MCP): Claves de API.

Comandos

linkdash <command> [options]
Comando Qué hace
auth create Registro en el navegador y luego aprobación del dispositivo
auth login Inicio de sesión del dispositivo en el navegador
auth logout Olvida la sesión guardada
auth whoami JSON de la cuenta con sesión iniciada
links list Lista enlaces y carpetas, una página a la vez (--limit, --cursor)
links get <id> Un enlace
links create --url <url> Enlace corto a partir de una URL
links create --file <path> Sube un archivo y obtén un enlace
links create --text <text> Guarda un fragmento de texto
links create --folder <name> Crea una carpeta
links create --variant <name> … Enlace con varias variantes (split / segmentación)
links update <id> Cambia el destino, archivo, contraseña, vencimiento, dominio, estado, sticky o parámetros reenviados
links move <id> --in <folder-id> Coloca un enlace o una carpeta dentro de una carpeta (--root para el nivel superior)
links copy <id> Crea una copia con un slug nuevo, en la misma carpeta
links delete <id> Elimina un enlace (los elementos de una carpeta suben un nivel; --with-contents los elimina)
links share <id> --email <email> Comparte con personas por correo (repite --email; --role editor les permite modificarlo; cada persona nueva recibe un correo de invitación)
links unshare <id> --email <email> Quita el acceso a alguien
links shares [id] Quién más puede abrirlo además de ti, incluso a través de una carpeta superior. Sin id: todo aquello a lo que invitaste personas, una página a la vez (--limit, --cursor)
links shared Lo que otras personas compartieron contigo, una página a la vez (--limit, --cursor)
links leave <_id | share URL> Renuncia a algo que compartieron contigo
links role <id> --email <e> --role viewer|editor Convierte a alguien que invitaste en lector o editor
links unlock <_id | share URL> Ingresa la contraseña de un elemento compartido para ver y editar su destino durante 30 minutos
links activity <id> Quién cambió un elemento y cómo
links reset-link <id> Nueva URL para compartir; la URL anterior de linkdash.dev/s/ deja de funcionar
links stats <id> Totales de visitas, descargas y reproducciones, también por variante, más los crawlers
links export Imprime todos los enlaces como CSV (una fila por variante)
links import <file> Importa filas de URL y texto desde un CSV
links variants list <id> Variantes de un enlace
links variants add <id> --name <n> Agrega una variante
links variants update <id> <name> Cambia una variante
links variants remove <id> <name> Elimina una variante
webhooks list Lista los endpoints de webhook (secreto enmascarado)
webhooks get <id> Muestra la URL de un webhook (secreto enmascarado)
webhooks create --url <https> Agrega un endpoint HTTPS (el secreto se muestra una sola vez)
webhooks rotate <id> Emite un nuevo secreto de firma
webhooks delete <id> Elimina un webhook
domains list Lista los hostnames personalizados
domains add <host> Agrega un hostname (1 en Free)
domains connect <host> URL de aplicación de Domain Connect, o null
domains verify <host> Verifica el DNS con Unkey
domains remove <host> Elimina un hostname
-h, --help Ayuda (texto plano)
-v, --version Versión

Si el mismo slug existe en dos dominios del propietario, pasa --domain.

Flags de creación y actualización

El slug es el id del enlace y su ruta pública cuando el enlace es público. El nombre solo lo ves tú. Los enlaces nuevos son restringidos (consulta Acceso y uso compartido). Create acepta exactamente uno de --url, --file o --text (que se convierte en la variante main), bloques --variant (consulta Variantes) o --folder <name> (consulta Carpetas).

Flag Notas
--url <url> URL de destino
--file <path> Archivo a subir (al crear, o para reemplazar los bytes al actualizar)
--text <text> Fragmento de texto
--access <restricted|link|public> Quién puede abrirlo. Predeterminado restricted. Consulta Acceso y uso compartido
--reset-share-link Emite una nueva URL para compartir (solo al actualizar)
--slug <id> Ruta pública: a-z0-9 y guiones internos, de 1 a 64
--name <label> Etiqueta privada
--tag <tag> Repetible. En minúsculas, sin comas. Máximo 20
--starts <when> Se activa después de 7d, 24h, 30m o una fecha ISO
--password <secret> Exige esta contraseña para abrirlo
--expires <when> Deja de servirse después de 7d, 24h, 30m o una fecha ISO
--max-openings <n> Se pausa después de esta cantidad de aperturas. Omítelo para que sea ilimitado
--domain <host> Sirve en este host en lugar de lida.sh
--in <folder-id> Crea dentro de esta carpeta (solo al crear; --in-domain <host> si el slug de la carpeta se repite)
--status <active|paused> Pausa o reanuda (solo al actualizar)
--sticky / --no-sticky El visitante que regresa conserva la misma variante (sticky por defecto)
--restart-split Vuelve a mezclar las asignaciones sticky (solo al actualizar)
--forward-params / --no-forward-params Agrega la query string del visitante a las variantes de URL (desactivado por defecto). Consulta Reenviar parámetros de consulta
--variant <name> Inicia un bloque de variante (solo al crear). Consulta Variantes
--weight <n> --when <key=v1,v2> Por variante. Consulta Variantes y Reglas de parámetros de consulta
--preview-name <text> Nombre público en la vista previa
--preview-description <text> Descripción pública en la vista previa
--preview-image <path> Imagen pública en la vista previa
--utm-source --utm-medium --utm-campaign --utm-term --utm-content Solo para enlaces de URL
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings Solo al actualizar

--status solo acepta active o paused. El estado vencido proviene de --expires. El estado programado proviene de --starts. La resolución pública devuelve not-found hasta el inicio. Al alcanzar --max-openings, el enlace se pausa; aumenta el número o usa --clear-max-openings para volver a servirlo. Las aperturas ya usadas siguen contando hasta que cambies o elimines el límite.

Los slugs de lida.sh son compartidos. Si una palabra ya está ocupada, agrega un dominio personalizado y vuelve a intentarlo con --domain. Un enlace en un dominio propio no se publica también en lida.sh.

Flags de listado

Imprime una página, {items, cursor}: --limit va de 1 a 100 (predeterminado 50); pasa --cursor con el cursor de la página anterior hasta que sea null. Una página puede contener menos elementos que --limit cuando un filtro omite algunos. --q busca palabras completas, con la última como prefijo (laun encuentra example.com/launch), ordenadas por relevancia; --in lista una carpeta, con las carpetas primero; de lo contrario, los más recientes primero.

Flag Notas
--limit <n> Elementos por página, de 1 a 100 (predeterminado 50)
--cursor <c> El cursor de la página anterior
--q <text> Busca palabras en el nombre, slug, nombres y destinos de variantes, nombres de archivo, texto de fragmentos y etiquetas
--tag <tag> Filtra por etiqueta
--kind <url|file|text|folder|group> Filtra por tipo (group = varias variantes)
--status <status> active, paused, expired, scheduled o mixed
--in <folder-id|root> Solo lo que está directamente en esta carpeta, o en el nivel superior. Sin este flag, se lista todo

Variantes

Cada enlace es un contenedor de una o más variantes. Una variante es el contenido (URL, archivo o texto) más su propia compuerta (--password, --starts, --expires, --max-openings), un --weight y condiciones opcionales del visitante (--when). Sin --variant, un enlace tiene una sola variante llamada main, y todos los comandos anteriores son un atajo para ella. Un visitante recibe una variante: las variantes cuyo --when coincide forman el grupo (si ninguna coincide, lo forman las variantes sin condiciones) y luego se elige una de forma ponderada. Con la asignación sticky (predeterminada), un visitante que regresa conserva la misma variante. La compuerta del propio enlace tiene prioridad sobre las compuertas de las variantes. Nombres de variantes: letras minúsculas, dígitos y guiones internos, de 1 a 40 caracteres, únicos por enlace. Máximo 20 variantes.

El kind del enlace es el tipo de la variante cuando hay una sola variante, y group cuando hay varias. El status del enlace es la compuerta del enlace cuando está definida (paused, scheduled, expired); si no, el estado compartido de las variantes; si no, mixed. variantStatuses cuenta {active, paused, expired, scheduled}.

Crear con bloques de variantes

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> inicia un bloque de variante. Los flags que vienen después pertenecen a esa variante hasta el siguiente --variant: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (repetible), --utm-*. Los flags del enlace (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) van antes del primer --variant.

Subcomandos de variantes

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> acepta uno de --url, --file, --text, además de flags de compuerta, --weight, --when, --utm-*. variants update <id> <name> acepta --name <new>, contenido, flags de compuerta, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires, --clear-max-openings. Un enlace conserva al menos una variante.

Claves de --when

Clave Campo JSON Valores
country countries Códigos 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 coincidencia por prefijo (de, en-us)
referrer referrerHosts sufijo del host (twitter.com)

Todas las claves definidas deben coincidir. --when country=DE,AT --when device=mobile equivale a { "countries": ["DE","AT"], "devices": ["mobile"] }.

Reglas de parámetros de consulta

--when también acepta reglas param: sobre la query string del visitante (lida.sh/promo?src=newsletter). Las claves distinguen mayúsculas de minúsculas, los valores se comparan de forma exacta y hay un máximo de 10 reglas por variante. Las comas separan --when, así que el valor de un parámetro no puede contener comas; usa | para listas.

Sintaxis op en JSON Coincide cuando
param:KEY=VALUE equals el valor es exactamente VALUE
param:KEY!=VALUE notEquals el valor es distinto, o la clave no está presente
param:KEY~=VALUE includes el valor contiene VALUE
param:KEY^=VALUE startsWith el valor empieza con VALUE
param:KEY$=VALUE endsWith el valor termina con VALUE
param:KEY=v1|v2 in el valor es uno de la lista
param:KEY? o param:KEY exists la clave está presente
param:!KEY missing la clave no está presente
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?"

Estructura JSON: "when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] } (value se omite para exists / missing). Los valores de los parámetros se evalúan al momento de abrir el enlace y nunca se guardan en las analíticas.

Reenviar parámetros de consulta

--forward-params / --no-forward-params en links create y links update (a nivel de enlace, desactivado por defecto) agrega toda la query string del visitante a las variantes de URL: lida.sh/promo?src=nl abre https://example.com/?src=nl. Los valores del visitante sobrescriben los guardados, incluidos los --utm-*. Las variantes de archivo y de texto lo ignoran. Esto es enrutamiento, no control de acceso: cualquiera puede agregar parámetros. Los valores de los parámetros no se guardan en las analíticas. links get lo muestra como forwardParams.

Sticky y reinicio del split

links update <id> --sticky / --no-sticky define si un visitante que regresa conserva la misma variante. links update <id> --restart-split vuelve a mezclar las asignaciones sticky. Los flags de contenido en links update solo funcionan para enlaces de una sola variante; de lo contrario, usa links variants update <id> <name>.

Carpetas

Una carpeta es un enlace que lista los elementos que pones dentro. Consulta Carpetas para ver cómo funcionan la página pública y el acceso.

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> define el nombre de la carpeta (no --name) y acepta --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* e --in. No se puede combinar con --url, --file, --text ni --variant. links move imprime {id, folder}. links copy conserva el nivel de acceso, pero obtiene una nueva URL para compartir; las personas no se copian. links delete sobre una carpeta sube sus elementos un nivel; --with-contents también los elimina. Las filas de list, get y create incluyen folder (el slug de la carpeta contenedora, o null); las filas de carpetas también incluyen items.

Acceso y uso compartido

Los enlaces y carpetas nuevos son restricted: su url es https://linkdash.dev/s/<token>, que solo pueden abrir tú y las personas con quienes lo compartas, con sesión iniciada. --access link abre esa URL a cualquiera que la tenga. --access public sirve el enlace en su URL corta (lida.sh/<slug> o tu dominio personalizado). Usa --access public para los enlaces que publiques abiertamente. El slug sigue siendo el id para todos los comandos, y su URL corta queda reservada mientras el enlace no sea público. Consulta Uso compartido y acceso para ver el modelo completo.

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
Comando Imprime
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 (sin id) {items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}, lo compartido más recientemente primero
links shared {items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, los más recientes primero
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> (o links update <id> --reset-share-link) {id, access, url}

--role editor convierte a alguien en editor: puede cambiar el elemento y ver sus estadísticas, pero no contraseñas, slug, dominio, acceso ni uso compartido, ni eliminar, mover o copiar; además, un destino protegido con contraseña requiere primero links unlock (30 minutos). Los editores usan el _id o la URL para compartir de links shared. Todos aceptan --domain <host> cuando el slug se repite. La url en la salida de create, get, list, update, copy y share es la URL para compartir, salvo que el enlace sea público, en cuyo caso es la URL corta; las filas incluyen access. Hasta 200 personas por elemento, 50 correos por llamada y 100 correos de invitación por cuenta al día. Las dos listas imprimen una página: --limit va de 1 a 100 (predeterminado 50); pasa --cursor de la página anterior hasta que cursor sea null. links leave acepta el _id o la url de links shared; el acceso a través de una carpeta compartida superior se mantiene. Compartir, dejar de compartir, un cambio de acceso y un restablecimiento cuentan cada uno como un evento; salir no cuenta.

Estadísticas

linkdash links stats <id> --last 24h

--last es una duración (24h, 7d). Predeterminado 24h. El JSON incluye visits, downloads, plays, visitsInLast, countries, referrers, variants (totales por variante), visitors (cada uno con variant) y crawlers ([{crawler, company, category, hits, lastSeen}]: bots y vistas previas de enlaces que accedieron al enlace, nunca contados como visitas).

CSV

Columnas: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Una fila por variante. kind, status, url, text, fileName, weight y when (string JSON) son por variante; el resto son por enlace y se repiten. folder es el slug de la carpeta en la que está el enlace. access es restricted, link o public. No incluye contraseñas, tokens para compartir ni personas.

linkdash links export > links.csv
linkdash links import links.csv

La importación agrupa las filas por slug + dominio. La primera fila crea el enlace con su variante; las filas adicionales agregan variantes. Para un enlace existente, la primera fila actualiza los campos del enlace y luego cada fila actualiza la variante por nombre si existe; si no, la agrega. Las filas de archivo sin bytes se omiten con un error por fila. Las filas con kind = folder (con un name) crean carpetas; la columna folder coloca cada enlace en su carpeta una vez que existen todas las filas. Un access vacío hace que los enlaces nuevos sean restringidos y deja los enlaces existentes como están.

Ejemplos

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

Consulta también carpetas, uso compartido y acceso, webhooks y dominios personalizados.

¿Te ha resultado útil esta página?