@hasna/connectors 0.2.3 → 0.2.5

package/bin/serve.js

@@ -1,11 +1,28 @@
 #!/usr/bin/env bun
 // @bun
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
 var __require = import.meta.require;
 
 // src/server/serve.ts
-import { existsSync as existsSync4 } from "fs";
-import { join as join4, dirname as dirname3, extname } from "path";
+import { existsSync as existsSync4, readdirSync as readdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3, mkdirSync as mkdirSync3 } from "fs";
+import { join as join4, dirname as dirname3, extname, basename } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
+import { homedir as homedir2 } from "os";
 
 // src/lib/registry.ts
 import { existsSync, readFileSync } from "fs";
@@ -493,6 +510,70 @@ function getConnectorPath(name) {
   const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
   return join2(CONNECTORS_DIR, connectorName);
 }
+function installConnector(name, options = {}) {
+  const { targetDir = process.cwd(), overwrite = false } = options;
+  if (!/^[a-z0-9-]+$/.test(name)) {
+    return {
+      connector: name,
+      success: false,
+      error: `Invalid connector name '${name}'`
+    };
+  }
+  const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
+  const sourcePath = getConnectorPath(name);
+  const destDir = join2(targetDir, ".connectors");
+  const destPath = join2(destDir, connectorName);
+  if (!existsSync2(sourcePath)) {
+    return {
+      connector: name,
+      success: false,
+      error: `Connector '${name}' not found`
+    };
+  }
+  if (existsSync2(destPath) && !overwrite) {
+    return {
+      connector: name,
+      success: false,
+      error: `Already installed. Use --overwrite to replace.`,
+      path: destPath
+    };
+  }
+  try {
+    if (!existsSync2(destDir)) {
+      mkdirSync(destDir, { recursive: true });
+    }
+    cpSync(sourcePath, destPath, { recursive: true });
+    updateConnectorsIndex(destDir);
+    return {
+      connector: name,
+      success: true,
+      path: destPath
+    };
+  } catch (error) {
+    return {
+      connector: name,
+      success: false,
+      error: error instanceof Error ? error.message : "Unknown error"
+    };
+  }
+}
+function updateConnectorsIndex(connectorsDir) {
+  const indexPath = join2(connectorsDir, "index.ts");
+  const connectors = readdirSync(connectorsDir).filter((f) => f.startsWith("connect-") && !f.includes("."));
+  const exports = connectors.map((c) => {
+    const name = c.replace("connect-", "");
+    return `export * as ${name} from './${c}/src/index.js';`;
+  }).join(`
+`);
+  const content = `/**
+ * Auto-generated index of installed connectors
+ * Do not edit manually - run 'connectors install' to update
+ */
+
+${exports}
+`;
+  writeFileSync(indexPath, content);
+}
 function getInstalledConnectors(targetDir = process.cwd()) {
   const connectorsDir = join2(targetDir, ".connectors");
   if (!existsSync2(connectorsDir)) {
@@ -545,9 +626,20 @@ function parseEnvVarsTable(section) {
   }
   return vars;
 }
+function removeConnector(name, targetDir = process.cwd()) {
+  const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
+  const connectorsDir = join2(targetDir, ".connectors");
+  const connectorPath = join2(connectorsDir, connectorName);
+  if (!existsSync2(connectorPath)) {
+    return false;
+  }
+  rmSync(connectorPath, { recursive: true });
+  updateConnectorsIndex(connectorsDir);
+  return true;
+}
 
 // src/server/auth.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2, readdirSync as readdirSync2, rmSync as rmSync2, statSync as statSync2 } from "fs";
 import { randomBytes } from "crypto";
 import { homedir } from "os";
 import { join as join3 } from "path";
@@ -606,7 +698,7 @@ function getAuthType(name) {
 }
 function getConnectorConfigDir(name) {
   const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
-  return join3(homedir(), ".connect", connectorName);
+  return join3(homedir(), ".connectors", connectorName);
 }
 function getCurrentProfile(name) {
   const configDir = getConnectorConfigDir(name);
@@ -658,6 +750,8 @@ function getAuthStatus(name) {
     description: v.description,
     set: !!process.env[v.variable]
   }));
+  const envVarTotalCount = envVars.length;
+  const envVarSetCount = envVars.filter((v) => v.set).length;
   if (authType === "oauth") {
     const tokens = loadTokens(name);
     const config2 = loadProfileConfig(name);
@@ -669,7 +763,9 @@ function getAuthStatus(name) {
       configured: hasTokens || hasRefreshToken,
       tokenExpiry,
       hasRefreshToken,
-      envVars
+      envVars,
+      envVarSetCount,
+      envVarTotalCount
     };
   }
   const config = loadProfileConfig(name);
