Smartcat CLI

Smartcat CLI (Command-Line Interface) is a cross-platform tool that allows to perform certain actions (mostly related to uploading / downloading content) from a command line or automation scripts.

Binary Downloads (latest version)

Once you have it installed, open your console and type smartcat:

cli console

Then run smartcat login to authorize in Smartcat (your workspace ID and API key will be stored in your user config folder; on Linux or macOS, the location is ~/.config/smartcat/config.json).

Per-folder configuration file

As a matter of convenience, you can create a file called .smartcat in the folder you will be runnung Smartcat CLI from. In this file you can put information about your Smartcat server, workspace, project, and API key (all fields are optional). For example:

  "Server": "",
  "Workspace": "fd104ef5-cbe7-1459-c8ac-237d99a3c614",
  "Project": "446dfcf0-e699-4c91-a7ee-40e1237a9f81",

Once you do so, this information will override your user settings.

Such a configuration file will allow you to skip specifying --project xxxxxxxx in every CLI command invocation.

General syntax

smartcat <command> [subcommand] [--option] [arg1]...[argN]


Command Details
login Authorize in Smartcat
init Initialize local project configuration file
import Import files to keys collection
export Export keys collection to files
upload Upload files to Smartcat
download Download source/target files from Smartcat
project Commands for manipulating Smartcat projects
pull Pull step of synchronization process.
push Push step of synchronization process.


Option Details
h, --help Prints help information
v, --version Prints version information


smartcat pull

smartcat pull .

smartcat pull --create-missing-files path/to/dir

smartcat pull --mode Confirmed --complete-projects path/to/dir

smartcat pull --mode 2 --complete-documents path/to/dir

smartcat smartcat import --project fd9b5946-f8a1-4c60-802f-0b2ef29df0cd --language en strings-en.json

smartcat smartcat import -l es *-es.yaml

smartcat smartcat import --collection app --auto-file-labels -l es values-es/*.xml

smartcat smartcat export --collection main --collection app -l de

smartcat smartcat export -l de,es --zip --include-default-language


Smartcat CLI supports provisioning of authentication parameters from multiple sources, where each source overrides previously defined settings, in this particular order:

Global configuration

    "activeWorkspace": "{workspace ID}",
    "workspaces": {
        "{workspace ID}": {
            "workspace": "{workspace ID}",
            "server": "",
            "apiToken": "{API token}",
          "project": "{project ID}"

Local configuration

    "server": "",
    "workspace": "{workspace ID}",
    "project": "{project ID}",
    "apiToken": "{API token}" 

Configuration file referenced from the command line (see Global CLI options)


Environment variables


Global CLI options

Following options are available for all CLI commands (if not stated otherwise in command’s description). They have maximum priority in configurations, and they will override all respective options from preceding configurations.

Main options

Other options


To use Smartcat CLI you need to provide credentials using one of possible ways (see Configuration). To simplify this process, you can use the login command.


smartcat login [option]


This command stores provided credentials in the global configuration. If you didn’t provide any credentials using environment variables or options, it will run an authentication wizard that will help you through the auth process.

Getting started


smartcat init [option]


This command will guide you step-by-step through the process of authorization (if not configured) and project creation (or selection of an existing one). In the end it will create a local configuration file.