---
title: CLI and Message Studio
description: Add locales, extract messages, compile catalogs, and run the translation interface.
order: 21
toc:
  - id: scripts
    title: Scripts
  - id: commands
    title: Commands
  - id: daily-workflow
    title: Daily workflow
---

## Scripts {#scripts}

```json
{
  "scripts": {
    "i18n": "workspace-i18n",
    "i18n:extract": "workspace-i18n extract",
    "i18n:compile": "workspace-i18n compile",
    "i18n:ui": "workspace-i18n ui"
  }
}
```

## Commands {#commands}

- `new <locale>` validates a BCP 47 tag, updates configuration, and creates the catalog.
- `extract` finds application messages and updates catalogs.
- `compile` produces TypeScript catalog modules.
- `ui` starts Message Studio with Extract and Compile actions.

Every command accepts `--project <path>` when it is invoked outside the application directory.

## Daily workflow {#daily-workflow}

```sh
bun run i18n extract
bun run i18n ui
bun run i18n compile
```

Commit the application configuration and the `en-US` and `zh-Hans` catalogs. Generated private schema data remains build output.