# Lnkgo

Lnkgo is a command-first link service for agents and developers.

Public product URL: https://lnkgo.app
Control API base URL: https://api.lnkgo.app
Default short-link domain: lnkgo.app

Use Lnkgo to create tracked short links, fetch PNG QR codes, read click
analytics, and verify custom domains through DNS proof.

Quickstart:

```bash
npm install -g lnkgo
lnkgo init --email you@example.com
export LNKGO_VERIFICATION_CODE="<email-code>"
export LNKGO_API_KEY="$(
  lnkgo init --email you@example.com --code "$LNKGO_VERIFICATION_CODE" \
    | jq -r '.api_key'
)"
CREATE_RESULT="$(lnkgo create --url https://example.com/launch --tag product-hunt)"
LINK_ID="$(printf '%s' "$CREATE_RESULT" | jq -r '.id')"
SHORT_URL="$(printf '%s' "$CREATE_RESULT" | jq -r '.short_url')"
```

Default-domain rule:

- Omit `domain` to create on `lnkgo.app`.
- Pass `--domain links.example.com` only after that custom domain is active.

Core commands:

```bash
lnkgo create --url https://example.com/launch --tag launch
lnkgo create --url https://example.com/launch --slug spring-campaign --tag launch
lnkgo qr "$LINK_ID" --output lnkgo-qr.png
lnkgo analytics "$LINK_ID"
lnkgo domain status links.example.com
npx --yes skills add citedy/lnkgo --skill lnkgo -a codex -g -y
```

Use `--slug <slug>` only when the user wants a specific public short-code.
`lnkgo.app` reserves system, protected, and premium slugs. Verified custom
domains allow more brand-specific slugs while still blocking system and unsafe
terms.

Use `SHORT_URL` publicly. Use `LINK_ID` only for Control API commands such as
QR and analytics. Never infer `LINK_ID` from the public short URL.

REST create:

```bash
curl -sS -X POST "https://api.lnkgo.app/v1/links" \
  -H "Authorization: Bearer $LNKGO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
  -d '{"url":"https://example.com/launch","tags":["product-hunt"]}'
```

Analytics includes total clicks, non-bot clicks, bot clicks, top referrers, top
countries, daily timeseries, and truncation status when data is capped.

Support and legal:

- Support form: https://lnkgo.app/support/
- Abuse reports: https://lnkgo.app/abuse/
- Terms: https://lnkgo.app/terms/
- Privacy: https://lnkgo.app/privacy/