contentful-cli

Contentful CLI

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

Contentful is a content management platform for web applications, mobile apps and connected devices. It allows you to create, edit & manage content in the cloud and publish it anywhere via a powerful API. Contentful offers tools for managing editorial teams and enabling cooperation between organizations.

:rocket: Features

• Securely login and logout with our OAuth service.
• Manage spaces - List, create, ...
• Seed your space with example data
• Run a guide which introduces you to the Contentful basics.
• Find all available commands in the docs section.
• More to come soon! 🚀

:cloud: Installation

Using npm:

npm install -g contentful-cli

Using yarn:

yarn global add contentful-cli

Please note that for the non standalone versions you need node => v6 to use the CLI.

:hand: 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

Enable bash-completion

To enable bash-completion for available commands use the completion command and concat the generated script to your .bashrc or .bash_profile.

contentful completion

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:

1. http_proxy takes precedence over .contentfulrc.json
2. https_proxy takes precedence over .contentfulrc.json
3. https_proxy takes precedence over http_proxy

:books: Documentation

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

:hammer_and_wrench: Development

After installing the dependencies, there is a trick to get your version of the CLI tool available globally on your system:

npm link

This may collide with your already globally installed Contentful CLI. Make sure to remove that one first.

:robot: Testing

End-To-End Functional Tests

:warning: Environment variables should be set:

CMA_TOKEN = <cma_auth_token>
ORG_ID = <organization_id>

npm:

npm run test:e2e

or using AVA:

$ ava test/integration/** --verbose --serial

:warning: Since the e2e tests are running in serial mode currently, you should be logged out or rm ~/.contentfulrc.json

:question: 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.

:writing_hand: Contributing

See CONTRIBUTING.md

:scroll: License

MIT