@palamedes/cli

The Palamedes command-line interface for extracting message catalogs quickly and predictably.

This is the package behind the pmds binary. Use it when you want extraction in local development, CI, or custom scripts without wiring the lower-level extractor yourself.

When To Use This Package

Use @palamedes/cli when you want:

• a supported extraction command for Palamedes projects
• watch mode during development
• a clean way to update .po catalogs in CI

If you are building your own extraction workflow inside your i18n config or custom tooling, look at @palamedes/extractor instead.

Installation

pnpm add -D @palamedes/cli

Or run it without adding it to your project first:

pnpm dlx @palamedes/cli extract

Usage

pnpm exec pmds extract
pnpm exec pmds extract --watch
pnpm exec pmds extract --clean
pnpm exec pmds extract --config ./palamedes.config.ts
pnpm exec pmds extract --verbose

Configuration

@palamedes/cli uses palamedes.config.ts or palamedes.config.js.

import { defineConfig } from "@palamedes/config"

export default defineConfig({
  locales: ["en", "de"],
  sourceLocale: "en",
  catalogs: [
    {
      path: "src/locales/{locale}",
      include: ["src"],
    },
  ],
})

Related Packages

• @palamedes/extractor for low-level extraction
• @palamedes/vite-plugin for Vite integration
• @palamedes/next-plugin for Next.js integration
• @palamedes/runtime for runtime wiring

License

MIT © 2026 Sebastian Software