uplink-cli 0.2.6 → 0.2.7

package/AGENTS.md

@@ -127,6 +127,8 @@ uplink domains providers connect hostinger --token-env HOSTINGER_API_TOKEN --jso
 uplink domains providers connect dreamhost --token-env DREAMHOST_API_KEY --json
 uplink domains providers connect namecheap --token-env NAMECHEAP_API_KEY --user-env NAMECHEAP_API_USER --json
 uplink domains providers connect cpanel --host server341.web-hosting.com --user-env CPANEL_USER --token-env CPANEL_API_TOKEN --json
+# Repeat connect with another --host to add more cPanel accounts; remove one with:
+uplink domains providers disconnect cpanel --host server341.web-hosting.com --json
 uplink domains providers list --json
 uplink domains providers disconnect godaddy --json
 

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.2.7 — 2026-08-31
+
+Multiple **cPanel** accounts: `providers connect cpanel --host …` now appends (people have sites on several hosts), `providers disconnect cpanel --host …` removes one account, and `providers list` shows the connected hosts. One user, many shared hosts, one inventory.
+
 ## 0.2.6 — 2026-08-30
 
 Uplink as a **domain hub**: connect any **cPanel** host (Namecheap shared, Bluehost, HostGator, and most shared hosting) alongside registrars, so domains and sites scattered across providers land in one `domains list`. Connect with `uplink domains providers connect cpanel --host server.example.com --user-env CPANEL_USER --token-env CPANEL_API_TOKEN` (token from cPanel → Security → Manage API Tokens), or through the menu under Domains → Connect registrar.

package/cli/src/registrars/cpanel.ts

