@kivimedia/kmhub 2.0.0 → 2.9.0

package/README.md

@@ -61,6 +61,7 @@ profile loads only the families you want:
 | `outreach` | `core` + the outreach families |
 | `money` | `core` + the billing families |
 | `content` | `core` + the content families |
+| `coach` | Fully Booked Coach operations, client delivery, acquisition, and content requests |
 | `full` | everything (**default**) |
 
 `full` is the default, so nothing changes for an existing connection. An unknown profile name
@@ -111,19 +112,19 @@ No local install for the user - they point their client at the hosted VPS endpoi
 authenticate with their own KM Hub key as a header. One server process serves every org;
 each request is scoped to the token it carries. Operators: see
 [DEPLOY-VPS.md](./DEPLOY-VPS.md) (pm2 `kmhub-mcp`, port `8830`,
-`https://kmhub-mcp.104-200-30-37.sslip.io/mcp`).
+`https://mcp.kivimedia.co/mcp`).
 
 Claude Code (one command):
 
 ```bash
-claude mcp add --transport http kmhub https://kmhub-mcp.104-200-30-37.sslip.io/mcp \
+claude mcp add --transport http kmhub https://mcp.kivimedia.co/mcp \
   --header "Authorization: Bearer kmh_live_xxxxxxxx"
 ```
 
 Add `?profile=core` to the URL to load a smaller tool set:
 
 ```bash
-claude mcp add --transport http kmhub "https://kmhub-mcp.104-200-30-37.sslip.io/mcp?profile=core" \
+claude mcp add --transport http kmhub "https://mcp.kivimedia.co/mcp?profile=core" \
   --header "Authorization: Bearer kmh_live_xxxxxxxx"
 ```
 
@@ -134,7 +135,7 @@ Claude Desktop / config-file clients:
   "mcpServers": {
     "kmhub": {
       "type": "streamable-http",
-      "url": "https://kmhub-mcp.104-200-30-37.sslip.io/mcp",
+      "url": "https://mcp.kivimedia.co/mcp",
       "headers": {
         "Authorization": "Bearer kmh_live_xxxxxxxx",
         "X-KMHub-Profile": "full"
@@ -144,7 +145,7 @@ Claude Desktop / config-file clients:
 }
 ```
 
-Health check (no auth): `GET https://kmhub-mcp.104-200-30-37.sslip.io/health`.
+Health check (no auth): `GET https://mcp.kivimedia.co/health`.
 
 ## Adding tools
 

package/bin/kmhub.mjs

@@ -50,6 +50,12 @@ const FALLBACK_BASE = 'https://jpwbosrmkibsdgckowsm.supabase.co/functions/v1/kmh
 /** Keys are minted as kmh_live_ plus hex. The API matches the same shape before it looks anything up. */
 const KEY_RE = /^kmh_live_[0-9a-f]+$/i;
 
+/**
+ * Where people who use Codex, Cursor or Grok Build are sent. This tool only knows how to
+ * register into Claude Code; the installers behind this page wire all four apps.
+ */
+const SETUP_URL = 'https://hub.kivimedia.co/terminal/';
+
 /** A connector name has to survive being an argv element and a JSON key. */
 const NAME_RE = /^[A-Za-z0-9_-]{1,64}$/;
 
@@ -71,8 +77,12 @@ const HELP = `kmhub, the KM Hub Terminal Mode command line tool.
   you passed, then KMHUB_API_KEY in the environment, then the key stored in the
   registration itself.
 
-  Create a key in KM Hub under Settings > Developer & API.
+  Create a key in KM Hub under Settings > Connect > Developer & API.
   Set KMHUB_API_BASE to point at a different KM Hub.
+
+  This tool registers Claude Code only. For Codex, Cursor or Grok Build, use the
+  KM Hub setup instead, which connects the app you pick and needs no key:
+  ${SETUP_URL}
 `;
 
 // ---------------------------------------------------------------------------
@@ -197,7 +207,7 @@ function explain(res, base) {
   if (res.status === 401) {
     return [
       'KM Hub did not accept that key. It is either mistyped or it has been revoked.',
-      'Create a fresh one in KM Hub under Settings > Developer & API, then run this again with the new key.',
+      'Create a fresh one in KM Hub under Settings > Connect > Developer & API, then run this again with the new key.',
     ].join('\n');
   }
   if (res.status === 402) {
@@ -213,7 +223,7 @@ function explain(res, base) {
   if (res.status === 403) {
     return [
       `This key does not carry the scope that call needs${message ? ` (${message})` : ''}.`,
-      'A read-only key can read your workspace but cannot create anything. Mint a key with write scope in Settings > Developer & API if you need the create tools.',
+      'A read-only key can read your workspace but cannot create anything. Mint a key with write scope in Settings > Connect > Developer & API if you need the create tools.',
     ].join('\n');
   }
   if (res.status === 429) {
@@ -436,12 +446,12 @@ async function cmdInstall(key, name) {
       fail(`I read "${name}" as the connector name, not as a key. A key starts with kmh_live_.`);
       fail('');
     }
-    fail('Create one in KM Hub under Settings > Developer & API.');
+    fail('Create one in KM Hub under Settings > Connect > Developer & API.');
     return 2;
   }
   if (!KEY_RE.test(key)) {
     fail('That does not look like a KM Hub API key.');
-    fail('A key starts with kmh_live_ and is followed by hex. Copy it again from Settings > Developer & API.');
+    fail('A key starts with kmh_live_ and is followed by hex. Copy it again from Settings > Connect > Developer & API.');
     return 2;
   }
   if (!NAME_RE.test(name)) {
@@ -487,6 +497,9 @@ async function cmdInstall(key, name) {
     fail('If you are setting up Claude Desktop instead, put this in your claude_desktop_config.json:');
     fail('');
     fail(desktopConfigBlock(name, key));
+    fail('');
+    fail('Using Codex, Cursor or Grok Build instead? This tool only registers Claude Code.');
+    fail(`The KM Hub setup connects the app you pick: ${SETUP_URL}`);
     return 1;
   }
 
@@ -521,7 +534,7 @@ async function cmdInstall(key, name) {
   say('');
   say('Two things worth knowing:');
   say(`  1. The key is stored in your Claude Code config. If it ever leaks, revoke it in KM Hub`);
-  say('     under Settings > Developer & API and run this install again with a fresh one.');
+  say('     under Settings > Connect > Developer & API and run this install again with a fresh one.');
   say(`  2. The connector is launched with npx, so restarting Claude Code picks up new builds.`);
   say(`     Run  npx ${PKG_NAME} doctor  if anything ever looks wrong.`);
   return 0;
@@ -743,7 +756,7 @@ async function cmdDoctor(argKey, name) {
       'fail',
       'API key',
       `the value from ${source} is not shaped like a KM Hub key`,
-      'A key starts with kmh_live_ and is followed by hex. Copy it again from Settings > Developer & API.',
+      'A key starts with kmh_live_ and is followed by hex. Copy it again from Settings > Connect > Developer & API.',
     );
   } else {
     record('ok', 'API key', `${maskKey(key)} from ${source}`);