get-claudia 1.54.3 → 1.54.4

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to Claudia will be documented in this file.
 
+## 1.54.4 (2026-03-14)
+
+### The One-Click Setup Release
+
+Google Workspace setup went from 15 minutes to 2. Real user testing revealed painful friction in API enablement, broken OAuth URLs, missing API documentation, and a config typo that silently broke auth for new installs.
+
+- **One-click API enablement** -- `npx get-claudia google` now generates a single URL that enables all required APIs for your chosen tier (4/8/11 APIs) in one browser page. No more visiting each API individually.
+- **Tiered API reference** -- New `TIER_APIS` mapping in `google-setup.js` with `extractProjectNumber()` and `buildApiEnableUrl()` exports. Project number is auto-extracted from the Client ID.
+- **Re-auth documentation** -- All setup docs now include step 9: if you enable new APIs after initial sign-in, delete `~/.workspace-mcp/token.json` and restart Claude Code.
+- **BUG FIX: env var mismatch** -- `template-v2/CLAUDE.md` referenced `GOOGLE_CLIENT_ID` instead of `GOOGLE_OAUTH_CLIENT_ID`. New users following docs would get silent auth failures. Fixed.
+- **Principle 15: URL Integrity** -- New principle across all three `claudia-principles.md` copies: never modify, reformat, or line-wrap URLs. Prevents Claudia from corrupting OAuth URLs.
+- **Complete API list** -- Docs now list all 11 APIs across tiers (added Slides, Forms, Apps Script, Chat, People API) instead of a vague "and any others you want."
+- **12 new tests** -- `extractProjectNumber` (4 tests), `buildApiEnableUrl` (4 tests), `TIER_APIS` structure (4 tests). All 26 google-setup tests pass.
+
 ## 1.54.0 (2026-03-05)
 
 ### The Compound Tools Release

package/bin/google-setup.js

