@dittowords/cli

Ditto CLI

The Ditto CLI enables developers to access the Ditto API directly from the command line. You can use the CLI to import Ditto data directly into your own codebase.

The CLI is configured to fetch text from the latest version of Ditto by default. However, all legacy features are still fully supported by passing a --legacy flag along with the legacy CLI command. See Legacy Setup for details on using the CLI with older Ditto projects and components.

Documentation

• Documentation
• Changelog

Support

• Bug Reports
• Support Chat
• What is Ditto?

Installation

npm install --save-dev @dittowords/cli

It's recommended to install the CLI as a development dependency to ensure your whole team is on the same version.

Authentication

The first time you run the CLI, you’ll be asked to provide an API key. You can generate an API key from your developer integrations settings.

See the Authentication page for more information on API keys.

Configuration

By default, the CLI operates against a ditto/ folder relative to the current working directory.

The first time you run the CLI, a ditto/ folder will be created if it doesn't already exist. The folder will also be populated with a default config.yml file, which is used to control the CLI's behavior.

The default file looks like this:

projects: []
variants: []
statuses: []
components:
  folders: []
outputs:
	- format: json
		framework: i18next