@@ -678,7 +774,9 @@ function getAuthStatus(name) {
   return {
     type: authType,
     configured: hasKey || hasEnvVar,
-    envVars
+    envVars,
+    envVarSetCount,
+    envVarTotalCount
   };
 }
 function saveApiKey(name, key, field) {
@@ -849,8 +947,65 @@ async function refreshOAuthToken(name) {
   saveOAuthTokens(name, tokens);
   return tokens;
 }
+function listProfiles(name) {
+  const configDir = getConnectorConfigDir(name);
+  const profilesDir = join3(configDir, "profiles");
+  if (!existsSync3(profilesDir))
+    return ["default"];
+  const seen = new Set;
+  try {
+    const entries = readdirSync2(profilesDir);
+    for (const entry of entries) {
+      const fullPath = join3(profilesDir, entry);
+      const stat = statSync2(fullPath);
+      if (stat.isDirectory()) {
+        seen.add(entry);
+      } else if (entry.endsWith(".json")) {
+        seen.add(entry.replace(/\.json$/, ""));
+      }
+    }
+  } catch {}
+  seen.add("default");
+  return Array.from(seen).sort();
+}
+function switchProfile(name, profile) {
+  const configDir = getConnectorConfigDir(name);
+  mkdirSync2(configDir, { recursive: true });
+  writeFileSync2(join3(configDir, "current_profile"), profile);
+}
+function deleteProfile(name, profile) {
+  if (profile === "default")
+    return false;
+  const configDir = getConnectorConfigDir(name);
+  const profilesDir = join3(configDir, "profiles");
+  const profileFile = join3(profilesDir, `${profile}.json`);
+  if (existsSync3(profileFile)) {
+    rmSync2(profileFile);
+    if (getCurrentProfile(name) === profile) {
+      switchProfile(name, "default");
+    }
+    return true;
+  }
+  const profileDir = join3(profilesDir, profile);
+  if (existsSync3(profileDir)) {
+    rmSync2(profileDir, { recursive: true });
+    if (getCurrentProfile(name) === profile) {
+      switchProfile(name, "default");
+    }
+    return true;
+  }
+  return false;
+}
 
 // src/server/serve.ts
+var activityLog = [];
+var MAX_ACTIVITY_LOG = 100;
+function logActivity(action, connector, detail) {
+  activityLog.unshift({ action, connector, timestamp: Date.now(), detail });
+  if (activityLog.length > MAX_ACTIVITY_LOG) {
+    activityLog.length = MAX_ACTIVITY_LOG;
+  }
+}
 function resolveDashboardDir() {
   const candidates = [];
   try {
@@ -941,7 +1096,19 @@ function serveStaticFile(filePath) {
     headers: { "Content-Type": contentType }
   });
 }
-async function startServer(port, options) {
+async function findAvailablePort(preferred) {
+  for (let port = preferred;port < preferred + 100; port++) {
+    try {
+      const server = Bun.serve({ port, fetch() {
+        return new Response;
+      } });
+      server.stop(true);
+      return port;
+    } catch {}
+  }
+  throw new Error(`No available port found in range ${preferred}-${preferred + 99}`);
+}
+async function startServer(requestedPort, options) {
   const shouldOpen = options?.open ?? true;
   loadConnectorVersions();
   const dashboardDir = resolveDashboardDir();
@@ -958,6 +1125,10 @@ Dashboard not found at: ${dashboardDir}`);
     console.error(`  bun run build:dashboard
 `);
   }
+  const port = await findAvailablePort(requestedPort);
+  if (port !== requestedPort) {
+    console.log(`Port ${requestedPort} is in use, using port ${port} instead`);
+  }
   const server = Bun.serve({
     port,
     async fetch(req) {
@@ -1000,6 +1171,7 @@ Dashboard not found at: ${dashboardDir}`);
           if (!body.key)
             return json({ error: "Missing 'key' in request body" }, 400, port);
           saveApiKey(name, body.key, body.field);
+          logActivity("key_saved", name, body.field ? `Field: ${body.field}` : undefined);
           return json({ success: true }, 200, port);
         } catch (e) {
           return json({ error: e instanceof Error ? e.message : "Failed to save key" }, 500, port);
@@ -1012,18 +1184,215 @@ Dashboard not found at: ${dashboardDir}`);
           return json({ error: "Invalid connector name" }, 400, port);
         try {
           const tokens = await refreshOAuthToken(name);
+          logActivity("token_refreshed", name, tokens.expiresAt ? `Expires: ${new Date(tokens.expiresAt).toISOString()}` : undefined);
           return json({ success: true, expiresAt: tokens.expiresAt }, 200, port);
         } catch (e) {
           return json({ success: false, error: e instanceof Error ? e.message : "Failed to refresh" }, 500, port);
         }
       }
+      const installMatch = path.match(/^\/api\/connectors\/([^/]+)\/install$/);
+      if (installMatch && method === "POST") {
+        const name = installMatch[1];
+        if (!isValidConnectorName(name))
+          return json({ error: "Invalid connector name" }, 400, port);
+        const meta = getConnector(name);
+        if (!meta)
+          return json({ error: `Connector '${name}' not found` }, 404, port);
+        try {
+          const result = installConnector(name);
+          if (!result.success) {
+            return json({ error: result.error || "Failed to install connector" }, 500, port);
+          }
+          logActivity("installed", name);
+          return json({ success: true, name }, 200, port);
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to install connector" }, 500, port);
+        }
+      }
+      const uninstallMatch = path.match(/^\/api\/connectors\/([^/]+)\/uninstall$/);
+      if (uninstallMatch && method === "POST") {
+        const name = uninstallMatch[1];
+        if (!isValidConnectorName(name))
+          return json({ error: "Invalid connector name" }, 400, port);
+        try {
+          const removed = removeConnector(name);
+          if (!removed) {
+            return json({ error: `Connector '${name}' is not installed` }, 404, port);
+          }
+          logActivity("uninstalled", name);
+          return json({ success: true, name }, 200, port);
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to uninstall connector" }, 500, port);
+        }
+      }
+      if (path === "/api/update" && method === "POST") {
+        try {
+          const installed = getInstalledConnectors();
+          if (installed.length === 0) {
+            return json({ updated: [], count: 0 }, 200, port);
+          }
+          const results = installed.map((name) => installConnector(name, { overwrite: true }));
+          return json({
+            results,
+            count: results.filter((r) => r.success).length,
+            total: installed.length
+          }, 200, port);
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to update" }, 500, port);
+        }
+      }
+      if (path === "/api/activity" && method === "GET") {
+        return json(activityLog, 200, port);
+      }
+      const profilesMatch = path.match(/^\/api\/connectors\/([^/]+)\/profiles$/);
+      if (profilesMatch && method === "GET") {
+        const name = profilesMatch[1];
+        if (!isValidConnectorName(name))
+          return json({ error: "Invalid connector name" }, 400, port);
+        try {
+          const profiles = listProfiles(name);
+          const configDir = join4(homedir2(), ".connectors", name.startsWith("connect-") ? name : `connect-${name}`);
+          const currentProfileFile = join4(configDir, "current_profile");
+          let current = "default";
+          if (existsSync4(currentProfileFile)) {
+            try {
+              current = readFileSync4(currentProfileFile, "utf-8").trim() || "default";
+            } catch {}
+          }
+          return json({ current, profiles }, 200, port);
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to list profiles" }, 500, port);
+        }
+      }
+      const profileSwitchMatch = path.match(/^\/api\/connectors\/([^/]+)\/profiles\/switch$/);
+      if (profileSwitchMatch && method === "POST") {
+        const name = profileSwitchMatch[1];
+        if (!isValidConnectorName(name))
+          return json({ error: "Invalid connector name" }, 400, port);
+        try {
+          const contentLength = parseInt(req.headers.get("content-length") || "0", 10);
+          if (contentLength > MAX_BODY_SIZE)
+            return json({ error: "Request body too large" }, 413, port);
+          const body = await req.json();
+          if (!body.profile)
+            return json({ error: "Missing 'profile' in request body" }, 400, port);
+          switchProfile(name, body.profile);
+          logActivity("profile_switch", name, `Switched to profile: ${body.profile}`);
+          return json({ success: true, profile: body.profile }, 200, port);
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to switch profile" }, 500, port);
+        }
+      }
+      const profileDeleteMatch = path.match(/^\/api\/connectors\/([^/]+)\/profiles\/([^/]+)$/);
+      if (profileDeleteMatch && method === "DELETE") {
+        const name = profileDeleteMatch[1];
+        const profile = profileDeleteMatch[2];
+        if (!isValidConnectorName(name))
+          return json({ error: "Invalid connector name" }, 400, port);
+        if (profile === "default")
+          return json({ error: "Cannot delete the default profile" }, 400, port);
+        try {
+          const deleted = deleteProfile(name, profile);
+          if (!deleted)
+            return json({ error: `Profile '${profile}' not found` }, 404, port);
+          logActivity("profile_delete", name, `Deleted profile: ${profile}`);
+          return json({ success: true }, 200, port);
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to delete profile" }, 500, port);
+        }
+      }
+      if (path === "/api/export" && method === "GET") {
+        try {
+          const connectDir = join4(homedir2(), ".connectors");
+          const result = {};
+          if (existsSync4(connectDir)) {
+            const entries = readdirSync3(connectDir, { withFileTypes: true });
+            for (const entry of entries) {
+              if (!entry.isDirectory() || !entry.name.startsWith("connect-"))
+                continue;
+              const connectorName = entry.name.replace(/^connect-/, "");
+              const profilesDir = join4(connectDir, entry.name, "profiles");
+              if (!existsSync4(profilesDir))
+                continue;
+              const profiles = {};
+              const profileEntries = readdirSync3(profilesDir, { withFileTypes: true });
+              for (const pEntry of profileEntries) {
+                if (pEntry.isFile() && pEntry.name.endsWith(".json")) {
+                  const profileName = basename(pEntry.name, ".json");
+                  try {
+                    const config = JSON.parse(readFileSync4(join4(profilesDir, pEntry.name), "utf-8"));
+                    profiles[profileName] = config;
+                  } catch {}
+                }
+                if (pEntry.isDirectory()) {
+                  const configPath = join4(profilesDir, pEntry.name, "config.json");
+                  if (existsSync4(configPath)) {
+                    try {
+                      const config = JSON.parse(readFileSync4(configPath, "utf-8"));
+                      profiles[pEntry.name] = config;
+                    } catch {}
+                  }
+                }
+              }
+              if (Object.keys(profiles).length > 0) {
+                result[connectorName] = { profiles };
+              }
+            }
+          }
+          const exportData = { connectors: result, exportedAt: new Date().toISOString() };
+          return new Response(JSON.stringify(exportData, null, 2), {
+            status: 200,
+            headers: {
+              "Content-Type": "application/json",
+              "Content-Disposition": `attachment; filename="connectors-backup-${new Date().toISOString().slice(0, 10)}.json"`,
+              "Access-Control-Allow-Origin": port ? `http://localhost:${port}` : "*",
+              ...SECURITY_HEADERS
+            }
+          });
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to export credentials" }, 500, port);
+        }
+      }
+      if (path === "/api/import" && method === "POST") {
+        try {
+          const contentLength = parseInt(req.headers.get("content-length") || "0", 10);
+          if (contentLength > MAX_BODY_SIZE)
+            return json({ error: "Request body too large" }, 413, port);
+          const body = await req.json();
+          if (!body.connectors || typeof body.connectors !== "object") {
+            return json({ error: "Invalid import format: missing 'connectors' object" }, 400, port);
+          }
+          let imported = 0;
+          const connectDir = join4(homedir2(), ".connectors");
+          for (const [connectorName, data] of Object.entries(body.connectors)) {
+            if (!isValidConnectorName(connectorName))
+              continue;
+            if (!data.profiles || typeof data.profiles !== "object")
+              continue;
+            const connectorDir = join4(connectDir, `connect-${connectorName}`);
+            const profilesDir = join4(connectorDir, "profiles");
+            for (const [profileName, config] of Object.entries(data.profiles)) {
+              if (!config || typeof config !== "object")
+                continue;
+              mkdirSync3(profilesDir, { recursive: true });
+              const profileFile = join4(profilesDir, `${profileName}.json`);
+              writeFileSync3(profileFile, JSON.stringify(config, null, 2));
+              imported++;
+            }
+          }
+          logActivity("credentials_imported", "all", `Imported ${imported} profiles`);
+          return json({ success: true, imported }, 200, port);
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to import credentials" }, 500, port);
+        }
+      }
       const oauthStartMatch = path.match(/^\/oauth\/([^/]+)\/start$/);
       if (oauthStartMatch && method === "GET") {
         const name = oauthStartMatch[1];
         const redirectUri = `http://localhost:${port}/oauth/${name}/callback`;
         const authUrl = getOAuthStartUrl(name, redirectUri);
         if (!authUrl) {
-          return htmlResponse(errorPage("OAuth Not Available", `No OAuth client credentials found for <strong>${name}</strong>.`, `Set up credentials at <code>~/.connect/connect-${name}/credentials.json</code>`));
+          return htmlResponse(errorPage("OAuth Not Available", `No OAuth client credentials found for <strong>${name}</strong>.`, `Set up credentials at <code>~/.connectors/connect-${name}/credentials.json</code>`));
         }
         return Response.redirect(authUrl, 302);
       }
