@empirical-gauzza/cli 1.0.39 → 1.0.40

package/lib/constants.js

@@ -386,8 +386,10 @@ Resolution order for every memory command, first match wins: the \`EMPIRICAL_WOR
     empirical workspace invite create --role writer --expires-in-days 7 --max-uses 3
     empirical workspace invite list
     empirical workspace invite revoke <token>
+    empirical workspace invite email ana@example.com ben@example.com --role writer --note "Come help us review the book."
+    empirical workspace invite email ana@example.com --note-file ./invite-note.txt --from-name "Matt" --workspace-id ws_team_abc
 
-Invite commands operate on the active team workspace. Create prints a shareable URL.
+Invite commands operate on the active team workspace, or the one named by \`--workspace-id\`. Create prints a shareable URL. Email sends each address its own invite (one address per seat, expires in 14 days) and prints who was invited and why anyone was not; \`--note\` (up to 1000 characters) appears in the email as your own words, and \`--from-name\` changes the name the email says it is from ("Matt invited you") for that send only; without it your account's display name is used.
 
 ### Soft-delete a demo workspace
 

package/lib/help.js

@@ -60,6 +60,8 @@ function showHelp() {
   log('                                                Create a shareable invite link for the active team workspace');
   log('  empirical workspace invite list              List active invites for the active team workspace');
   log('  empirical workspace invite revoke <token>    Revoke a previously created invite');
+  log('  empirical workspace invite email <address...> [--role reader|writer] [--note <text> | --note-file <path>] [--from-name <name>]');
+  log('                                                Email each person an invite, with your own note in the email');
   log('  empirical workspace delete <number|name|id> [--confirm]');
   log('                                                Soft-delete a team workspace (dry-run without --confirm)');
   log('');

package/lib/installWizard.js

@@ -36,6 +36,17 @@ function pluginNamesForInstallerOptions(options = {}) {
   return names.filter((name) => name === 'empirical-memory' || OPTIONAL_PLUGIN_NAMES.includes(name));
 }
 
+// Which detected CLIs to install for. At a terminal the person picks (Enter for all). With no
+// terminal, which is how an agent like Claude Code runs `empirical install` for someone, there is
+// nobody to answer, so it takes the default the list already shows: every detected CLI. Asking
+// anyway read an empty stdin and stopped with "nothing installed", so the agent's install did
+// nothing unless it knew to pipe an answer in.
+async function chooseInstallTargets(targets, { interactive = Boolean(process.stdin.isTTY), askFn = ask } = {}) {
+  if (!interactive) return targets.map((_, index) => index);
+  const answer = await askFn(uiQuestion('Press Enter for all, or select numbers (e.g. 1,2): '));
+  return parseSelection(answer, targets.length);
+}
+
 async function runInstallFlow() {
   log(uiHeader(`Empirical installer v${getCliVersion()}`));
   log('');
@@ -54,8 +65,10 @@ async function runInstallFlow() {
   });
   log('');
 
-  const answer = await ask(uiQuestion('Press Enter for all, or select numbers (e.g. 1,2): '));
-  const selectedIndexes = parseSelection(answer, targets.length);
+  const selectedIndexes = await chooseInstallTargets(targets);
+  if (!process.stdin.isTTY) {
+    log(`No terminal attached, so installing for every detected CLI: ${targets.map((t) => t.label).join(', ')}.`);
+  }
 
   if (selectedIndexes.length === 0) {
     log('No valid selection; nothing installed.');
@@ -407,5 +420,6 @@ async function runInstallFlow() {
 
 module.exports = {
   runInstallFlow,
-  pluginNamesForInstallerOptions
+  pluginNamesForInstallerOptions,
+  chooseInstallTargets
 };

package/lib/workspaceCommands.js

@@ -53,7 +53,55 @@ async function resolveShapeTarget({ requested, local, answersFile, acceptCost, i
 function isWorkspaceCommand(args) {
   if (args[0] !== 'workspace') return false;
   if (['list', 'current', 'select', 'use', 'unbind', 'create', 'delete', 'shape'].includes(args[1])) return true;
-  return args[1] === 'invite' && ['create', 'list', 'revoke'].includes(args[2]);
+  return args[1] === 'invite' && ['create', 'list', 'revoke', 'email'].includes(args[2]);
+}
+
+// Mirrors WORKSPACE_INVITE_NOTE_MAX in @empirical/shared for a local pre-check only; the CLI is
+// published on its own and cannot import it. The server re-checks and is the one that decides.
+const INVITE_NOTE_MAX = 1000;
+
+const NOT_SENT_REASONS = {
+  invalid_email: 'not a valid email address',
+  already_member: 'already a member',
+  already_invited: 'already has a pending invite',
+  seat_limit: 'the workspace has no free seat',
+  recipient_suppressed: 'this address has bounced or unsubscribed before',
+  email_not_configured: 'email is not set up on this server',
+  send_failed: 'the email could not be sent'
+};
+
+// empirical workspace invite email <address...> [--role reader|writer] [--note <text> | --note-file <path>] [--from-name <name>]
+async function runInviteEmail({ args, inviteUrl, authHeaders, target }) {
+  const emails = positionalArgs(args, 3).join(' ').split(/[\s,;]+/).map((e) => e.trim()).filter(Boolean);
+  if (!emails.length) {
+    throw new Error('Usage: empirical workspace invite email <address...> [--role reader|writer] [--note <text> | --note-file <path>] [--from-name <name>] [--workspace-id <id>]');
+  }
+  const role = parseOption(args, '--role', 'reader');
+  if (!['reader', 'writer'].includes(role)) throw new Error('--role must be reader or writer for an emailed invite.');
+  const noteFile = parseOption(args, '--note-file', '');
+  let note = parseOption(args, '--note', '');
+  if (noteFile) {
+    if (note) throw new Error('Use --note or --note-file, not both.');
+    note = require('fs').readFileSync(noteFile, 'utf8');
+  }
+  note = String(note || '').replace(/\r\n?/g, '\n').trim();
+  if (note.length > INVITE_NOTE_MAX) throw new Error(`Keep the note under ${INVITE_NOTE_MAX} characters (it is ${note.length}).`);
+  // The name the email says it is from, for this send only. Empty means your account's display name.
+  const fromName = String(parseOption(args, '--from-name', '') || '').replace(/\s+/g, ' ').trim();
+  if (fromName && fromName.includes('@')) throw new Error('--from-name takes a name, not an email address.');
+  if (fromName && (fromName.length < 2 || fromName.length > 64)) throw new Error('--from-name must be 2 to 64 characters.');
+
+  const payload = await httpJson(`${inviteUrl}/email`, 'POST', { emails, accessRole: role, ...(note ? { note } : {}), ...(fromName ? { fromName } : {}) }, authHeaders);
+  const results = Array.isArray(payload?.results) ? payload.results : [];
+  const sent = results.filter((r) => r.sent);
+  const notSent = results.filter((r) => !r.sent);
+  if (sent.length) log(uiSuccess(`Invited to ${target.label} as ${role}: ${sent.map((r) => r.email).join(', ')}`));
+  for (const r of notSent) {
+    log(`Not sent to ${r.email}: ${NOT_SENT_REASONS[r.skippedReason] || r.skippedReason || 'unknown reason'}.${r.detail ? ` ${r.detail}` : ''}`);
+  }
+  if (sent.length && payload?.fromName) log(`Sent as ${payload.fromName}.`);
+  if (sent.length && note) log('Your note was included.');
+  if (!sent.length) process.exitCode = 1;
 }
 
 function describeSelectionSource(selection) {
@@ -72,7 +120,7 @@ function workspaceOptions(payload) {
 }
 
 function positionalArgs(args, startIndex) {
-  const valueOptions = new Set(['--description', '--role', '--expires-in-days', '--max-uses', '--answers', '--workspace-id']);
+  const valueOptions = new Set(['--description', '--role', '--expires-in-days', '--max-uses', '--answers', '--workspace-id', '--note', '--note-file', '--from-name']);
   const positional = [];
   for (let index = startIndex; index < args.length; index += 1) {
     if (valueOptions.has(args[index])) {
@@ -400,17 +448,23 @@ async function runWorkspaceCommand(args) {
       if (action === 'invite') {
         requireClientId(clientId);
         const inviteAction = args[2];
-        const currentPayload = await httpJson(currentUrl, 'GET', null, authHeaders);
-        const current = currentPayload?.current;
-        if (!current?.key || current.key === 'default_brain') {
-          throw new Error('Workspace invites require an active team workspace. Use `empirical workspace use <workspace>` first.');
+        const namedWorkspace = parseOption(args, '--workspace-id', '');
+        let target;
+        if (namedWorkspace) {
+          target = { workspaceId: namedWorkspace, label: namedWorkspace };
+        } else {
+          const currentPayload = await httpJson(currentUrl, 'GET', null, authHeaders);
+          const current = currentPayload?.current;
+          if (!current?.key || current.key === 'default_brain') {
+            throw new Error('Workspace invites require an active team workspace. Use `empirical workspace use <workspace>` first, or pass --workspace-id.');
+          }
+          const teamPayload = await httpJson(teamBrainsUrl, 'GET', null, authHeaders);
+          target = resolveWorkspaceTarget(
+            current.workspaceId || current.key,
+            { workspaces: [{ key: current.key, label: current.label, workspaceId: current.workspaceId }] },
+            teamPayload
+          );
         }
-        const teamPayload = await httpJson(teamBrainsUrl, 'GET', null, authHeaders);
-        const target = resolveWorkspaceTarget(
-          current.workspaceId || current.key,
-          { workspaces: [{ key: current.key, label: current.label, workspaceId: current.workspaceId }] },
-          teamPayload
-        );
         if (!target?.workspaceId) {
           throw new Error('The active workspace is not a team workspace available for invites.');
         }
@@ -434,6 +488,11 @@ async function runWorkspaceCommand(args) {
           return;
         }
 
+        if (inviteAction === 'email') {
+          await runInviteEmail({ args, inviteUrl, authHeaders, target });
+          return;
+        }
+
         if (inviteAction === 'list') {
           const payload = await httpJson(inviteUrl, 'GET', null, authHeaders);
           const invites = Array.isArray(payload?.invites) ? payload.invites : [];

package/package.json

@@ -1,33 +1,33 @@
-{
-  "name": "@empirical-gauzza/cli",
-  "version": "1.0.39",
-  "description": "Persistent cross-tool memory for AI agents. Give Claude Code, Codex, Copilot, Cursor, and ChatGPT one shared memory: save project context once, recall it everywhere via CLI or MCP.",
-  "keywords": [
-    "memory",
-    "mcp",
-    "agent memory",
-    "ai memory",
-    "claude",
-    "chatgpt",
-    "model context protocol",
-    "persistent memory",
-    "claude-code",
-    "codex",
-    "knowledge base"
-  ],
-  "type": "commonjs",
-  "license": "MIT",
-  "homepage": "https://empirical.gauzza.com/docs/cli-details",
-  "publishConfig": {
-    "access": "public"
-  },
-  "bin": {
-    "empirical": "bin/empirical.js"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "gray-matter": "^4.0.3"
-  }
-}
+{
+  "name": "@empirical-gauzza/cli",
+  "version": "1.0.40",
+  "description": "Persistent cross-tool memory for AI agents. Give Claude Code, Codex, Copilot, Cursor, and ChatGPT one shared memory: save project context once, recall it everywhere via CLI or MCP.",
+  "keywords": [
+    "memory",
+    "mcp",
+    "agent memory",
+    "ai memory",
+    "claude",
+    "chatgpt",
+    "model context protocol",
+    "persistent memory",
+    "claude-code",
+    "codex",
+    "knowledge base"
+  ],
+  "type": "commonjs",
+  "license": "MIT",
+  "homepage": "https://empirical.gauzza.com/docs/cli-details",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "empirical": "bin/empirical.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "gray-matter": "^4.0.3"
+  }
+}