🔗 lnkify CLI

Not just a URL Shortener. Open Source, fully customizable.

Manage your Lnkify links, domains, API keys, and analytics straight from the terminal — and plug Lnkify into any AI agent over MCP.

Install

npm install -g lnkify
# or run without installing
npx lnkify --help

Requires Node.js >= 22.

Related MCP server: agentforge

Quickstart

# 1. Point at your server (defaults to http://localhost:4000)
lnkify config set url http://localhost:4000

# 2. Authenticate — interactive login...
lnkify login
# ...or use a scoped API key (lf_live_…)
lnkify config set api-key lf_live_xxxxxxxxxxxx

# 3. Create and manage links
lnkify links create https://example.com --slug launch --track
lnkify links list
lnkify resolve launch
lnkify analytics

Connecting to a server

The CLI is local-first (defaults to http://localhost:4000) but talks to any Lnkify instance, local or remote. The host and credentials are resolved with this precedence (highest wins):

1. Flags — --url, --api-key

2. Environment — LNKIFY_API_URL, LNKIFY_API_KEY

3. Active profile — selected with --profile <name> (else the default profile)

4. Built-in default — http://localhost:4000

Profiles (multiple servers)

lnkify --profile prod config set url https://links.acme.com
lnkify --profile prod config set api-key lf_live_xxxx
lnkify --profile prod links list          # hit prod
lnkify links list                         # hit local default

Config lives at ~/.config/lnkify/config.json (honors $XDG_CONFIG_HOME) and is written with 0600 permissions because it holds secrets.

Commands

Add --json to any command for clean, pipeable machine output:

lnkify links list --json | jq '.items[].lnkify'

AI agents (MCP)

lnkify mcp serve exposes your links as Model Context Protocol tools over stdio, so agents like Claude can create and manage short links on your behalf using your configured credentials.

lnkify mcp install --client claude   # prints a ready-to-paste config block

Development

pnpm install
pnpm dev          # tsup --watch
pnpm build
pnpm test         # node:test via tsx
pnpm lint
pnpm typecheck

Contributing

Contributions are welcome — see CONTRIBUTING.md for setup, project layout, and the checks to run before opening a PR.

License

MIT © Mohit Yadav