globalize-now-project-setup

Globalize Project Setup

The Globalize CLI (@globalize-now/cli-client) lets AI agents manage translation projects, languages, glossaries, style guides, and repository connections on the Globalize platform.

This skill creates a translation project, connects your git repository, and sets the catalog file patterns. It assumes you are already signed in.

Follow these steps in order.

---

Auth precheck

Before anything else, confirm the CLI is installed and authenticated:

npx @globalize-now/cli-client auth status --json

If this returns a valid source and key, continue. If it fails or reports no credentials, STOP:

"You're not signed in to Globalize yet. Run the globalize-now-account-setup skill first to install the CLI and authenticate, then re-run this skill."

---

Supplied inputs (orchestrated mode)

This skill can be driven by another skill (e.g. the globalize-guide orchestrator) that has already collected the project details and just-converted catalog paths.

If .globalize/globalize-inputs.json exists in the project root (or the invoking prompt supplies these values directly), read it and treat its fields as authoritative: skip the detection in Step 1 and the Setup Mode prompt below, run unguided, and proceed straight to Step 2 (provider connection) → Step 3 (create project) → Step 4 (connect repo). Do not re-detect or re-prompt for anything the file provides.

Expected shape:

{
  "projectName": "my-app",
  "sourceLocale": "en",
  "targetLocales": ["de", "fr", "es"],
  "provider": "github",
  "owner": "acme",
  "repo": "my-app",
  "gitUrl": "https://github.com/acme/my-app.git",
  "catalogPath": "src/locales/{locale}/messages.po",
  "localePathPattern": "src/locales/{locale}/messages.po",
  "fileFormat": "po",
  "pathLocales": [],
  "importMode": "ignore",
  "importScope": "new_keys_only",
  "mode": "orchestrated"
}

localePathPattern + fileFormat are the values to pass to repositories create --patterns (skip the server-side github detect / gitlab detect step — patterns are already known).