@@ -6,6 +6,68 @@
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 
+/**
+ * Google API IDs required per tool tier.
+ * Each higher tier is a superset of the one below it.
+ */
+export const TIER_APIS = {
+  core: [
+    'gmail.googleapis.com',
+    'calendar-json.googleapis.com',
+    'drive.googleapis.com',
+    'people.googleapis.com',
+  ],
+  extended: [
+    'gmail.googleapis.com',
+    'calendar-json.googleapis.com',
+    'drive.googleapis.com',
+    'people.googleapis.com',
+    'docs.googleapis.com',
+    'sheets.googleapis.com',
+    'tasks.googleapis.com',
+    'chat.googleapis.com',
+  ],
+  complete: [
+    'gmail.googleapis.com',
+    'calendar-json.googleapis.com',
+    'drive.googleapis.com',
+    'people.googleapis.com',
+    'docs.googleapis.com',
+    'sheets.googleapis.com',
+    'tasks.googleapis.com',
+    'chat.googleapis.com',
+    'slides.googleapis.com',
+    'forms.googleapis.com',
+    'script.googleapis.com',
+  ],
+};
+
+/**
+ * Extract the numeric GCP project number from a Google OAuth Client ID.
+ * Client IDs follow the format: <project-number>-<random>.apps.googleusercontent.com
+ * Returns null if the ID doesn't match the expected format.
+ */
+export function extractProjectNumber(clientId) {
+  if (!clientId) return null;
+  const match = clientId.match(/^(\d+)-/);
+  return match ? match[1] : null;
+}
+
+/**
+ * Build a one-click URL that enables all APIs for a given tier in the GCP console.
+ * Returns a generic library URL if projectNumber is null.
+ */
+export function buildApiEnableUrl(projectNumber, tier) {
+  const effectiveTier = TIER_APIS[tier] ? tier : 'core';
+  const apis = TIER_APIS[effectiveTier];
+
+  if (!projectNumber) {
+    return 'https://console.cloud.google.com/apis/library';
+  }
+
+  return `https://console.cloud.google.com/flows/enableapi?apiid=${apis.join(',')}&project=${projectNumber}`;
+}
+
 /**
  * Detect old Google MCP server entries in .mcp.json.
  * Returns { hasOldGmail, hasOldCalendar, hasWorkspace }.

package/bin/index.js

@@ -6,7 +6,7 @@ import { fileURLToPath } from 'url';
 import { spawn } from 'child_process';
 import { homedir } from 'os';
 import { createInterface } from 'readline';
-import { setupGoogleWorkspace, detectOldGoogleMcp } from './google-setup.js';
+import { setupGoogleWorkspace, detectOldGoogleMcp, extractProjectNumber, buildApiEnableUrl, TIER_APIS } from './google-setup.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -1391,13 +1391,13 @@ See the memory-manager skill for the full tool reference.`;
       // skill-index.json not found, skip skills section
     }
 
-    const googleSection = `## Google Workspace Integration (New!)
+    const googleSection = `## Google Workspace Integration
 
-Claudia can now connect to your full Google Workspace: Gmail, Calendar, Drive, Docs, Sheets, Tasks, and more through one server.
+Claudia connects to your full Google Workspace: Gmail, Calendar, Drive, Docs, Sheets, Tasks, and more through one server.
 
-**Quick setup:** Run \`npx get-claudia google\` to configure it interactively.
+**Quick setup:** Run \`npx get-claudia google\` to configure it interactively. It will generate a one-click URL to enable all required APIs at once.
 
-Or see the Google Integration Setup section in CLAUDE.md for manual configuration.`;
+Or see the Google Integration Setup section in CLAUDE.md for manual configuration. If you enable new APIs later, remember to re-authenticate (delete ~/.workspace-mcp/token.json and restart Claude Code).`;
 
     const content = `# Updated to v${version} (${date})
 
@@ -1509,12 +1509,26 @@ async function runGoogleSetup() {
     console.log(` ${colors.green}✓${colors.reset} Old Gmail/Calendar entries removed`);
   }
 
+  // Build one-click API enablement URL
+  const projectNumber = extractProjectNumber(clientId);
+  const apiUrl = buildApiEnableUrl(projectNumber, tier);
+  const apiCount = (TIER_APIS[tier] || TIER_APIS.core).length;
+
   console.log('');
   console.log(` ${colors.boldYellow}Next steps:${colors.reset}`);
-  console.log(`   1. Enable APIs in your GCP project: Gmail, Calendar, Drive, etc.`);
-  console.log(`      ${colors.dim}https://console.cloud.google.com/apis/library${colors.reset}`);
-  console.log(`   2. Restart Claude Code`);
-  console.log(`   3. First run will open your browser for Google sign-in`);
+  console.log('');
+  if (projectNumber) {
+    console.log(`   1. ${colors.bold}Enable all ${apiCount} APIs at once${colors.reset} (one click):`);
+    console.log(`      ${colors.cyan}${apiUrl}${colors.reset}`);
+  } else {
+    console.log(`   1. ${colors.bold}Enable APIs${colors.reset} in your GCP project:`);
+    console.log(`      ${colors.cyan}${apiUrl}${colors.reset}`);
+    console.log(`      ${colors.dim}Enable: ${(TIER_APIS[tier] || TIER_APIS.core).join(', ')}${colors.reset}`);
+  }
+  console.log(`   2. ${colors.bold}Restart Claude Code${colors.reset} for the new MCP server to connect`);
+  console.log(`   3. First run will open your browser for ${colors.bold}Google sign-in${colors.reset}`);
+  console.log(`   4. ${colors.dim}If you enable more APIs later, sign out and re-authenticate${colors.reset}`);
+  console.log(`      ${colors.dim}(delete ~/.workspace-mcp/token.json and restart Claude Code)${colors.reset}`);
   console.log('');
   console.log(` ${colors.dim}Try: "check my inbox", "what's on my calendar", "search my Drive for..."${colors.reset}`);
   console.log('');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "get-claudia",
-  "version": "1.54.3",
+  "version": "1.54.4",
   "description": "An AI assistant who learns how you work.",
   "keywords": [
     "claudia",

package/template-v2/.claude/rules/claudia-principles.md

@@ -263,6 +263,20 @@ Better yet, do not store it at all. Store the pointer: "Pipeline status is in pi
 
 ---
 
+## 15. URL Integrity
+
+**Never modify, reformat, or line-wrap URLs.**
+
+When outputting a URL (OAuth links, API console links, sign-in URLs, any URL):
+- Copy it character-for-character. Do not "clean up" or reformat.
+- Do not insert line breaks, spaces, or markdown formatting inside the URL.
+- Do not URL-encode characters that were not encoded in the original.
+- If a URL is long, output it on its own line. Never wrap it.
+
+Corrupted URLs waste user time and break authentication flows.
+
+---
+
 ## What I Never Do
 
 - Pretend to know things I don't
@@ -277,6 +291,7 @@ Better yet, do not store it at all. Store the pointer: "Pipeline status is in pi
 - Use em dashes (the hallmark of lazy AI writing)
 - Store volatile counts, statuses, or dated facts in MEMORY.md without pointers to canonical sources
 - Reference internal implementation details in conversation: skill files, rule files, hook names, CLI command internals, or internal system names. These are part of who I am - I follow them silently without narrating them.
+- Modify, reformat, or line-wrap URLs
 
 ---
 

package/template-v2/CLAUDE.md

@@ -405,14 +405,21 @@ The MCP tools from Rube will have names like `SLACK_SEND_MESSAGE`, `NOTION_CREAT
 
 ### Google Integration Setup
 
+**Recommended:** Run `npx get-claudia google` for a guided setup that generates a one-click API enablement URL.
+
 The workspace-mcp server requires your own Google Cloud credentials. Each user sets this up once:
 
 1. Go to [Google Cloud Console](https://console.cloud.google.com/)
 2. Create a new project (or select an existing one)
-3. Enable the APIs you need:
-   - Go to APIs & Services > Library
-   - Search for and enable: **Gmail API**, **Google Calendar API**, **Google Drive API**, **Google Docs API**, **Google Sheets API**, **Google Tasks API**, **People API** (Contacts)
-   - You can enable more later as needed
+3. Enable the APIs for your chosen tier:
+
+   | Tier | APIs to enable |
+   |------|---------------|
+   | **core** (43 tools) | Gmail API, Google Calendar API, Google Drive API, People API |
+   | **extended** (83 tools) | Core + Google Docs API, Google Sheets API, Tasks API, Google Chat API |
+   | **complete** (111 tools) | Extended + Google Slides API, Google Forms API, Apps Script API |
+
+   Go to APIs & Services > Library and enable each API. You can also use the one-click URL from `npx get-claudia google` to enable them all at once.
 4. Create OAuth credentials:
    - Go to APIs & Services > Credentials
    - Click "Create Credentials" > "OAuth client ID"
@@ -423,19 +430,20 @@ The workspace-mcp server requires your own Google Cloud credentials. Each user s
 5. Add credentials to `.mcp.json`:
    - Open `.mcp.json` in the project root
    - Find the `google_workspace` server entry
-   - Set the `GOOGLE_CLIENT_ID` and `GOOGLE_CLIENT_SECRET` environment variables:
+   - Set the `GOOGLE_OAUTH_CLIENT_ID` and `GOOGLE_OAUTH_CLIENT_SECRET` environment variables:
      ```json
      "env": {
-       "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
-       "GOOGLE_CLIENT_SECRET": "your-client-secret"
+       "GOOGLE_OAUTH_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
+       "GOOGLE_OAUTH_CLIENT_SECRET": "your-client-secret"
      }
      ```
 6. Choose your tool tier:
-   - The default is `--tool-tier core` (43 tools), which covers most needs
+   - The default is `--tool-tier core` (43 tools), which covers Gmail, Calendar, Drive, and Contacts
    - For more capabilities, change to `--tool-tier extended` (83 tools) or `--tool-tier complete` (111 tools) in the server args
 7. Restart Claude Code. On first run, the server opens your browser for Google sign-in. Tokens are stored locally for future sessions.
+8. **Re-authentication after enabling new APIs:** If you enable additional APIs after your initial sign-in, you must re-authenticate. Delete `~/.workspace-mcp/token.json` and restart Claude Code to trigger a new sign-in with the updated scopes.
 
-**Migrating from the old setup:** If you previously used separate Gmail and Calendar MCP servers, the same GCP project works. Just enable any additional APIs (Drive, Docs, Sheets, Tasks, People) in your existing project, copy over the Client ID and Client Secret, and update `.mcp.json` to use the `google_workspace` server entry instead of the old individual entries.
+**Migrating from the old setup:** If you previously used separate Gmail and Calendar MCP servers, the same GCP project works. Just enable any additional APIs in your existing project, copy over the Client ID and Client Secret into `GOOGLE_OAUTH_CLIENT_ID` and `GOOGLE_OAUTH_CLIENT_SECRET`, and update `.mcp.json` to use the `google_workspace` server entry instead of the old individual entries.
 
 ---