Skip to main content

crowdin context download

Description​

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

Synopsis​

crowdin context download [CONFIG OPTIONS] [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)

--format=…
Output format. Supported values: jsonl

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

-V, --version
Display version information and exit

-h, --help
Display help message and exit

--no-progress
Disable progress on executed command

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

--no-colors
Disable colors and styles

-c, --config=…
Specify a path to the configuration file. Default: crowdin.yml or crowdin.yaml

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

--plain
Provide plain, processable output

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

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.