# Linkdash

> Linkdash turns a URL, a file, or a text snippet into a tracked short link on lida.sh. Agents and humans use the CLI or the HTTP API. You can skip the dashboard UI.

Linkdash lives at https://linkdash.dev. Short links are served from https://lida.sh/{id}. The public id is a generated 6-character slug by default; custom slugs are unique per host. Generated ids and lida.sh slugs share one public namespace. Custom domains have their own. Account and billing live in the dashboard only. API keys live at https://linkdash.dev/dashboard/keys.

Install the CLI with `npm i -g linkdash-cli` (also pnpm / bun / `npx linkdash-cli@latest`). The command is `linkdash`. Commands print JSON on stdout. Help and errors are plain text. There is no `--json` flag. Create takes exactly one of `--url`, `--file`, or `--text`. No account yet? `linkdash auth create` opens sign-up, then /device. Already signed up? `linkdash auth login` opens /device.

HTTP API: `https://api.linkdash.dev/v1` with `Authorization: Bearer ldash_...`. MCP: `https://api.linkdash.dev/mcp` with the same key. Same operations as the CLI (links, stats, domains, webhooks, CSV). Files: `POST /v1/uploads` returns `{uploadUrl,storageId}`, host PUTs bytes to `uploadUrl`, then create with that `storageId`. Every CLI, API, or MCP write counts toward the monthly event quota, same as a visit.

For AI agents, prefer the markdown files below over scraping HTML. Human docs: https://linkdash.dev/docs

## Pricing

Plans, quotas, and what counts as an event.

- [Pricing (Markdown)](https://linkdash.dev/pricing.md)
- [Pricing (HTML)](https://linkdash.dev/#pricing)

## CLI

Install, flags, JSON stdout, CSV, webhooks, and domains.

- [CLI (Markdown)](https://linkdash.dev/cli.md)
- [CLI skill](https://linkdash.dev/skills/linkdash/SKILL.md)
- [npm CLI](https://www.npmjs.com/package/linkdash-cli)

## HTTP API

REST with a bearer key from the dashboard. One operation per CLI verb.

- [API (Markdown)](https://linkdash.dev/api.md)
- [API discovery](https://api.linkdash.dev/v1)
- [API keys](https://linkdash.dev/dashboard/keys)

## MCP

Remote MCP with the same Unkey bearer key. Tools match the CLI and `/v1`.

- [MCP (Markdown)](https://linkdash.dev/mcp.md)
- [MCP endpoint](https://api.linkdash.dev/mcp)

## Product

- [Docs](https://linkdash.dev/docs): quickstart, CLI, HTTP API, MCP, domains, webhooks, pricing
- [Home](https://linkdash.dev): product, pricing, CLI, QR codes, and HTTP API
- [Sign up](https://linkdash.dev/sign-up): email/password or Google, free plan, no card
- [Sign in](https://linkdash.dev/sign-in): existing accounts
- [Dashboard](https://linkdash.dev/dashboard): links, analytics, API keys, settings, billing
- [Billing](https://linkdash.dev/dashboard/billing): Free, Professional, and Growth
- [Terms](https://linkdash.dev/legal/terms-of-service): terms of service
- [Privacy](https://linkdash.dev/legal/privacy-policy): privacy policy

## Skills

- [linkdash](https://linkdash.dev/skills/linkdash/SKILL.md): create short links, upload files, store snippets, read analytics, manage custom domains, call the HTTP API, and connect MCP
- [npm skill](https://www.npmjs.com/package/linkdash-skill): installable SKILL.md for Cursor and Claude Code

## Optional

- [Support](mailto:support@linkdash.dev): human support
- [GitHub](https://github.com/igorkirnosov/linkdash): source repository