Lnkgo

Branded tracked links, QR codes, analytics, and custom-domain short URLs for agents and developers.

• Product: https://lnkgo.app
• API: https://api.lnkgo.app
• Default short-link domain: lnkgo.app
• npm CLI: https://www.npmjs.com/package/lnkgo

Repository Boundary

This public repository is the Lnkgo agent-skill source. Do not add the lnkgo.app static website, VPS deploy scripts, GitHub Actions deploy workflow, or private infrastructure secrets here.

The live lnkgo.app static website is managed separately in the private nttylock/lnkgo repository. This public repo remains safe for skill installation through:

npx --yes skills add citedy/lnkgo

Install The Agent Skill

Install through the open skills CLI:

npx --yes skills add citedy/lnkgo --skill lnkgo -a codex -g -y
npx --yes skills add citedy/lnkgo --skill lnkgo -a claude-code -g -y
npx --yes skills add citedy/lnkgo --skill lnkgo -a cursor -g -y

Or install the bundled skill from the npm CLI:

npx --yes lnkgo skill install --target codex
npx --yes lnkgo skill install --target claude
npx --yes lnkgo skill install --target cursor
npx --yes lnkgo skill install --target project

project writes the skill to .codex/skills/lnkgo/SKILL.md in the current working directory.

Use The CLI

npx --yes lnkgo init --email you@example.com
export LNKGO_VERIFICATION_CODE="<email-code>"
export LNKGO_API_KEY="$(
  npx --yes lnkgo init --email you@example.com --code "$LNKGO_VERIFICATION_CODE" \
    | jq -r '.api_key'
)"

npx --yes lnkgo create --url https://example.com/launch --tag product-hunt
npx --yes lnkgo create --url https://example.com/launch --slug spring-campaign
npx --yes lnkgo create --url https://example.com/webinar --expire 12h
npx --yes lnkgo qr <link-id> --output lnkgo-qr.png
npx --yes lnkgo analytics <link-id>
npx --yes lnkgo analytics <link-id> --csv

Default-domain links do not need --domain. Use --domain only for an active custom domain owned by the account.

--slug <slug> requests a specific public short-code. The shared lnkgo.app namespace reserves system, protected, and premium slugs; verified custom domains allow more brand-specific slugs while still blocking system and unsafe terms.

--expire <duration> is CLI sugar for the API expires_at field. Supported units are minutes, hours, and days, for example 30m, 12h, or 20d.

lnkgo analytics --csv formats the current aggregate analytics JSON as local CSV. It is not a raw click export and does not create a hosted report link.

Use The REST API

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","slug":"spring-campaign","tags":["product-hunt"]}'

Skill Source

The public skill lives at:

skills/lnkgo/SKILL.md

It tells compatible agents to use https://api.lnkgo.app, lnkgo.app, and LNKGO_API_KEY for Lnkgo workflows.