Skip to main content

crowdin context download

Description​

Download strings context to a separate file for enrichment by AI Agent

Synopsis​

crowdin context download [OPTIONS]

Options​

--to=…
File path to download the context to (default: "crowdin-context.jsonl")

-f, --file=…
Filter strings by Crowdin file paths (glob) (multiple paths can be specified)

--label=…
Filter strings by labels (multiple labels can be specified)

-b, --branch=…
Filter by branch name

--croql=…
CroQL expression

--since=…
Only strings created after this date (YYYY-MM-DD)

--status=…
Filter by context status. Supported values: empty, ai, manual

-h, --help
Display help message and exit

Config Options​

-T, --token=…
Personal access token required for authentication

--base-url=…
Base URL of Crowdin server for API requests execution

--base-path=…
Path to your project directory on a local machine

-i, --project-id=…
Numeric ID of the project

Global Options​

-v, --verbose
Provide more information about the command execution

-c, --config=…
Specify a path to the configuration file

--identity=…
Specify a path to user-specific credentials

--no-colors
Disable colors and styles

--no-progress
Disable progress on executed command

-o, --output=…
Change output format (choices: "json", "toon", "plain")

JSONL​

The command exports the project's strings to a local .jsonl file, ready for AI enrichment. JSONL is a line-delimited format that is easy to parse and write. It is a good format for AI agents to work with.

The JSON objects in the file include the following fields:

  • id: String ID in Crowdin
  • key: String key
  • text: Source text
  • file: Crowdin file path
  • context: Existing source context
  • ai_context: AI context to set

Notes​

The --croql option cannot be used together with other filter options.