A tiny friend in your Mac's notch and on your iPhone that keeps an eye on your AI coding agents: Claude Code, Codex, Cursor, Gemini CLI, Antigravity and more. Approve from the notch or your Lock Screen.
Swift ai-agentsanthropicantigravityclaudeclaude-codecodexcursordynamic-islandgemini-cliiosiphonlinuxmacosmacos-appmenubar-appnotchopen-sourceswiftswiftuiwindows
// Generates src/i18n/strings.json from the Mac app's string catalog
// (NotchBuddy/Resources/Localizable.xcstrings), so Windows and Linux show the
// Mac's own translations.
//
// node scripts/gen-strings.mjs writes src/i18n/strings.json
// node scripts/gen-strings.mjs --check fails if the file is out of date
//
// Every entry is keyed by its English text, as the Mac's are (a Mac key such as
// "step.reads" is replaced by its English value, "Reads"). Format specifiers
// become named or numbered placeholders: "%@" and "%lld" → "{0}", "{1}"…
// ("%1$@" keeps its number), renamed where RENAMES says so. Plural entries keep
// their categories ({ "one": …, "other": … }) and are keyed by the English
// "other" form. English is the key itself, so it is not stored.
//
// Strings the Mac does not have (Windows and Linux only) live in
// src/i18n/extra.json, written by hand; see src/i18n/i18n.ts.
import { readFileSync, writeFileSync } from "node:fs";
import { dirname, resolve } from "node:path";
import { fileURLToPath } from "node:url";
const here = dirname(fileURLToPath(import.meta.url));
const SOURCE = resolve(here, "../../NotchBuddy/Resources/Localizable.xcstrings");
const OUTPUT = resolve(here, "../src/i18n/strings.json");
/** The languages Coucou ships, in the Mac's picker order. English is the source. */
export const LANGUAGES = ["en", "zh-Hans", "hi", "es", "ar", "fr", "bn", "pt-BR", "ru", "id", "de", "tr", "ko", "ja"];
/**
* Names for the placeholders of the Mac strings the Windows code uses, by Mac
* key: the n-th specifier becomes `{names[n]}` instead of `{n}`.
*/
const RENAMES = {
"Auto-close · %llds": ["seconds"],
"Chat with %@": ["name"],
"chat.subscriptions.default-model": ["tool"],
"chat.subscriptions.found": ["tool"],
"chat.subscriptions.missing": ["tool"],
"Claude is reading %@…": ["name"],
"Connected · %@": ["detail"],
"Key configured · %@": ["model"],
"Open %@": ["name"],
"Playing · %@": ["title"],
"Uploading %@": ["name"],
"Watching %lld of %lld": ["count", "total"],
"file.ready %@": ["name"],
"mail.with %@": ["name"],
"plan.hours-ago %lld": ["n"],
"plan.mins-ago %lld": ["n"],
"plan.reset-in-hm %lld %lld": ["h", "m"],
"plan.reset-in-m %lld": ["m"],
"settings.slots-used %lld": ["count"],
"status.local.connected %lld": ["count"],
"status.local.no-models %@": ["name"],
"status.local.unreachable %1$@ %2$@": ["name", "url"],
};
/** "%@ at %lld" → "{0} at {1}"; "%2$@" → "{1}"; "%%" → "%". */
export function convertFormat(text, names = []) {
let next = 0;
return text.replace(/%(?:(\d+)\$)?(@|lld|ld|d|lu|u|f|%)/g, (_m, pos, spec) => {
if (spec === "%") return "%";
const index = pos ? Number(pos) - 1 : next++;
return `{${names[index] ?? index}}`;
});
}
function unitValue(loc) {
return loc?.stringUnit?.value;
}
/** A localization as a string, or as plural categories. */
function readLocalization(loc, names) {
const plural = loc?.variations?.plural;
if (plural) {
const out = {};
for (const [category, v] of Object.entries(plural)) {
const value = unitValue(v);
if (typeof value === "string") out[category] = convertFormat(value, names);
}
return Object.keys(out).length ? out : undefined;
}
const value = unitValue(loc);
return typeof value === "string" ? convertFormat(value, names) : undefined;
}
export function generate(catalog) {
const strings = {};
for (const [macKey, entry] of Object.entries(catalog.strings ?? {})) {
const names = RENAMES[macKey] ?? [];
const locs = entry.localizations ?? {};
// A Mac key with no English localization is its own English text.
const en = readLocalization(locs.en, names) ?? convertFormat(macKey, names);
const key = typeof en === "string" ? en : en.other ?? Object.values(en)[0];
const out = {};
for (const lang of LANGUAGES) {
if (lang === "en") continue;
const value = readLocalization(locs[lang], names);
if (value !== undefined) out[lang] = value;
}
// Only a string translated in every language comes across. Xcode keeps every literal it finds in the catalog,
// brand names and placeholders like " +%@" too, with no translation; and a string still being translated on
// the Mac shows in English there. Either way Windows has nothing to add, and the tests below would flag it.
if (LANGUAGES.some((lang) => lang !== "en" && out[lang] === undefined)) continue;
// The English plural forms are needed to pick "one" in English too.
if (typeof en !== "string") out.en = en;
strings[key] = out;
}
const sorted = Object.fromEntries(Object.entries(strings).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)));
return {
_generated: "By scripts/gen-strings.mjs from NotchBuddy/Resources/Localizable.xcstrings. Do not edit: run `node scripts/gen-strings.mjs`.",
languages: LANGUAGES,
strings: sorted,
};
}
function main() {
const catalog = JSON.parse(readFileSync(SOURCE, "utf8"));
const text = `${JSON.stringify(generate(catalog), null, 1)}\n`;
if (process.argv.includes("--check")) {
let current = "";
try {
current = readFileSync(OUTPUT, "utf8");
} catch {
// missing: out of date
}
if (current !== text) {
console.error("src/i18n/strings.json is out of date: run `node scripts/gen-strings.mjs`.");
process.exit(1);
}
console.log("src/i18n/strings.json is up to date.");
return;
}
writeFileSync(OUTPUT, text);
const count = Object.keys(JSON.parse(text).strings).length;
console.log(`Wrote ${count} strings to src/i18n/strings.json`);
}
if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) main();