contentful/contentful-cli

README

Contentful CLI

Contentful's command line interface tool. Use Contentful features straight from your CLI.

Contentful provides a content infrastructure for digital teams to power content in websites, apps, and devices. Unlike a CMS, Contentful was built to integrate with the modern software stack. It offers a central hub for structured content, powerful management and delivery APIs, and a customizable web app that enable developers and content creators to ship digital products faster.

🚀 Features

Get started with Contentful with the init command.
Manage spaces - list, create, delete,...
Export your space to a JSON file.
Import your space from a JSON file.
Execute migration scripts written in the Contentful Migration DSL
Generate migration scripts for the Contentful Migration DSL from existing spaces.
Seed your space with example data.
Manage installation of extensions in a space.
Securely login and logout with our OAuth service.
Run organization security & configuration checks (security contact, audit logging, access tokens, SSO, MFA) with contentful organization sec-check.
Find all available commands in the docs section.

☁️ Installation

Make sure you have Node LTS installed

Then using npm or yarn:

npm install -g contentful-cli
# Or
yarn global add contentful-cli

Please note that for the non standalone versions you need Node LTS to use the CLI.

✋ Usage

Use the --help parameter to display the help section for CLI tool or combined with a specific command to get the help section for that command.

contentful --help
# Or
contentful space --help

📚 Documentation

More detailed documentation for every command can be found in the docs section.

Using the CLI tool with a proxy

You can save the proxy configuration in your .contentfulrc.json via:

contentful config add --proxy user:auth@host:port

We also respect the http(s)_proxy environment variables:

https_proxy=user:auth@host:port contentful

When multiple proxy configurations exists, precedence is taken in this form:

http_proxy takes precedence over .contentfulrc.json
https_proxy takes precedence over .contentfulrc.json
https_proxy takes precedence over http_proxy

Configuring the CLI for EU usage

You can override the host configuration in your .contentfulrc.json via:

contentful config add --host api.eu.contentful.com --host-delivery cdn.eu.contentful.com

Then any subsequent command will use the EU hosts. E.g. contentful login will log you in to your EU Contentful instance.

⛑️ Troubleshooting

Unable to connect to Contentful through your Proxy? Try settings rawProxy: true in your .contentfulrc.json via:

contentful config add --raw-proxy

🛠️ Development

Install dependencies
```
npm i
```
To avoid development version colliding with your already installed Contentful CLI, change the command name in package.json
```
  "bin": {
-     "contentful": "bin/contentful.js"
+     "ctfl": "bin/contentful.js"
  }
```
Link your local version, and happy hacking 🎉
```
npm link
```

❓ Support

If you have a problem with this tool, please file an issue here on Github.

If you have other problems with Contentful not related to this library, you can contact Customer Support.

✍️ Contributing

See CONTRIBUTING.md

📜 License

MIT