locize-cli 12.4.0 → 12.5.0

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 Project versioning adheres to [Semantic Versioning](http://semver.org/).
 Change log format is based on [Keep a Changelog](http://keepachangelog.com/).
 
+## [12.5.0](https://github.com/locize/locize-cli/compare/v12.4.0...v12.5.0) - 2026-07-15
+
+- sync: removed keys are now listed by name in real runs too (previously the
+  names were only shown with `--dry`), capped at 50 keys per namespace, so a
+  sync always shows exactly what it deleted. When keys are removed without
+  `--backup-deleted-path`, a one-line tip now points to `-B` to keep a local
+  backup of the removed segments ([98](https://github.com/locize/locize-cli/issues/98)).
+- remove: accepts multiple keys (`locize remove common title subtitle ...`),
+  batched into a single update request per language ([53](https://github.com/locize/locize-cli/issues/53)).
+- docs: README notes for pnpm >= 11 (`blockExoticSubdeps` and why `xlsx` is
+  pinned to the SheetJS CDN tarball) and for the xcstrings format (file-level
+  conversion; i18next plural suffixes / `{{...}}` interpolation are not
+  rewritten to String Catalog plural variations / format specifiers).
+
 ## [12.4.0](https://github.com/locize/locize-cli/compare/v12.3.1...v12.4.0) - 2026-07-06
 
 - xliff: proper support for inline elements (e.g. Angular's

package/README.md

@@ -12,6 +12,11 @@
 npm install -g locize-cli
 ```
 
+> ℹ️ **pnpm >= 11:** locize-cli depends on `xlsx` pinned to the official SheetJS CDN tarball, because the npm registry version is outdated and has known vulnerabilities. pnpm 11 blocks such non-registry transitive dependencies by default (`ERR_PNPM_EXOTIC_SUBDEP`). Install with npm, or opt out in your `pnpm-workspace.yaml`:
+> ```yaml
+> blockExoticSubdeps: false
+> ```
+
 ### with Shell: (downloads [released](https://github.com/locize/locize-cli/releases) (linux or macos) binaries)
 
 ```sh
@@ -67,6 +72,12 @@ or
 locize remove common title
 ```
 
+or remove multiple keys at once (batched into one request per language):
+
+```sh
+locize remove common title subtitle description
+```
+
 
 ## Get keys
 ### Step 1: execute
@@ -110,6 +121,7 @@ or add a format like (json, nested, flat, xliff2, xliff21, xliff22, xliff12, xlf
 *Special formats:*
 - use yaml-rails to have the language code in the resulting yaml as root object
 - use yaml-rails-ns to have the namespace in the resulting yaml as first key scope
+- xcstrings (Apple String Catalog): conversion happens at the file level, not at the in-string syntax level — i18next-style plural suffixes (`key_one`/`key_other`) stay separate entries (they are not merged into `variations.plural`) and interpolation placeholders like `{{name}}` are not rewritten to `%@`/`%lld` format specifiers. For a clean String Catalog export, the content should already use xcstrings-native plural variations and format specifiers.
 
 ```sh
 locize download --project-id my-project-id-93e1-442a-ab35-24331fa294ba --ver latest --language en --namespace namespace1 --path ./backup --format android
@@ -165,6 +177,7 @@ or add a format like (json, nested, flat, xliff2, xliff21, xliff22, xliff12, xlf
 *Special formats:*
 - use yaml-rails to have the language code in the resulting yaml as root object
 - use yaml-rails-ns to have the namespace in the resulting yaml as first key scope
+- xcstrings (Apple String Catalog): conversion happens at the file level, not at the in-string syntax level — i18next-style plural suffixes (`key_one`/`key_other`) stay separate entries (they are not merged into `variations.plural`) and interpolation placeholders like `{{name}}` are not rewritten to `%@`/`%lld` format specifiers. For a clean String Catalog export, the content should already use xcstrings-native plural variations and format specifiers.
 
 ```sh
 locize sync --api-key my-api-key-d9de-4f55-9855-a9ef0ed44672 --project-id my-project-id-93e1-442a-ab35-24331fa294ba --format android

package/dist/cjs/add.js

@@ -5,6 +5,18 @@ var flatten = require('flat');
 var getRemoteLanguages = require('./getRemoteLanguages.js');
 var request = require('./request.js');
 
+const payloadOf = (opt) => {
+  const data = flatten(opt.data || {});
+  if (!opt.data) {
+    data[opt.key] = opt.value || null; // null will remove the key
+  }
+  return data
+};
+
+const isRemoval = (data) => Object.keys(data).length > 0 && Object.values(data).every((v) => v === undefined || v === null);
+
+const keyLabel = (opt, data) => opt.key || Object.keys(data).join(', ');
+
 const _add = async (opt) => {
   const url = `${opt.apiEndpoint}/update/{{projectId}}/{{version}}/{{lng}}/{{ns}}`
     .replace('{{projectId}}', opt.projectId)
@@ -15,15 +27,14 @@ const _add = async (opt) => {
     .replace('{{ns}}', opt.namespace)
     .replace('{{namespace}}', opt.namespace);
 
-  if (!opt.data && (opt.value === undefined || opt.value === null)) {
-    console.log(colors.yellow(`removing ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
-  } else {
-    console.log(colors.yellow(`adding ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
-  }
+  const data = payloadOf(opt);
+  const removing = isRemoval(data);
+  const label = keyLabel(opt, data);
 
-  const data = flatten(opt.data || {});
-  if (!opt.data) {
-    data[opt.key] = opt.value || null; // null will remove the key
+  if (removing) {
+    console.log(colors.yellow(`removing ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+  } else {
+    console.log(colors.yellow(`adding ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
   }
 
   try {
@@ -35,10 +46,10 @@ const _add = async (opt) => {
       body: data
     });
     if (res.status >= 300 && res.status !== 412) {
-      if (!opt.data && (opt.value === undefined || opt.value === null)) {
-        console.log(colors.red(`remove failed for ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+      if (removing) {
+        console.log(colors.red(`remove failed for ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
       } else {
-        console.log(colors.red(`add failed for ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
+        console.log(colors.red(`add failed for ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
       }
       if (obj && (obj.errorMessage || obj.message)) {
         console.error(colors.red((obj.errorMessage || obj.message)));
@@ -49,16 +60,16 @@ const _add = async (opt) => {
       }
       return
     }
-    if (!opt.data && (opt.value === undefined || opt.value === null)) {
-      console.log(colors.green(`removed ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+    if (removing) {
+      console.log(colors.green(`removed ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
     } else {
-      console.log(colors.green(`added ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
+      console.log(colors.green(`added ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
     }
   } catch (err) {
-    if (!opt.data && (opt.value === undefined || opt.value === null)) {
-      console.log(colors.red(`remove failed for ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+    if (removing) {
+      console.log(colors.red(`remove failed for ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
     } else {
-      console.log(colors.red(`add failed for ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
+      console.log(colors.red(`add failed for ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
     }
     console.error(colors.red(err.message));
     process.exit(1);
@@ -80,10 +91,11 @@ const add = async (opt) => {
     opt.language = lng;
     await _add(opt);
   }
-  if (!opt.data && (opt.value === undefined || opt.value === null)) {
-    console.log(colors.green(`removed ${opt.namespace}/${opt.key} (${opt.version}) from all languages...`));
+  const data = payloadOf(opt);
+  if (isRemoval(data)) {
+    console.log(colors.green(`removed ${opt.namespace}/${keyLabel(opt, data)} (${opt.version}) from all languages...`));
   } else {
-    console.log(colors.green(`added ${opt.namespace}/${opt.key} (${opt.version}) in all languages...`));
+    console.log(colors.green(`added ${opt.namespace}/${keyLabel(opt, data)} (${opt.version}) in all languages...`));
   }
 };
 

package/dist/cjs/cli.js

@@ -50,7 +50,7 @@ const program = new commander.Command();
 
 program
   .description('The official locize CLI.')
-  .version('12.4.0'); // This string is replaced with the actual version at build time by rollup
+  .version('12.5.0'); // This string is replaced with the actual version at build time by rollup
 // .option('-a, --api-endpoint <url>', `Specify the api-endpoint url that should be used (default: ${defaultApiEndpoint})`)
 // .option('-C, --config-path <configPath>', `Specify the path to the optional locize config file (default: ${configInWorkingDirectory} or ${configInHome})`);
 
@@ -189,9 +189,9 @@ program
   });
 
 program
-  .command('remove <namespace> <key>')
+  .command('remove <namespace> <key...>')
   .alias('rm')
-  .description('remove a key')
+  .description('remove one or more keys')
   .option('-k, --api-key <apiKey>', 'The api-key that should be used')
   .option('-i, --project-id <projectId>', 'The project-id that should be used')
   .option('-l, --language <lng>', 'The language that should be targeted (omitting this attribute will result in removing the key from all languages)')
@@ -199,7 +199,7 @@ program
   .option('-a, --api-endpoint <url>', `Specify the api-endpoint url that should be used (default: ${defaultApiEndpoint})`)
   .option('-C, --config-path <configPath>', `Specify the path to the optional locize config file (default: ${configInWorkingDirectory} or ${configInHome})`)
   .option('--ct, --cdn-type <standard|pro>', `Specify the cdn endpoint that should be used (depends on which cdn type you've in your Locize project) (default: ${defaultCdnType})`)
-  .action((namespace, key, options) => {
+  .action((namespace, keys, options) => {
     try {
       config = ini.parse(fs.readFileSync(options.configPath, 'utf-8')) || config;
     } catch (e) {}
@@ -240,13 +240,16 @@ program
       language,
       version,
       namespace,
-      key
+      key: keys.length === 1 ? keys[0] : undefined,
+      // multiple keys are batched into one update request per language
+      data: keys.length > 1 ? keys.reduce((m, k) => { m[k] = null; return m }, {}) : undefined
     });
   })
   .on('--help', () => {
     console.log('  Examples:');
     console.log();
     console.log('    $ locize remove common title');
+    console.log('    $ locize remove common title subtitle description');
     console.log('    $ locize remove common title --language en');
     console.log('    $ locize remove common title --api-key <apiKey> --project-id <projectId> --language en');
     console.log();

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "locize-cli",
-  "version": "12.4.0",
+  "version": "12.5.0",
   "type": "commonjs"
 }

package/dist/cjs/request.js

@@ -43,7 +43,7 @@ async function request (url, options) {
   }
 
   options.headers = options.headers || {};
-  options.headers['User-Agent'] = `locize-cli/v12.4.0 (node/${process.version}; ${process.platform} ${process.arch})`; // This string is replaced with the actual version at build time by rollup
+  options.headers['User-Agent'] = `locize-cli/v12.5.0 (node/${process.version}; ${process.platform} ${process.arch})`; // This string is replaced with the actual version at build time by rollup
   options.headers['X-User-Agent'] = options.headers['User-Agent'];
   if (options.body || options.method !== 'get') options.headers['Content-Type'] = 'application/json';
   if (options.body) {

package/dist/cjs/sync.js

@@ -195,6 +195,8 @@ const cleanupLanguages = (opt, remoteLanguages) => {
   });
 };
 
+const listRemovedKeys = (keys) => keys.length <= 50 ? keys.join(', ') : `${keys.slice(0, 50).join(', ')} ... and ${keys.length - 50} more`;
+
 const backupDeleted = (opt, ns, now) => {
   if (opt.dry || ns.diff.toRemove.length === 0) return
   let m = now.getMonth() + 1;
@@ -529,6 +531,7 @@ async function handleSync (opt, remoteLanguages, localNamespaces) {
   const shouldOmit = lngsInReqs.length > 5 || nsInReqs.length > 5;
 
   let wasThereSomethingToUpdate = opt.autoTranslate || false;
+  let suggestBackupTip = false;
 
   async function updateComparedNamespaces () {
     const now = new Date();
@@ -539,14 +542,13 @@ async function handleSync (opt, remoteLanguages, localNamespaces) {
           console.log(colors.bgRed(`skipping the removal of ${ns.diff.toRemove.length} keys in ${ns.language}/${ns.namespace}...`));
           if (opt.dry) console.log(colors.bgRed(`skipped to remove ${ns.diff.toRemove.join(', ')} in ${ns.language}/${ns.namespace}...`));
         } else {
-          console.log(colors.red(`removing ${ns.diff.toRemove.length} keys in ${ns.language}/${ns.namespace}...`));
-          if (opt.dry) console.log(colors.red(`would remove ${ns.diff.toRemove.join(', ')} in ${ns.language}/${ns.namespace}...`));
+          console.log(colors.red(`${opt.dry ? 'would remove' : 'removing'} ${ns.diff.toRemove.length} keys in ${ns.language}/${ns.namespace}: ${listRemovedKeys(ns.diff.toRemove)}`));
           if (!opt.dry && opt.backupDeletedPath) backupDeleted(opt, ns, now);
+          if (!opt.dry && !opt.backupDeletedPath) suggestBackupTip = true;
         }
       }
       if (ns.diff.toRemoveLocally.length > 0) {
-        console.log(colors.red(`removing ${ns.diff.toRemoveLocally.length} keys in ${ns.language}/${ns.namespace} locally...`));
-        if (opt.dry) console.log(colors.red(`would remove ${ns.diff.toRemoveLocally.join(', ')} in ${ns.language}/${ns.namespace} locally...`));
+        console.log(colors.red(`${opt.dry ? 'would remove' : 'removing'} ${ns.diff.toRemoveLocally.length} keys in ${ns.language}/${ns.namespace} locally: ${listRemovedKeys(ns.diff.toRemoveLocally)}`));
       }
       if (ns.diff.toAdd.length > 0) {
         console.log(colors.green(`adding ${ns.diff.toAdd.length} keys in ${ns.language}/${ns.namespace}...`));
@@ -585,6 +587,8 @@ async function handleSync (opt, remoteLanguages, localNamespaces) {
       });
     });
 
+    if (suggestBackupTip) console.log(colors.yellow('tip: use -B <path> (--backup-deleted-path) to keep a local backup of removed segments'));
+
     console.log(colors.grey('syncing...'));
 
     async function down () {

package/dist/esm/add.js

@@ -3,6 +3,18 @@ import flatten from 'flat';
 import getRemoteLanguages from './getRemoteLanguages.js';
 import request from './request.js';
 
+const payloadOf = (opt) => {
+  const data = flatten(opt.data || {});
+  if (!opt.data) {
+    data[opt.key] = opt.value || null; // null will remove the key
+  }
+  return data
+};
+
+const isRemoval = (data) => Object.keys(data).length > 0 && Object.values(data).every((v) => v === undefined || v === null);
+
+const keyLabel = (opt, data) => opt.key || Object.keys(data).join(', ');
+
 const _add = async (opt) => {
   const url = `${opt.apiEndpoint}/update/{{projectId}}/{{version}}/{{lng}}/{{ns}}`
     .replace('{{projectId}}', opt.projectId)
@@ -13,15 +25,14 @@ const _add = async (opt) => {
     .replace('{{ns}}', opt.namespace)
     .replace('{{namespace}}', opt.namespace);
 
-  if (!opt.data && (opt.value === undefined || opt.value === null)) {
-    console.log(colors.yellow(`removing ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
-  } else {
-    console.log(colors.yellow(`adding ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
-  }
+  const data = payloadOf(opt);
+  const removing = isRemoval(data);
+  const label = keyLabel(opt, data);
 
-  const data = flatten(opt.data || {});
-  if (!opt.data) {
-    data[opt.key] = opt.value || null; // null will remove the key
+  if (removing) {
+    console.log(colors.yellow(`removing ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+  } else {
+    console.log(colors.yellow(`adding ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
   }
 
   try {
@@ -33,10 +44,10 @@ const _add = async (opt) => {
       body: data
     });
     if (res.status >= 300 && res.status !== 412) {
-      if (!opt.data && (opt.value === undefined || opt.value === null)) {
-        console.log(colors.red(`remove failed for ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+      if (removing) {
+        console.log(colors.red(`remove failed for ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
       } else {
-        console.log(colors.red(`add failed for ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
+        console.log(colors.red(`add failed for ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
       }
       if (obj && (obj.errorMessage || obj.message)) {
         console.error(colors.red((obj.errorMessage || obj.message)));
@@ -47,16 +58,16 @@ const _add = async (opt) => {
       }
       return
     }
-    if (!opt.data && (opt.value === undefined || opt.value === null)) {
-      console.log(colors.green(`removed ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+    if (removing) {
+      console.log(colors.green(`removed ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
     } else {
-      console.log(colors.green(`added ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
+      console.log(colors.green(`added ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
     }
   } catch (err) {
-    if (!opt.data && (opt.value === undefined || opt.value === null)) {
-      console.log(colors.red(`remove failed for ${opt.key} from ${opt.version}/${opt.language}/${opt.namespace}...`));
+    if (removing) {
+      console.log(colors.red(`remove failed for ${label} from ${opt.version}/${opt.language}/${opt.namespace}...`));
     } else {
-      console.log(colors.red(`add failed for ${opt.key} to ${opt.version}/${opt.language}/${opt.namespace}...`));
+      console.log(colors.red(`add failed for ${label} to ${opt.version}/${opt.language}/${opt.namespace}...`));
     }
     console.error(colors.red(err.message));
     process.exit(1);
@@ -78,10 +89,11 @@ const add = async (opt) => {
     opt.language = lng;
     await _add(opt);
   }
-  if (!opt.data && (opt.value === undefined || opt.value === null)) {
-    console.log(colors.green(`removed ${opt.namespace}/${opt.key} (${opt.version}) from all languages...`));
+  const data = payloadOf(opt);
+  if (isRemoval(data)) {
+    console.log(colors.green(`removed ${opt.namespace}/${keyLabel(opt, data)} (${opt.version}) from all languages...`));
   } else {
-    console.log(colors.green(`added ${opt.namespace}/${opt.key} (${opt.version}) in all languages...`));
+    console.log(colors.green(`added ${opt.namespace}/${keyLabel(opt, data)} (${opt.version}) in all languages...`));
   }
 };
 

package/dist/esm/cli.js

@@ -48,7 +48,7 @@ const program = new Command();
 
 program
   .description('The official locize CLI.')
-  .version('12.4.0'); // This string is replaced with the actual version at build time by rollup
+  .version('12.5.0'); // This string is replaced with the actual version at build time by rollup
 // .option('-a, --api-endpoint <url>', `Specify the api-endpoint url that should be used (default: ${defaultApiEndpoint})`)
 // .option('-C, --config-path <configPath>', `Specify the path to the optional locize config file (default: ${configInWorkingDirectory} or ${configInHome})`);
 
@@ -187,9 +187,9 @@ program
   });
 
 program
-  .command('remove <namespace> <key>')
+  .command('remove <namespace> <key...>')
   .alias('rm')
-  .description('remove a key')
+  .description('remove one or more keys')
   .option('-k, --api-key <apiKey>', 'The api-key that should be used')
   .option('-i, --project-id <projectId>', 'The project-id that should be used')
   .option('-l, --language <lng>', 'The language that should be targeted (omitting this attribute will result in removing the key from all languages)')
@@ -197,7 +197,7 @@ program
   .option('-a, --api-endpoint <url>', `Specify the api-endpoint url that should be used (default: ${defaultApiEndpoint})`)
   .option('-C, --config-path <configPath>', `Specify the path to the optional locize config file (default: ${configInWorkingDirectory} or ${configInHome})`)
   .option('--ct, --cdn-type <standard|pro>', `Specify the cdn endpoint that should be used (depends on which cdn type you've in your Locize project) (default: ${defaultCdnType})`)
-  .action((namespace, key, options) => {
+  .action((namespace, keys, options) => {
     try {
       config = ini.parse(fs.readFileSync(options.configPath, 'utf-8')) || config;
     } catch (e) {}
@@ -238,13 +238,16 @@ program
       language,
       version,
       namespace,
-      key
+      key: keys.length === 1 ? keys[0] : undefined,
+      // multiple keys are batched into one update request per language
+      data: keys.length > 1 ? keys.reduce((m, k) => { m[k] = null; return m }, {}) : undefined
     });
   })
   .on('--help', () => {
     console.log('  Examples:');
     console.log();
     console.log('    $ locize remove common title');
+    console.log('    $ locize remove common title subtitle description');
     console.log('    $ locize remove common title --language en');
     console.log('    $ locize remove common title --api-key <apiKey> --project-id <projectId> --language en');
     console.log();

package/dist/esm/request.js

@@ -41,7 +41,7 @@ async function request (url, options) {
   }
 
   options.headers = options.headers || {};
-  options.headers['User-Agent'] = `locize-cli/v12.4.0 (node/${process.version}; ${process.platform} ${process.arch})`; // This string is replaced with the actual version at build time by rollup
+  options.headers['User-Agent'] = `locize-cli/v12.5.0 (node/${process.version}; ${process.platform} ${process.arch})`; // This string is replaced with the actual version at build time by rollup
   options.headers['X-User-Agent'] = options.headers['User-Agent'];
   if (options.body || options.method !== 'get') options.headers['Content-Type'] = 'application/json';
   if (options.body) {

package/dist/esm/sync.js

@@ -193,6 +193,8 @@ const cleanupLanguages = (opt, remoteLanguages) => {
   });
 };
 
+const listRemovedKeys = (keys) => keys.length <= 50 ? keys.join(', ') : `${keys.slice(0, 50).join(', ')} ... and ${keys.length - 50} more`;
+
 const backupDeleted = (opt, ns, now) => {
   if (opt.dry || ns.diff.toRemove.length === 0) return
   let m = now.getMonth() + 1;
@@ -527,6 +529,7 @@ async function handleSync (opt, remoteLanguages, localNamespaces) {
   const shouldOmit = lngsInReqs.length > 5 || nsInReqs.length > 5;
 
   let wasThereSomethingToUpdate = opt.autoTranslate || false;
+  let suggestBackupTip = false;
 
   async function updateComparedNamespaces () {
     const now = new Date();
@@ -537,14 +540,13 @@ async function handleSync (opt, remoteLanguages, localNamespaces) {
           console.log(colors.bgRed(`skipping the removal of ${ns.diff.toRemove.length} keys in ${ns.language}/${ns.namespace}...`));
           if (opt.dry) console.log(colors.bgRed(`skipped to remove ${ns.diff.toRemove.join(', ')} in ${ns.language}/${ns.namespace}...`));
         } else {
-          console.log(colors.red(`removing ${ns.diff.toRemove.length} keys in ${ns.language}/${ns.namespace}...`));
-          if (opt.dry) console.log(colors.red(`would remove ${ns.diff.toRemove.join(', ')} in ${ns.language}/${ns.namespace}...`));
+          console.log(colors.red(`${opt.dry ? 'would remove' : 'removing'} ${ns.diff.toRemove.length} keys in ${ns.language}/${ns.namespace}: ${listRemovedKeys(ns.diff.toRemove)}`));
           if (!opt.dry && opt.backupDeletedPath) backupDeleted(opt, ns, now);
+          if (!opt.dry && !opt.backupDeletedPath) suggestBackupTip = true;
         }
       }
       if (ns.diff.toRemoveLocally.length > 0) {
-        console.log(colors.red(`removing ${ns.diff.toRemoveLocally.length} keys in ${ns.language}/${ns.namespace} locally...`));
-        if (opt.dry) console.log(colors.red(`would remove ${ns.diff.toRemoveLocally.join(', ')} in ${ns.language}/${ns.namespace} locally...`));
+        console.log(colors.red(`${opt.dry ? 'would remove' : 'removing'} ${ns.diff.toRemoveLocally.length} keys in ${ns.language}/${ns.namespace} locally: ${listRemovedKeys(ns.diff.toRemoveLocally)}`));
       }
       if (ns.diff.toAdd.length > 0) {
         console.log(colors.green(`adding ${ns.diff.toAdd.length} keys in ${ns.language}/${ns.namespace}...`));
@@ -583,6 +585,8 @@ async function handleSync (opt, remoteLanguages, localNamespaces) {
       });
     });
 
+    if (suggestBackupTip) console.log(colors.yellow('tip: use -B <path> (--backup-deleted-path) to keep a local backup of removed segments'));
+
     console.log(colors.grey('syncing...'));
 
     async function down () {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "locize-cli",
-  "version": "12.4.0",
+  "version": "12.5.0",
   "description": "locize cli to import locales",
   "type": "module",
   "main": "./dist/cjs/index.js",