@@ -1,4 +1,9 @@
-import type { InventoryDomain, RegistrarAdapter, RegistrarCredentials } from "./types";
+import type {
+  CpanelAccount,
+  InventoryDomain,
+  RegistrarAdapter,
+  RegistrarCredentials,
+} from "./types";
 
 /**
  * cPanel is not a registrar, but it is where many people's sites actually
@@ -9,6 +14,9 @@ import type { InventoryDomain, RegistrarAdapter, RegistrarCredentials } from "./
  *
  * Auth: a cPanel API token (Security → Manage API Tokens in the panel),
  * sent as `Authorization: cpanel user:token` to the UAPI on port 2083.
+ *
+ * A user can connect several cPanel accounts (different hosts); each
+ * `providers connect cpanel --host …` appends to `creds.accounts`.
  */
 
 type UapiResponse = {
@@ -31,41 +39,65 @@ export function normalizeCpanelHost(raw: string): string {
   return host;
 }
 
-function baseUrl(creds: RegistrarCredentials): string {
-  const host = normalizeCpanelHost(creds.host || "");
+/** All connected cPanel accounts, including the legacy single-account shape. */
+export function cpanelAccountsOf(creds: RegistrarCredentials): CpanelAccount[] {
+  const accounts: CpanelAccount[] = [];
+  const push = (account: { host?: string; apiUser?: string; token?: string }) => {
+    if (!account.host || !account.apiUser || !account.token) return;
+    const host = normalizeCpanelHost(account.host);
+    if (accounts.some((a) => a.host === host && a.apiUser === account.apiUser)) return;
+    accounts.push({ host, apiUser: account.apiUser, token: account.token });
+  };
+  for (const account of creds.accounts || []) push(account);
+  push(creds);
+  return accounts;
+}
+
+/** Merge a newly verified account into stored creds (replace same host+user). */
+export function mergeCpanelCredentials(
+  existing: RegistrarCredentials | undefined,
+  incoming: RegistrarCredentials
+): RegistrarCredentials {
+  const merged: CpanelAccount[] = existing ? cpanelAccountsOf(existing) : [];
+  for (const account of cpanelAccountsOf(incoming)) {
+    const at = merged.findIndex((a) => a.host === account.host && a.apiUser === account.apiUser);
+    if (at >= 0) merged[at] = account;
+    else merged.push(account);
+  }
+  return { accounts: merged };
+}
+
+function baseUrl(host: string): string {
   return host.includes(":") ? `https://${host}` : `https://${host}:2083`;
 }
 
-async function uapi(creds: RegistrarCredentials, module: string, fn: string): Promise<unknown> {
-  const user = creds.apiUser || "";
-  const token = creds.token || "";
-  if (!user || !token) throw new Error("cPanel needs a username and an API token");
-  const url = `${baseUrl(creds)}/execute/${module}/${fn}`;
+async function uapi(account: CpanelAccount, module: string, fn: string): Promise<unknown> {
+  const url = `${baseUrl(account.host)}/execute/${module}/${fn}`;
   let res: Response;
   try {
     res = await fetch(url, {
       headers: {
-        Authorization: `cpanel ${user}:${token}`,
+        Authorization: `cpanel ${account.apiUser}:${account.token}`,
         Accept: "application/json",
       },
     });
   } catch (error) {
     const detail = error instanceof Error ? error.message : String(error);
-    throw new Error(`Could not reach cPanel at ${baseUrl(creds)} (${detail})`);
+    throw new Error(`Could not reach cPanel at ${baseUrl(account.host)} (${detail})`);
   }
   if (res.status === 401 || res.status === 403) {
-    throw new Error("cPanel rejected the credentials (check username and API token)");
+    throw new Error(`cPanel at ${account.host} rejected the credentials (check username and API token)`);
   }
   const text = await res.text();
   let body: UapiResponse;
   try {
     body = text ? (JSON.parse(text) as UapiResponse) : {};
   } catch {
-    throw new Error(`cPanel returned a non-JSON response (HTTP ${res.status})`);
+    throw new Error(`cPanel at ${account.host} returned a non-JSON response (HTTP ${res.status})`);
   }
   if (!res.ok || body.status !== 1) {
     const detail = body.errors?.filter(Boolean).join("; ") || `HTTP ${res.status}`;
-    throw new Error(`cPanel ${module}/${fn} failed: ${detail}`);
+    throw new Error(`cPanel ${module}/${fn} failed on ${account.host}: ${detail}`);
   }
   return body.data;
 }
@@ -75,20 +107,35 @@ function stringsOf(value: unknown): string[] {
   return value.filter((item): item is string => typeof item === "string" && item.includes("."));
 }
 
+async function listAccountDomains(account: CpanelAccount): Promise<string[]> {
+  const data = (await uapi(account, "DomainInfo", "list_domains")) as Record<string, unknown> | null;
+  const out: string[] = [];
+  const main = data?.main_domain;
+  if (typeof main === "string" && main.includes(".")) out.push(main);
+  out.push(...stringsOf(data?.addon_domains));
+  out.push(...stringsOf(data?.parked_domains));
+  return out;
+}
+
 async function listHostedDomains(creds: RegistrarCredentials): Promise<InventoryDomain[]> {
-  const data = (await uapi(creds, "DomainInfo", "list_domains")) as Record<string, unknown> | null;
+  const accounts = cpanelAccountsOf(creds);
+  if (accounts.length === 0) throw new Error("cPanel needs a host, username, and API token");
   const out: InventoryDomain[] = [];
   const seen = new Set<string>();
-  const push = (domain: string) => {
-    const normalized = domain.toLowerCase();
-    if (seen.has(normalized)) return;
-    seen.add(normalized);
-    out.push({ domain: normalized, provider: "cpanel", status: "owned" });
-  };
-  const main = data?.main_domain;
-  if (typeof main === "string" && main.includes(".")) push(main);
-  for (const domain of stringsOf(data?.addon_domains)) push(domain);
-  for (const domain of stringsOf(data?.parked_domains)) push(domain);
+  const errors: string[] = [];
+  for (const account of accounts) {
+    try {
+      for (const domain of await listAccountDomains(account)) {
+        const normalized = domain.toLowerCase();
+        if (seen.has(normalized)) continue;
+        seen.add(normalized);
+        out.push({ domain: normalized, provider: "cpanel", status: "owned" });
+      }
+    } catch (error) {
+      errors.push(error instanceof Error ? error.message : String(error));
+    }
+  }
+  if (out.length === 0 && errors.length > 0) throw new Error(errors.join("; "));
   return out;
 }
 
@@ -96,12 +143,18 @@ export const cpanelAdapter: RegistrarAdapter = {
   id: "cpanel",
   label: "cPanel hosting",
   connectHelp:
-    "Any cPanel host (Namecheap shared, Bluehost, HostGator, …). --host server.example.com --user-env CPANEL_USER --token-env CPANEL_API_TOKEN (token: cPanel → Security → Manage API Tokens)",
+    "Any cPanel host (Namecheap shared, Bluehost, HostGator, …). --host server.example.com --user-env CPANEL_USER --token-env CPANEL_API_TOKEN (token: cPanel → Security → Manage API Tokens). Repeat with another --host to add more accounts.",
   async verify(creds) {
-    if (!creds.host) throw new Error("cPanel needs --host (e.g. server341.web-hosting.com)");
-    creds.host = normalizeCpanelHost(creds.host);
-    await listHostedDomains(creds);
-    return creds;
+    // Verify only the incoming account(s); the connect flow merges them
+    // into any previously stored accounts afterwards.
+    const accounts = cpanelAccountsOf(creds);
+    if (accounts.length === 0) {
+      throw new Error("cPanel needs --host (e.g. server341.web-hosting.com), a username, and an API token");
+    }
+    for (const account of accounts) {
+      await listAccountDomains(account);
+    }
+    return { accounts };
   },
   async listDomains(creds) {
     const domains = await listHostedDomains(creds);
@@ -114,6 +167,6 @@ export const cpanelAdapter: RegistrarAdapter = {
     if (hosted.some((item) => item.domain === domain.toLowerCase())) {
       return { domain, provider: "cpanel", status: "owned", buyable: false };
     }
-    throw new Error("cPanel only knows domains hosted on the connected account");
+    throw new Error("cPanel only knows domains hosted on the connected accounts");
   },
 };

package/cli/src/registrars/types.ts

@@ -5,6 +5,12 @@ export function isProviderId(value: string): value is ProviderId {
   return (PROVIDER_IDS as readonly string[]).includes(value);
 }
 
+export type CpanelAccount = {
+  host: string;
+  apiUser: string;
+  token: string;
+};
+
 export type RegistrarCredentials = {
   token?: string;
   apiUser?: string;
@@ -14,6 +20,8 @@ export type RegistrarCredentials = {
   host?: string;
   /** Additional API keys for providers with multiple accounts (e.g. DreamHost). */
   extraTokens?: string[];
+  /** Multiple cPanel accounts — people often have sites on several hosts. */
+  accounts?: CpanelAccount[];
 };
 
 export type InventoryDomain = {

package/cli/src/subcommands/domains.ts

@@ -15,6 +15,7 @@ import {
   type RegistrarCredentials,
 } from "../registrars";
 import { canPrompt, promptSecret, readEnvValue } from "../registrars/secret";
+import { cpanelAccountsOf, mergeCpanelCredentials, normalizeCpanelHost } from "../registrars/cpanel";
 import {
   checkDomainAvailability,
   formatPublicAvailability,
@@ -569,18 +570,25 @@ providers
   .action((opts) => {
     try {
       const store = readRegistrarStore();
-      const items = adapters.map((adapter) => ({
-        id: adapter.id,
-        label: adapter.label,
-        connected: Boolean(store[adapter.id]),
-        help: adapter.connectHelp,
-      }));
+      const items = adapters.map((adapter) => {
+        const creds = store[adapter.id];
+        const cpanelHosts =
+          adapter.id === "cpanel" && creds ? cpanelAccountsOf(creds).map((a) => a.host) : undefined;
+        return {
+          id: adapter.id,
+          label: adapter.label,
+          connected: Boolean(creds),
+          ...(cpanelHosts ? { hosts: cpanelHosts } : {}),
+          help: adapter.connectHelp,
+        };
+      });
       if (opts.json) {
         printJson({ providers: items });
         return;
       }
       for (const item of items) {
-        console.log(`- ${item.id}  ${item.connected ? "connected" : "not connected"}`);
+        const hosts = item.hosts?.length ? ` (${item.hosts.join(", ")})` : "";
+        console.log(`- ${item.id}  ${item.connected ? `connected${hosts}` : "not connected"}`);
         if (!item.connected) console.log(`    ${item.help}`);
       }
     } catch (error) {
@@ -606,7 +614,13 @@ providers
       const adapter = getAdapter(provider);
       const creds = await credentialsFromFlags(provider, opts);
       const verified = await adapter.verify(creds);
-      saveProvider(provider, verified);
+      // cPanel accumulates accounts (people have sites on several hosts);
+      // other providers replace the stored credential.
+      const toSave =
+        provider === "cpanel"
+          ? mergeCpanelCredentials(readRegistrarStore().cpanel, verified)
+          : verified;
+      saveProvider(provider, toSave);
       const listed = await adapter.listDomains(verified).catch(() => [] as InventoryDomain[]);
       if (opts.json) {
         printJson({
@@ -626,11 +640,28 @@ providers
   .command("disconnect")
   .description("Remove a saved registrar or cPanel credential")
   .argument("<provider>", "godaddy | cloudflare | hostinger | namecheap | dreamhost | cpanel")
+  .option("--host <hostname>", "cPanel only: remove just this host's account")
   .option("--json", "Output JSON", false)
   .action((providerArg: string, opts) => {
     try {
       const provider = String(providerArg).toLowerCase();
       if (!isProviderId(provider)) throw new Error(`Unknown provider: ${providerArg}`);
+
+      if (provider === "cpanel" && opts.host) {
+        const host = normalizeCpanelHost(String(opts.host));
+        const existing = readRegistrarStore().cpanel;
+        const accounts = existing ? cpanelAccountsOf(existing).filter((a) => a.host !== host) : [];
+        const removed = existing ? cpanelAccountsOf(existing).length !== accounts.length : false;
+        if (accounts.length === 0) removeProvider(provider);
+        else saveProvider(provider, { accounts });
+        if (opts.json) {
+          printJson({ provider, host, removed, remainingAccounts: accounts.length });
+          return;
+        }
+        console.log(removed ? `Removed cPanel account on ${host}` : `No cPanel account on ${host}`);
+        return;
+      }
+
       const removed = removeProvider(provider);
       if (opts.json) {
         printJson({ provider, connected: false, removed });

package/docs/AGENTS.md

@@ -127,6 +127,8 @@ uplink domains providers connect hostinger --token-env HOSTINGER_API_TOKEN --jso
 uplink domains providers connect dreamhost --token-env DREAMHOST_API_KEY --json
 uplink domains providers connect namecheap --token-env NAMECHEAP_API_KEY --user-env NAMECHEAP_API_USER --json
 uplink domains providers connect cpanel --host server341.web-hosting.com --user-env CPANEL_USER --token-env CPANEL_API_TOKEN --json
+# Repeat connect with another --host to add more cPanel accounts; remove one with:
+uplink domains providers disconnect cpanel --host server341.web-hosting.com --json
 uplink domains providers list --json
 uplink domains providers disconnect godaddy --json
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uplink-cli",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Software for agents — share localhost, host apps, and attach domains from the terminal. JSON-first CLI for Cursor, Claude, Codex, and Windsurf.",
   "keywords": [
     "ai-agents",