attachpage 0.1.0 → 0.1.2

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 JP Technology Services
+Copyright (c) 2026 JP Technology Services LLC
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -2,9 +2,10 @@
 
 Send a website like an attachment. Point it at a folder with an `index.html`; get a link.
 
-AttachPage is in an invite-only private beta. Sign in once with an invited account:
+Sign in once with your Google or Microsoft account:
 
 ```bash
+npx attachpage connect                                 # add AttachPage to Claude Code, Codex, Cursor, VS Code, Gemini CLI
 npx attachpage login                                   # approve in your browser, once
 npx attachpage ./dist                                  # publish (private by default)
 npx attachpage send ./dist --to client@example.com --message "Here's the new version"
@@ -15,8 +16,8 @@ npx attachpage ./dist --site <pageId> --notify "Applied your feedback"
 Pages are private by default: only the people you send them to can open them, each with a
 personal link you can revoke. Recipients can comment on the page and approve it; `feedback`
 lists what they said with the element they pointed at, which is handy for agents. Add `--public`
-to make a page open to anyone with the link. Publishing without an account (public pages that
-expire after 48 hours) is paused during the beta.
+to make a page open to anyone with the link. Without signing in, `npx attachpage ./dist` publishes a
+public page that expires after 48 hours and prints a link to keep it.
 
 - No dependencies, Node 18+.
 - Your files are uploaded exactly as they are. Nothing is built, bundled or rewritten.
@@ -48,3 +49,12 @@ Setup for Claude, ChatGPT, Cursor, VS Code and Codex: https://attachpage.com/age
 Agent instructions: https://attachpage.com/skill.md.
 
 Support: support@attachpage.com. MIT licensed, by JP Technology Services.
+
+## Connect your AI apps
+
+`npx attachpage connect` adds the AttachPage MCP server (`https://attachpage.com/mcp`) to the AI apps
+it finds: Claude Code, OpenAI Codex and Gemini CLI through their own commands, and Cursor and VS Code
+through their user config files (backed up first; existing entries and files it cannot parse are left
+alone). `--dry-run` shows what it would change; `--client cursor,vscode` limits it to some apps. Each
+app asks you to sign in to AttachPage the first time you use it.
+

package/bin/attachpage.mjs