@@ -1045,6 +1414,7 @@ Dashboard not found at: ${dashboardDir}`);
         try {
           const redirectUri = `http://localhost:${port}/oauth/${name}/callback`;
           await exchangeOAuthCode(name, code, redirectUri);
+          logActivity("oauth_connected", name);
           return htmlResponse(`<!DOCTYPE html><html><head><meta charset="utf-8"></head><body style="font-family:system-ui,sans-serif;display:flex;justify-content:center;align-items:center;height:100vh;margin:0;background:#0a0a0a;color:#e5e5e5;">
             <div style="text-align:center;">
               <h2 style="color:#22c55e;">Connected!</h2>
@@ -1065,7 +1435,7 @@ Dashboard not found at: ${dashboardDir}`);
         return new Response(null, {
           headers: {
             "Access-Control-Allow-Origin": `http://localhost:${port}`,
-            "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+            "Access-Control-Allow-Methods": "GET, POST, DELETE, OPTIONS",
             "Access-Control-Allow-Headers": "Content-Type"
           }
         });

package/connectors/connect-anthropic/AGENTS.md

@@ -84,7 +84,7 @@ connect-anthropic profile list|use|create|delete|show
 ## Data Storage
 
 ```
-~/.connect/connect-anthropic/
+~/.connectors/connect-anthropic/
 ├── current_profile   # Active profile name
 └── profiles/
     ├── default.json  # Default profile

package/connectors/connect-anthropic/CLAUDE.md

@@ -84,7 +84,7 @@ connect-anthropic profile list|use|create|delete|show
 ## Data Storage
 
 ```
