@koolink/koolink 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KooLink
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,83 @@
+# koolink
+
+Shorten any URL to a clean `kool.ink/xyz` link from your terminal. **Free, unlimited, no signup.** AI-agent ready.
+
+```bash
+npx @koolink/koolink https://example.com/very/long/path
+# → https://kool.ink/abc123
+```
+
+## Install
+
+```bash
+# one-off (no install)
+npx @koolink/koolink https://example.com
+
+# or install globally
+npm install -g @koolink/koolink
+koolink https://example.com
+```
+
+## Usage
+
+```bash
+# Shorten a URL (prints the short link, copies to clipboard on desktop)
+koolink https://example.com/very/long/path
+
+# Shorten from stdin (great for piping)
+echo "https://example.com" | koolink
+
+# Shorten a batch
+cat urls.txt | xargs -I{} koolink {}
+```
+
+| Flag | Description |
+|---|---|
+| `--help` / `-h` | Show help |
+| `--version` / `-v` | Show version |
+
+## Install as an MCP server
+
+Point any MCP client (Claude Desktop, Cursor, Windsurf, etc.) at the hosted MCP server at `https://mcp.kool.ink` — no API key required for anonymous shortening.
+
+```json
+{
+  "mcpServers": {
+    "koolink": {
+      "url": "https://mcp.kool.ink"
+    }
+  }
+}
+```
+
+## Tools
+
+This server exposes the following MCP tools:
+
+| Tool | Description | Input |
+|---|---|---|
+| `shorten_url` | Shorten a long URL and return a compact kool.ink short link. | `{ "url": "<long-url>" }` |
+
+## Why KooLink
+
+- **Free forever** — no account, no credit card, no limits
+- **Clean, memorable URLs** — `kool.ink/xyz`, not `bit.ly/4xdK9qZ`
+- **AI-agent ready** — same service over MCP at `https://mcp.kool.ink`, or the REST API
+- **Analytics** — every link is click-tracked with bot traffic filtered out
+- **Creator Earning Programme** — as traffic grows, you earn
+
+## API
+
+The CLI calls the public anonymous endpoint:
+
+```bash
+curl -X POST https://kool.ink/api/links \
+  -H "Content-Type: application/json" \
+  -d '{"url":"https://example.com"}'
+```
+
+For AI agents, use the MCP server at `https://mcp.kool.ink` (no API key needed for anonymous shortening).
+
+## License
+
+MIT

package/bin/koolink.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+/**
+ * koolink — shorten any URL to a clean kool.ink link from your terminal.
+ *
+ * Usage:
+ *   koolink <url>            Shorten a URL
+ *   echo <url> | koolink     Shorten from stdin
+ *   koolink --help           Show help
+ *   koolink --version        Show version
+ *
+ * Free, unlimited, no signup. Uses the public anonymous kool.ink API.
+ */
+
+const API_URL = "https://kool.ink/api/links";
+const SITE_URL = "https://kool.ink";
+
+// Prevent self-shortening: never shorten a link that already points at kool.ink.
+function isKoolinkUrl(url) {
+  try {
+    const u = new URL(url);
+    return /(^|\.)kool\.ink$/i.test(u.hostname) || /(^|\.)kool\.ink:/i.test(u.hostname);
+  } catch {
+    return false;
+  }
+}
+
+function isValidUrl(url) {
+  try {
+    const u = new URL(url);
+    return u.protocol === "http:" || u.protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+
+async function shorten(url) {
+  const res = await fetch(API_URL, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ url }),
+  });
+  if (!res.ok) {
+    let msg = `API error ${res.status}`;
+    try {
+      const j = await res.json();
+      if (j.error) msg = j.error;
+      else if (j.message) msg = j.message;
+    } catch {}
+    throw new Error(msg);
+  }
+  const data = await res.json();
+  return data.shortUrl || data.url || API_URL;
+}
+
+async function copy(text) {
+  // Best-effort: copy to clipboard if available (not on all platforms/CI).
+  if (!process.stdout.isTTY) return;
+  try {
+    const { execSync } = require("child_process");
+    if (process.platform === "darwin") execSync("pbcopy", { input: text });
+    else if (process.platform === "win32") execSync("clip", { input: text });
+    else if (process.platform === "linux") {
+      try { execSync("xclip", { input: text }, { stdio: "ignore" }); }
+      catch { try { execSync("xsel -b", { input: text }, { stdio: "ignore" }); } catch {} }
+    }
+  } catch {}
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(`koolink — shorten any URL to a clean kool.ink link
+
+Usage:
+  koolink <url>              Shorten a URL
+  echo <url> | koolink       Shorten from stdin
+  koolink --help             Show this help
+  koolink --version          Show version
+
+Examples:
+  koolink https://example.com/very-long/path
+  echo "https://example.com" | koolink
+  cat urls.txt | xargs -I{} koolink {}
+
+Free, unlimited, no signup. AI-agent ready: https://mcp.kool.ink`);
+    return;
+  }
+
+  if (args.includes("--version") || args.includes("-v")) {
+    const pkg = require("../package.json");
+    console.log(pkg.version);
+    return;
+  }
+
+  // Resolve the URL: first non-flag arg, else stdin.
+  // Reject the known info flags first so "koolink --help" etc. still work.
+  let url = args.find((a) => !a.startsWith("-"));
+  if (!url) {
+    // Read from stdin (piped).
+    const stdin = await new Promise((resolve) => {
+      let buf = "";
+      process.stdin.setEncoding("utf8");
+      process.stdin.on("data", (d) => (buf += d));
+      process.stdin.on("end", () => resolve(buf.trim()));
+    });
+    url = stdin.split(/\s+/).find((s) => s.startsWith("http"));
+  }
+
+  if (!url) {
+    console.error("Error: no URL provided. Usage: koolink <url>  (or pipe: echo <url> | koolink)");
+    process.exit(1);
+  }
+
+  if (!isValidUrl(url)) {
+    console.error(`Error: "${url}" is not a valid http(s) URL.`);
+    process.exit(1);
+  }
+
+  if (isKoolinkUrl(url)) {
+    console.error(`Error: "${url}" already points at kool.ink. Nothing to shorten.`);
+    process.exit(1);
+  }
+
+  try {
+    const short = await shorten(url);
+    console.log(short);
+    await copy(short);
+    if (process.stdout.isTTY) {
+      process.stderr.write(`\n✓ Copied to clipboard → ${short}\n`);
+      process.stderr.write(`  (free, unlimited, no signup · ${SITE_URL})\n`);
+    }
+  } catch (e) {
+    console.error(`Error: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+main().catch((e) => {
+  console.error(`Error: ${e.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@koolink/koolink",
+  "version": "1.0.1",
+  "description": "Shorten any URL to a clean kool.ink link from your terminal. Free, unlimited, no signup. AI-agent ready.",
+  "bin": {
+    "koolink": "./bin/koolink.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "keywords": [
+    "url-shortener",
+    "shorten",
+    "short-link",
+    "shorturl",
+    "bitly",
+    "tinyurl",
+    "koolink",
+    "mcp",
+    "ai-agent",
+    "cli"
+  ],
+  "license": "MIT",
+  "author": "KooLink",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KooLink/koolink-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/KooLink/koolink-cli/issues"
+  },
+  "homepage": "https://kool.ink",
+  "publishConfig": {
+    "access": "public"
+  }
+}