integrationsdotsh 0.0.1-beta.0

package/README.md

@@ -0,0 +1,38 @@
+# integrations
+
+The CLI for [integrations.sh](https://integrations.sh) — the registry of agent
+integrations. Search the catalog and read everything a domain exposes
+(MCP · REST · GraphQL · CLI) without leaving the terminal.
+
+## Install
+
+```sh
+npm i -g integrationsdotsh   # command is `integrations`
+# or
+brew install integrations    # (planned)
+```
+
+## Usage
+
+```sh
+integrations search slack       # search the catalog
+integrations stripe.com         # everything a domain exposes
+integrations notion             # fuzzy domain match
+
+integrations help
+integrations --version
+```
+
+Point at a different registry host (e.g. a local dev server):
+
+```sh
+INTEGRATIONS_BASE=http://localhost:4321 integrations search slack
+```
+
+## Planned
+
+- `integrations auth <domain>` — how to authenticate (credential primitives)
+- `integrations probe <domain>` — live-read a domain's `.well-known/` surface
+  (`ai-catalog.json`, `api-catalog`, `ai-plugin.json`, `llms.txt`)
+- `integrations add <domain>` — hand off to Executor
+- `--json` machine output

package/dist/cli.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+var VERSION = "0.0.1-beta.0";
+var BASE = (process.env.INTEGRATIONS_BASE ?? "https://integrations.sh").replace(/\/$/, "");
+var KIND_ORDER = ["mcp", "openapi", "graphql", "cli"];
+var TAG = { mcp: "mcp", openapi: "rest", graphql: "graphql", cli: "cli" };
+var SECTION = {
+  mcp: "MCP SERVERS",
+  openapi: "REST · OPENAPI",
+  graphql: "GRAPHQL",
+  cli: "CLI"
+};
+var useColor = process.stdout.isTTY && !process.env.NO_COLOR;
+var dim = (s) => useColor ? `\x1B[2m${s}\x1B[0m` : s;
+var bold = (s) => useColor ? `\x1B[1m${s}\x1B[0m` : s;
+function fail(msg) {
+  process.stderr.write(`integrations: ${msg}
+`);
+  process.exit(1);
+}
+async function loadRegistry() {
+  let res;
+  try {
+    res = await fetch(`${BASE}/api.json`, { headers: { accept: "application/json" } });
+  } catch {
+    return fail(`could not reach ${BASE}/api.json`);
+  }
+  if (!res.ok)
+    return fail(`${BASE}/api.json returned ${res.status}`);
+  return await res.json();
+}
+function groupByDomain(records) {
+  const groups = new Map;
+  for (const r of records) {
+    const d = r.domain || r.slug;
+    if (!d)
+      continue;
+    let g = groups.get(d);
+    if (!g) {
+      g = { domain: d, total: 0, kinds: new Set, records: [], pop: 0 };
+      groups.set(d, g);
+    }
+    g.total++;
+    g.kinds.add(r.kind);
+    g.records.push(r);
+    g.pop = Math.max(g.pop, r.popularity ?? 0);
+  }
+  return groups;
+}
+var formatsOf = (g) => KIND_ORDER.filter((k) => g.kinds.has(k)).map((k) => TAG[k]).join(" · ");
+var byPop = (a, b) => b.pop - a.pop || b.total - a.total || a.domain.localeCompare(b.domain);
+var clip = (s, n) => s.replace(/\s+/g, " ").slice(0, n);
+async function cmdSearch(query) {
+  if (!query)
+    fail("usage: integrations search <query>");
+  const q = query.toLowerCase();
+  const records = await loadRegistry();
+  const groups = [...groupByDomain(records).values()].filter((g) => g.domain.toLowerCase().includes(q) || g.records.some((r) => r.name.toLowerCase().includes(q) || (r.description ?? "").toLowerCase().includes(q))).sort(byPop);
+  if (groups.length === 0) {
+    process.stdout.write(dim(`no matches
+`));
+    return;
+  }
+  const LIMIT = 30;
+  const shown = groups.slice(0, LIMIT);
+  const pad = Math.min(28, Math.max(...shown.map((g) => g.domain.length)));
+  for (const g of shown) {
+    const desc = g.records.find((r) => r.description)?.description ?? "";
+    process.stdout.write(`${bold(g.domain.padEnd(pad))}  ${dim(formatsOf(g).padEnd(22))}  ${dim(clip(desc, 64))}
+`);
+  }
+  if (groups.length > LIMIT)
+    process.stdout.write(dim(`
+… ${groups.length - LIMIT} more — narrow your query
+`));
+}
+async function cmdDomain(term) {
+  const t = term.toLowerCase();
+  const records = await loadRegistry();
+  const groups = groupByDomain(records);
+  let g = groups.get(term);
+  if (!g) {
+    const cands = [...groups.values()].filter((x) => x.domain.toLowerCase().includes(t)).sort(byPop);
+    if (cands.length === 0)
+      fail(`no domain matching "${term}"`);
+    if (cands.length > 1 && cands[0].domain.toLowerCase() !== t) {
+      process.stdout.write(dim(`did you mean:
+`));
+      for (const c of cands.slice(0, 8))
+        process.stdout.write(`  ${c.domain}  ${dim(formatsOf(c))}
+`);
+      return;
+    }
+    g = cands[0];
+  }
+  process.stdout.write(`
+${bold(g.domain)} ${dim(`— ${g.total} integration${g.total === 1 ? "" : "s"}`)}
+`);
+  for (const kind of KIND_ORDER) {
+    const items = g.records.filter((r) => r.kind === kind).sort((a, b) => (b.popularity ?? 0) - (a.popularity ?? 0) || a.name.localeCompare(b.name));
+    if (items.length === 0)
+      continue;
+    process.stdout.write(`
+${dim(SECTION[kind])}
+`);
+    for (const r of items) {
+      const desc = r.description ? dim("  " + clip(r.description, 60)) : "";
+      process.stdout.write(`  ${r.name}${desc}  ${dim(`${BASE}/${r.kind}/${r.slug}/`)}
+`);
+    }
+  }
+  process.stdout.write(`
+`);
+}
+function help() {
+  process.stdout.write(`integrations — the registry of agent integrations (integrations.sh)
+
+usage:
+  integrations search <query>     search the catalog
+  integrations <domain>           show everything a domain exposes
+  integrations help               show this help
+  integrations --version          print version
+
+examples:
+  integrations search slack
+  integrations stripe.com
+  integrations notion
+
+env:
+  INTEGRATIONS_BASE   registry host (default https://integrations.sh)
+`);
+}
+async function main() {
+  const [, , cmd, ...rest] = process.argv;
+  if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h")
+    return help();
+  if (cmd === "--version" || cmd === "-v")
+    return void process.stdout.write(`${VERSION}
+`);
+  if (cmd === "search")
+    return cmdSearch(rest.join(" "));
+  return cmdDomain(cmd);
+}
+main().catch((e) => fail(e?.message ?? String(e)));

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "integrationsdotsh",
+  "version": "0.0.1-beta.0",
+  "description": "CLI for integrations.sh — search the registry of agent integrations and read a domain's surface.",
+  "type": "module",
+  "bin": {
+    "integrations": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "bun build src/cli.ts --target node --outdir dist && chmod +x dist/cli.js",
+    "dev": "bun run src/cli.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "integrations",
+    "mcp",
+    "openapi",
+    "graphql",
+    "agents",
+    "registry",
+    "cli"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  }
+}