-~/.connect/connect-anthropic/
+~/.connectors/connect-anthropic/
 ├── current_profile   # Active profile name
 └── profiles/
     ├── default.json  # Default profile

package/connectors/connect-anthropic/GEMINI.md

@@ -84,7 +84,7 @@ connect-anthropic profile list|use|create|delete|show
 ## Data Storage
 
 ```
-~/.connect/connect-anthropic/
+~/.connectors/connect-anthropic/
 ├── current_profile   # Active profile name
 └── profiles/
     ├── default.json  # Default profile

package/connectors/connect-anthropic/README.md

@@ -75,10 +75,10 @@ const client = new Anthropic({ apiKey: 'YOUR_API_KEY' });
 
 ## Data Storage
 
-Configuration stored in `~/.connect/connect-anthropic/`:
+Configuration stored in `~/.connectors/connect-anthropic/`:
 
 ```
-~/.connect/connect-anthropic/
+~/.connectors/connect-anthropic/
 ├── current_profile   # Active profile name
 └── profiles/
     ├── default.json  # Default profile

package/connectors/connect-anthropic/src/utils/config.ts

@@ -13,8 +13,8 @@ export interface ProfileConfig {
 // Store for --profile flag override (set by CLI before commands run)
 let profileOverride: string | undefined;
 
-// Config directory: ~/.connect/{connector-name}/
-const CONFIG_DIR = join(homedir(), '.connect', CONNECTOR_NAME);
+// Config directory: ~/.connectors/{connector-name}/
+const CONFIG_DIR = join(homedir(), '.connectors', CONNECTOR_NAME);
 const PROFILES_DIR = join(CONFIG_DIR, 'profiles');
 const CURRENT_PROFILE_FILE = join(CONFIG_DIR, 'current_profile');
 

package/connectors/connect-aws/AGENTS.md

@@ -58,7 +58,7 @@ API Key authentication. Credentials can be set via:
 
 ### Multi-Profile Configuration
 
-Profiles stored in `~/.connect/connect-aws/profiles/`:
+Profiles stored in `~/.connectors/connect-aws/profiles/`:
 - Each profile is a separate JSON file
 - `current_profile` file tracks active profile
 - `--profile` flag overrides for single command
@@ -132,7 +132,7 @@ connect-aws config show
 ## Data Storage
 
 ```
-~/.connect/connect-aws/
+~/.connectors/connect-aws/
 ├── current_profile   # Active profile name
 └── profiles/
     ├── default.json  # Default profile

package/connectors/connect-aws/CLAUDE.md

@@ -58,7 +58,7 @@ API Key authentication. Credentials can be set via:
 
 ### Multi-Profile Configuration
 
-Profiles stored in `~/.connect/connect-aws/profiles/`:
+Profiles stored in `~/.connectors/connect-aws/profiles/`:
 - Each profile is a separate JSON file
 - `current_profile` file tracks active profile
 - `--profile` flag overrides for single command
@@ -132,7 +132,7 @@ connect-aws config show
 ## Data Storage
 
 ```
-~/.connect/connect-aws/
+~/.connectors/connect-aws/
 ├── current_profile   # Active profile name
 └── profiles/
     ├── default.json  # Default profile

package/connectors/connect-aws/GEMINI.md

@@ -58,7 +58,7 @@ API Key authentication. Credentials can be set via:
 
 ### Multi-Profile Configuration
 
-Profiles stored in `~/.connect/connect-aws/profiles/`:
+Profiles stored in `~/.connectors/connect-aws/profiles/`:
 - Each profile is a separate JSON file
 - `current_profile` file tracks active profile
 - `--profile` flag overrides for single command
@@ -132,7 +132,7 @@ connect-aws config show
 ## Data Storage
 
 ```
-~/.connect/connect-aws/
+~/.connectors/connect-aws/
 ├── current_profile   # Active profile name
 └── profiles/
     ├── default.json  # Default profile

package/connectors/connect-aws/README.md

@@ -100,10 +100,10 @@ const client = new Aws({ apiKey: 'YOUR_API_KEY' });
 
 ## Data Storage
 
-Configuration stored in `~/.connect/connect-aws/`:
+Configuration stored in `~/.connectors/connect-aws/`:
 
 ```
-~/.connect/connect-aws/
+~/.connectors/connect-aws/
 ├── current_profile   # Active profile name
 └── profiles/
     ├── default.json  # Default profile

package/connectors/connect-aws/src/utils/config.ts

@@ -15,8 +15,8 @@ export interface ProfileConfig {
 // Store for --profile flag override (set by CLI before commands run)
 let profileOverride: string | undefined;
 
-// Config directory: ~/.connect/{connector-name}/
-const CONFIG_DIR = join(homedir(), '.connect', CONNECTOR_NAME);
+// Config directory: ~/.connectors/{connector-name}/
+const CONFIG_DIR = join(homedir(), '.connectors', CONNECTOR_NAME);
 const PROFILES_DIR = join(CONFIG_DIR, 'profiles');
 const CURRENT_PROFILE_FILE = join(CONFIG_DIR, 'current_profile');
 

package/connectors/connect-brandsight/AGENTS.md

@@ -78,7 +78,7 @@ connect-brandsight config set-secret <api-secret>
 connect-brandsight config set-customer-id <customer-id>
 connect-brandsight config show
 
-# Contact Management (stored in ~/.connect/connect-brandsight/contacts/)
+# Contact Management (stored in ~/.connectors/connect-brandsight/contacts/)
 connect-brandsight contacts add <name> \
   --first-name "John" --last-name "Doe" \
   --email "john@example.com" --phone "+1.5551234567" \
@@ -115,7 +115,7 @@ connect-brandsight dns add <domain> <type> <name> <data>
 ## Data Storage
 
 ```
-~/.connect/connect-brandsight/
+~/.connectors/connect-brandsight/
 ├── current_profile   # Active profile name
 └── profiles/
     ├── default.json  # Default profile

package/connectors/connect-brandsight/CLAUDE.md

@@ -78,7 +78,7 @@ connect-brandsight config set-secret <api-secret>
 connect-brandsight config set-customer-id <customer-id>
 connect-brandsight config show
 
-# Contact Management (stored in ~/.connect/connect-brandsight/contacts/)
+# Contact Management (stored in ~/.connectors/connect-brandsight/contacts/)
 connect-brandsight contacts add <name> \
   --first-name "John" --last-name "Doe" \
   --email "john@example.com" --phone "+1.5551234567" \
@@ -115,7 +115,7 @@ connect-brandsight dns add <domain> <type> <name> <data>
 ## Data Storage
 
 ```
-~/.connect/connect-brandsight/
+~/.connectors/connect-brandsight/
 ├── current_profile   # Active profile name
 └── profiles/
     ├── default.json  # Default profile