Cells Client

CellsClient (a.k.a cec) is a dedicated tool that packages authentication and files operations into an easy-to-use binary.

Latest binaries can be downloaded from here:


As with other API consumers, you first need to authenticate the cec against the server. This is done by using the following command

./cec configure

If you are on a desktop-based computer, a browser will be opened and once the authentication is finished, the application will automatically exchange the authorization code and save the authentication token. Otherwise, an URL is displayed in the console, that you must copy and paste to a browser to be able to manually get the authorization code.

If possible, depending on the OS and the available underlying libraries, the Authentication Token is stored in the local user Keyring. Also, it is automatically refreshed using the Refresh Token.

Note: OAuth2 support starts with Cells v2.0. If you are still using an earlier version (you should not!), use cec configure client-auth command instead to use the OAuth2 Grant Type Password workflow.


As documented in the Command Line references, cec provides the following commands :

Available Commands:
  clear       Clear current configuration
  completion  Add auto-completion helper to Cells Client
  configure   Configure a connection to a running server and locally persist credentials for later use
  cp          Copy files from A to B within your remote server
  doc         Generate documentation of the Cells Client
  help        Help about any command
  idm         Identity Management commands
  ls          List files in your remote server
  mkdir       Create folder(s) in the remote server
  mv          Move and/or rename nodes on the server
  rm          Trash files or folders
  scp         Copy files from/to Cells
  storage     DataSources management commands
  update      Check for available updates and apply them
  version     Show Cells Client version information


Using the cec scp command, you can easily upload or download files to/from the Cells server. Its usage is similar to the terminal scp command, except the Cells path must be identified by a cells// prefix. Which gives for example :

Upload to server

./cec scp path/to/local/file cells//path/to/remote/file

Download from server

./cec scp cells//path/to/remote/file path/to/local/file
Back to top