Installation Kata CLI

Kata Command Line Interface (Kata CLI) is a tool for creating bots with Kata Markup Language (Kata ML) and helps managing the bots with command line/shell of various operating systems. For more information, check our website (


To install Kata-CLI in global mode, run this command in your terminal:

npm install -g kata-cli

This is the preferred method to install Kata-CLI, as it will always install the most recent stable release.

Upgrading to 2.0

We upgraded Kata-CLI version into 2.0 along with our Platform to 3.0. There are a number of small backwards incompatible changes with version 2.0. See the full descriptions here. Make sure to update Kata-CLI to our latest stable version before doing some fun with your Bot.

// check kata-cli current version
➜  kata --version
   Kata CLI version 1.2.3
// upgrade kata-cli to the latest version
➜  npm i -g kata-cli

or to be exact, you can add @version-number

npm i -g kata-cli@2.x.x

Then, check kata-cli upgraded version.

➜  kata --version
   Kata CLI version 2.0.4

In Kata-CLI 2.0, we introduce Project Environment on the top of the Bots, NLU and CMS. Hence, before running Kata-CLI main command, such as: kata init,kata push, kata console, etc., user have to define the Project that they are working on using this command.

➜  kata select-project

Contributing to the Documentation

Is something missing/incorrect? Please let us know by contacting If you know how to fix it straight away, don’t hesitate to create a pull request on this documentation’s GitHub repository.