@@ -2,10 +2,11 @@
 /**
  * AttachPage command line: publish a folder, send it to people, read their feedback.
  *
- *   npx attachpage ./dist                      publish as you (anonymous 48 h pages are paused in the beta)
+ *   npx attachpage ./dist                      publish (signed in: private; signed out: public for 48 h)
  *   npx attachpage send ./dist --to a@b.com    publish privately and email personal links
  *   npx attachpage login                       sign in from the terminal (approve in your browser)
  *   npx attachpage feedback <siteId>           what recipients said (open items)
+ *   npx attachpage connect                     add AttachPage to the AI apps on this computer
  *
  * No dependencies. Credentials: ATTACHPAGE_API_KEY, or the key `login` saved in the operating system's
  * password store (or in ~/.attachpage/credentials with `login --store file`).
@@ -15,7 +16,7 @@ import { chmod, mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/pr
 import { homedir } from "node:os";
 import { dirname, join, relative, resolve, sep } from "node:path";
 
-const VERSION = "0.1.0";
+const VERSION = "0.1.1";
 const CREDENTIALS = process.env.ATTACHPAGE_CREDENTIALS_FILE || join(homedir(), ".attachpage", "credentials");
 const SKIP_DIRS = new Set([".git", "node_modules", ".svn", ".hg"]);
 const SKIP_FILES = new Set([".DS_Store", "Thumbs.db", "desktop.ini"]);
@@ -404,9 +405,7 @@ async function publish({ send = false } = {}) {
     const anon = await api(origin, "POST", "/api/v1/anonymous/publish", {
       body: { siteName: name, slug, files: manifest },
     }).catch((e) =>
-      fail(
-        e.status === 403 ? `${e.message}\nSign in with an invited account: npx attachpage login` : e.message,
-      ),
+      fail(e.status === 403 ? `${e.message}\nSign in to publish: npx attachpage login` : e.message),
     );
     await uploadAll(anon.targets, files, anon.uploadToken, origin);
     const fin = await api(origin, "POST", anon.next, { key: anon.uploadToken, body: {} });
@@ -562,17 +561,186 @@ async function whoami() {
   });
 }
 
+// ---------- connect ----------
+//
+// Add the AttachPage MCP server to the AI apps on this computer. Apps with their own command line
+// (Claude Code, Codex, Gemini CLI) are set up through it; Cursor and VS Code through their user
+// config file, backed up first. Existing AttachPage entries are left alone, and a file that cannot be
+// read as plain JSON is never rewritten (the snippet to paste is printed instead).
+
+const CONNECT_HOME = process.env.ATTACHPAGE_CONNECT_HOME || homedir();
+
+/** Run an app's own CLI. Windows npm shims are .cmd files, which need a shell; every argument is a
+ * fixed token or the validated server URL, so nothing needs quoting. */
+function runCli(bin, args) {
+  return new Promise((done) => {
+    let child;
+    try {
+      child = spawn(bin, args, {
+        stdio: ["ignore", "pipe", "pipe"],
+        shell: process.platform === "win32",
+        windowsHide: true,
+      });
+    } catch {
+      return done({ code: -1, missing: true, out: "" });
+    }
+    let out = "";
+    child.stdout.on("data", (d) => {
+      out += d;
+    });
+    child.stderr.on("data", (d) => {
+      out += d;
+    });
+    child.on("error", () => done({ code: -1, missing: true, out }));
+    child.on("close", (code) =>
+      done({ code: code ?? -1, missing: code === 9009 || /not recognized|not found/i.test(out), out }),
+    );
+  });
+}
+
+async function readJsonFile(file) {
+  try {
+    return { ok: true, data: JSON.parse(await readFile(file, "utf8")) };
+  } catch (e) {
+    return e.code === "ENOENT" ? { ok: true, data: {} } : { ok: false };
+  }
+}
+
+async function dirExists(dir) {
+  try {
+    return (await stat(dir)).isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+/** Add `entry` under `root[key].attachpage` in a JSON config file. */
+async function addToJsonConfig(file, key, entry, dryRun) {
+  const read = await readJsonFile(file);
+  if (!read.ok)
+    return {
+      status: "manual",
+      note: `could not read ${file} as plain JSON; add this yourself:\n${JSON.stringify({ [key]: { attachpage: entry } }, null, 2)}`,
+    };
+  const data = read.data && typeof read.data === "object" ? read.data : {};
+  if (data[key]?.attachpage) return { status: "already" };
+  if (dryRun) return { status: "would-add", note: file };
+  try {
+    const existing = await readFile(file, "utf8");
+    await writeFile(`${file}.bak-attachpage`, existing, { flag: "wx" }).catch(() => {});
+  } catch {
+    /* new file */
+  }
+  data[key] = { ...(data[key] ?? {}), attachpage: entry };
+  await mkdir(dirname(file), { recursive: true });
+  await writeFile(file, `${JSON.stringify(data, null, 2)}\n`);
+  return { status: "added", note: file };
+}
+
+function vscodeUserDir() {
+  if (process.platform === "win32")
+    return join(process.env.APPDATA || join(CONNECT_HOME, "AppData", "Roaming"), "Code", "User");
+  if (process.platform === "darwin")
+    return join(CONNECT_HOME, "Library", "Application Support", "Code", "User");
+  return join(CONNECT_HOME, ".config", "Code", "User");
+}
+
+async function connect() {
+  const { origin } = await readCredentials();
+  if (!SAFE.test(origin)) fail("That --origin cannot be used here.");
+  const url = `${origin}/mcp`;
+  const dryRun = flags.has("dry-run");
+  const only = typeof flags.get("client") === "string" ? String(flags.get("client")).split(",") : null;
+  const viaCli = [
+    {
+      id: "claude-code",
+      name: "Claude Code",
+      bin: "claude",
+      args: ["mcp", "add", "--transport", "http", "--scope", "user", "attachpage", url],
+      next: "In Claude Code, run /mcp and sign in to AttachPage.",
+    },
+    {
+      id: "codex",
+      name: "OpenAI Codex",
+      bin: "codex",
+      args: ["mcp", "add", "attachpage", "--url", url],
+      next: "Run: codex mcp login attachpage",
+    },
+    {
+      id: "gemini",
+      name: "Gemini CLI",
+      bin: "gemini",
+      args: ["mcp", "add", "--transport", "http", "attachpage", url],
+      next: "In Gemini CLI, run /mcp auth attachpage.",
+    },
+  ];
+  const results = [];
+  for (const c of viaCli) {
+    if (only && !only.includes(c.id)) continue;
+    const probe = await runCli(c.bin, ["--version"]);
+    if (probe.missing || probe.code !== 0) {
+      results.push({ app: c.name, status: "not-found" });
+      continue;
+    }
+    if (dryRun) {
+      results.push({ app: c.name, status: "would-add", note: `${c.bin} ${c.args.join(" ")}` });
+      continue;
+    }
+    const r = await runCli(c.bin, c.args);
+    if (r.code === 0) results.push({ app: c.name, status: "added", note: c.next });
+    else if (/already exists|already configured|already added/i.test(r.out))
+      results.push({ app: c.name, status: "already" });
+    else results.push({ app: c.name, status: "failed", note: r.out.trim().split("\n").slice(-1)[0] });
+  }
+  if (!only || only.includes("cursor")) {
+    const dir = join(CONNECT_HOME, ".cursor");
+    results.push(
+      (await dirExists(dir))
+        ? { app: "Cursor", ...(await addToJsonConfig(join(dir, "mcp.json"), "mcpServers", { url }, dryRun)) }
+        : { app: "Cursor", status: "not-found" },
+    );
+  }
+  if (!only || only.includes("vscode")) {
+    const dir = vscodeUserDir();
+    results.push(
+      (await dirExists(dir))
+        ? {
+            app: "VS Code",
+            ...(await addToJsonConfig(join(dir, "mcp.json"), "servers", { type: "http", url }, dryRun)),
+          }
+        : { app: "VS Code", status: "not-found" },
+    );
+  }
+  const label = {
+    added: "added",
+    already: "already set up",
+    "would-add": "would add",
+    "not-found": "not installed",
+    manual: "needs a manual step",
+    failed: "failed",
+  };
+  const lines = results.map((r) => `  ${r.app.padEnd(14)} ${label[r.status]}${r.note ? `: ${r.note}` : ""}`);
+  lines.push(
+    "",
+    `Server: ${url}`,
+    "Each app asks you to sign in to AttachPage the first time you use it.",
+    "Claude and ChatGPT on the web: Settings > Connectors > Add custom connector, with the server above.",
+  );
+  out(lines.join("\n"), { server: url, dryRun, results });
+}
+
 const HELP = `attachpage ${VERSION}: send websites like attachments
 
 Usage
   attachpage <folder> [--name "Q3 report"] [--slug q3-report] [--public] [--site <id> [--notify "note"]]
   attachpage send <folder> --to a@b.com,c@d.com [--message "..."] [--expires 7]
   attachpage login [--no-browser] [--store file] | logout | whoami
+  attachpage connect [--client claude-code,codex,gemini,cursor,vscode] [--dry-run]
   attachpage feedback <siteId> [--all]
 
-AttachPage is an invite-only private beta: run \`attachpage login\` with an invited account.
-Pages are private by default: only the people you send them to can open them.
-(Publishing without an account, as public 48-hour pages, is paused during the beta.)
+Sign in once with \`attachpage login\` (Google or Microsoft account). Signed-in pages are private by
+default: only the people you send them to can open them. Without signing in, a folder is published
+as a public page that expires in 48 hours, with a link to keep it.
 Options: --json for machine-readable output, --origin to use another server.
 \`login\` keeps the key in your system's password store (Windows Credential Manager, macOS Keychain,
 or the Linux keyring); --store file keeps it in ~/.attachpage/credentials instead.`;
@@ -584,6 +752,7 @@ try {
   else if (command === "login") await login();
   else if (command === "logout") await logout();
   else if (command === "whoami") await whoami();
+  else if (command === "connect") await connect();
   else if (command === "feedback") await feedback();
   else if (command === "send") await publish({ send: true });
   else await publish();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "attachpage",
-  "version": "0.1.0",
-  "description": "Send websites like attachments: publish a folder, email personal links, read feedback. Command line for AttachPage (invite-only private beta).",
+  "version": "0.1.2",
+  "description": "Send websites like attachments: publish a folder, email personal links, read feedback. Command line for AttachPage.",
   "keywords": [
     "publish",
     "static-site",
@@ -12,11 +12,16 @@
     "attachpage"
   ],
   "homepage": "https://attachpage.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/colossalbreacker/attachpage-skill.git",
+    "directory": "cli"
+  },
   "bugs": {
     "email": "support@attachpage.com"
   },
   "license": "MIT",
-  "author": "JP Technology Services (https://jptechnologyservices.com)",
+  "author": "JP Technology Services LLC (https://jptechnologyservices.com)",
   "type": "module",
   "bin": {
     "attachpage": "bin/attachpage.mjs"
@@ -25,7 +30,7 @@
     "bin/attachpage.mjs"
   ],
   "scripts": {
-    "test": "node --test test/credentials.test.mjs"
+    "test": "node --test test/credentials.test.mjs test/connect.test.mjs"
   },
   "engines": {
     "node": ">=18"