{
  "id": "crowdin",
  "name": "Crowdin CLI",
  "homepage": "https://github.com/crowdin/crowdin-cli",
  "description": "A command-line client for the Crowdin API.",
  "executables": [
    "crowdin"
  ],
  "dotfiles": {
    "paths": [
      "~/.crowdin.yaml"
    ],
    "exclude": [],
    "secret": [],
    "side_effect": false,
    "secret_paths": [
      {
        "file": "~/.crowdin.yaml",
        "match": {
          "key_path": [
            "api_key"
          ]
        }
      }
    ]
  },
  "commands": {
    "format": 1,
    "label": "Sync localization files",
    "description": "Upload source files to, or download translations from, a Crowdin project. Credentials normally come from crowdin.yml or the identity file, so --token is left out; other subcommands are not covered.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "subcommand": [
      {
        "path": [
          "upload",
          "sources"
        ],
        "label": "Upload source files",
        "source": [
          {
            "id": "docs",
            "kind": "manual",
            "url": "https://crowdin.github.io/crowdin-cli/commands/crowdin-upload-sources",
            "revision": "2026-10-27",
            "evidence": "crowdin upload sources [OPTIONS]\n-b, --branch=…\n--label=…\n--delete-obsolete\n--no-auto-update\n--cache\n--dryrun\n-c, --config=…\n-i, --project-id=…\n"
          }
        ],
        "field": [
          {
            "id": "branch",
            "label": "Branch",
            "type": "string",
            "option": [
              "--branch",
              "-b"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "label",
            "label": "Labels",
            "description": "Attach labels to strings.",
            "type": "string",
            "option": [
              "--label"
            ],
            "multiple": true,
            "sources": [
              "docs"
            ]
          },
          {
            "id": "config",
            "label": "Config file",
            "type": "path",
            "option": [
              "--config",
              "-c"
            ],
            "path": {
              "kind": "file",
              "role": "input",
              "must_exist": true
            },
            "sources": [
              "docs"
            ]
          },
          {
            "id": "project_id",
            "label": "Project ID",
            "type": "integer",
            "option": [
              "--project-id",
              "-i"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "delete_obsolete",
            "label": "Delete obsolete files",
            "description": "Remove files and folders from the Crowdin project that no longer match the source configuration.",
            "type": "boolean",
            "option": [
              "--delete-obsolete"
            ],
            "effect": "delete",
            "sources": [
              "docs"
            ]
          },
          {
            "id": "no_auto_update",
            "label": "Only upload new files",
            "type": "boolean",
            "option": [
              "--no-auto-update"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "cache",
            "label": "Skip unchanged files",
            "type": "boolean",
            "option": [
              "--cache"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "dryrun",
            "label": "Dry run",
            "type": "boolean",
            "option": [
              "--dryrun"
            ],
            "sources": [
              "docs"
            ]
          }
        ],
        "task": [
          {
            "id": "preview",
            "label": "Preview upload",
            "fields": [
              "branch",
              "config",
              "dryrun"
            ],
            "required": [],
            "set": {
              "dryrun": [
                true
              ]
            }
          },
          {
            "id": "upload",
            "label": "Upload sources",
            "fields": [
              "branch",
              "config",
              "cache",
              "label"
            ],
            "required": []
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "branch",
              "config",
              "project_id",
              "dryrun"
            ]
          },
          {
            "id": "advanced",
            "label": "Advanced",
            "fields": [
              "label",
              "delete_obsolete",
              "no_auto_update",
              "cache"
            ]
          }
        ]
      },
      {
        "path": [
          "download"
        ],
        "label": "Download translations",
        "source": [
          {
            "id": "docs",
            "kind": "manual",
            "url": "https://crowdin.github.io/crowdin-cli/commands/crowdin-download",
            "revision": "2026-10-27",
            "evidence": "crowdin download [SUBCOMMAND] [OPTIONS]\n-b, --branch=…\n-l, --language=…\n-e, --exclude-language=…\n--pseudo\n--skip-untranslated-strings\n--skip-untranslated-files\n--export-only-approved\n--keep-archive\n--dryrun\n-c, --config=…\n-i, --project-id=…\n"
          }
        ],
        "field": [
          {
            "id": "branch",
            "label": "Branch",
            "type": "string",
            "option": [
              "--branch",
              "-b"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "language",
            "label": "Languages",
            "description": "Download only these languages.",
            "type": "string",
            "option": [
              "--language",
              "-l"
            ],
            "multiple": true,
            "sources": [
              "docs"
            ]
          },
          {
            "id": "exclude_language",
            "label": "Skip languages",
            "type": "string",
            "option": [
              "--exclude-language",
              "-e"
            ],
            "multiple": true,
            "sources": [
              "docs"
            ]
          },
          {
            "id": "config",
            "label": "Config file",
            "type": "path",
            "option": [
              "--config",
              "-c"
            ],
            "path": {
              "kind": "file",
              "role": "input",
              "must_exist": true
            },
            "sources": [
              "docs"
            ]
          },
          {
            "id": "project_id",
            "label": "Project ID",
            "type": "integer",
            "option": [
              "--project-id",
              "-i"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "skip_untranslated_files",
            "label": "Skip files not fully translated",
            "type": "boolean",
            "option": [
              "--skip-untranslated-files"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "skip_untranslated_strings",
            "label": "Skip untranslated strings",
            "type": "boolean",
            "option": [
              "--skip-untranslated-strings"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "export_only_approved",
            "label": "Approved translations only",
            "type": "boolean",
            "option": [
              "--export-only-approved"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "pseudo",
            "label": "Pseudo-localized files",
            "type": "boolean",
            "option": [
              "--pseudo"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "keep_archive",
            "label": "Keep downloaded archive",
            "type": "boolean",
            "option": [
              "--keep-archive"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "dryrun",
            "label": "Dry run",
            "type": "boolean",
            "option": [
              "--dryrun"
            ],
            "sources": [
              "docs"
            ]
          }
        ],
        "task": [
          {
            "id": "all",
            "label": "Download all translations",
            "fields": [
              "branch",
              "config"
            ],
            "required": []
          },
          {
            "id": "approved",
            "label": "Approved only",
            "fields": [
              "branch",
              "language",
              "config",
              "export_only_approved",
              "skip_untranslated_files"
            ],
            "required": [],
            "set": {
              "export_only_approved": [
                true
              ]
            }
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "branch",
              "language",
              "exclude_language",
              "config",
              "project_id",
              "dryrun"
            ]
          },
          {
            "id": "advanced",
            "label": "Advanced",
            "fields": [
              "skip_untranslated_files",
              "skip_untranslated_strings",
              "export_only_approved",
              "pseudo",
              "keep_archive"
            ]
          }
        ]
      }
    ]
  }
}