CocoonJS command line tool
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Remove CocoonJS from the logs Jun 1, 2015
LICENSE Public release Jun 25, 2014 Update May 4, 2017 preparing livereload for release Sep 16, 2014
test.js Added first changes to the cli for supporting live reload Sep 1, 2014

IMPORTANT: This project has been discontinued. Please go to the new Cocoon Cloud at

The new Cocoon cloud is completely Cordova based and has enhanced features that include: the most up to date Webview+, new Cocoon plugins, a better Developer App, support for any Cordova plugin and a revamped UI.

CocoonJS Command Line tools

The CocoonJS command line tools let you build Cordova-based applications that benefit of Ludei's services (like cloud project management) right in you terminal.

The CocoonJS CLI also provide access to the Webview+ execution environment. The CocoonJS CLI handles the installation and usage of the webview+ plugin directly in your computer.

Ludei's WebView+ is a Chromium based solution for Android 4.0+ and the WKWebView for iOS 8.0+.


Install cordova-cli 3.2 or higher (Cordova 3.5 is recommended). Please refer to Cordova prerequisites to set up your environment.

After installing Cordova in your computer, execute the following command to install the CocoonJS CLI tools:

$ npm install -g cocoonjs

How to use

Use any valid cordova command with the CocoonJS-CLI to manage your project, eg:

$ cocoonjs create MyProject com.ludei.test LudeiTest
$ cd MyProject
$ cocoonjs platform add android
$ cocoonjs plugin add
$ cocoonjs run

Regarding cordova versions

The CocoonJS command line tool automatically detects the Cordova version installed in your computer. However, if you have multiple versions installed locally, you can explicitly point to a specific path using the --cordova-path argument to force that cordova binary to execute, eg:

$ cocoonjs platform add android --cordova-path=/Users/Cocoon/cordova/cordova-3.5.0-0.2.4/

Using the --cordova-path, the CocoonJS-CLI will find the cordova binary inside cordova-3.5.0-0.2.4/bin/cordova and will use it to spawn all the cordova-based commands. You can use any cordova 3.x version.


CocoonJS command line has a verbose mode. If you get any error, launch the command with -d flag. And you'll get more info. For instance:

cocoonjs plugin add -d

And post the info in the console attached to your issue.



Copyright 2014 Ludei, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

About the author

Ludei is a San Francisco based company, creators of CocoonJS. Ludei aims to empower HTML5 industry with a set of tools that eases the adoption of HTML5 as the target platform for every mobile development.