UPDATE for May 2012: If you cloned Cloud9 prior to May 2012, we have upgraded the architecture of the codebase. This makes it simpler to maintain Cloud9, but it affects the way you pull updates and hack on subcomponents. See the Installation and Usage section below to grok the changes.
Cloud9 is an open source IDE started by ajax.org, built on top of Node.JS. This version runs locally; for the hosted service offering multiple workspaces, app deployment and other features, see c9.io.
This Integrated Development Environment balances the power of traditional desktop IDEs with the simplicity and elegance of editors like TextMate and Sublime. Best of all, the Cloud9 interface runs entirely in the browser.
- High performance ACE text editor with bundled syntax highlighting support for JS, HTML, CSS and mixed modes.
- Integrated debugger for Node.JS applications with views of the call stack, variables, live code execution and live inspector
- Local filesystem is exposed through WebDAV to the IDE, which makes it possible to connect to remote workspaces as well
- Highly extensible through both client-side and server-side plugins
- Sophisticated process management on the server with evented messaging
We support the newer versions of Chrome, Firefox and Safari.
Installation and Usage
>= 0.6.15& NPM
npm install -g sm
sm clone --dev https://github.com/ajaxorg/cloud9/tree/master cloud9
This creates a
cloud9 directory in your current directory, just
cd into it
bin/cloud9.sh to start:
cd cloud9 bin/cloud9.sh
Optionally, you may specify the directory you'd like to edit:
bin/cloud9.sh -w ~/git/myproject
Cloud9 will be started as a web server on port
-p 3131, you can access it by
pointing your browser to: http://localhost:3131
To update to the latest version (if this doesn't work, just make a fresh clone):
git pull sm update
To work on a subcomponent that is copied into node_modules, you can use
For instance, to work on ACE, run the following from the checkout root:
sm edit ace
This is somewhat equivalent to
npm link but instead of linking to a system wide
shared package it clones the source into the node_modules/ directory.
The idea is to only "edit" when you need to make changes and when done issue
"sm save " (not yet implemented) which will pull up sourcetree to commit,
push code and switch package back to read mode (frozen). The status page
shows problematic and improvement oriented action steps to improve the state of the program. These relate to git status and dependency changes that need to be made to bring the dependencies up to date and ready to publish which leads to deployment.
The line on the status page will have a (W) if it is setup for editing.
To launch Sourcetree for all dirty/ahead repositories in the dependency
tree use (need to have Sourcetree command-line tools installed (
The sourcemint package manager works alongside NPM so to link in a (system-wide shared) NPM package use:
rm -R node_modules/architect npm link architect
sm always works on your program sub-tree other than pulling things in
from the cache.
Open Source Projects Used
The Cloud9 IDE couldn't be this cool if it weren't for the wildly productive Node.JS community producing so many high quality software. Main projects that we use as building blocks:
- async.js by fjakobs
- jsDAV by mikedeboer
- connect by senchalabs
- socket.io by LearnBoost
- ace by fjakobs
- apf by ajax.org
- and of course Node.JS!
Thanks to all developers and contributors of these projects!
The GPL version 3, read it at http://www.gnu.org/licenses/gpl.txt
Cloud9 wouldn't be where it is now without contributions. Feel free to fork and improve/enhance Cloud9 in any way your want. If you feel that the Cloud9 community will benefit from your changes, please open a pull request. To protect the interests of the Cloud9 contributors and users we require contributors to sign a Contributors License Agreement (CLA) before we pull the changes into the main repository. Our CLA is the simplest of agreements, requiring that the contributions you make to an ajax.org project are only those you're allowed to make. This helps us significantly reduce future legal risk for everyone involved. It is easy, helps everyone, takes ten minutes, and only needs to be completed once. There are two versions of the agreement:
- The Individual CLA: use this version if you're working on an ajax.org project in your spare time, or can clearly claim ownership of copyright in what you'll be submitting.
- The Corporate CLA: have your corporate lawyer review and submit this if your company is going to be contributing to ajax.org projects
If you want to contribute to an ajax.org project please print the CLA and fill it out and sign it. Then either send it by snail mail or fax us or send it back scanned (or as a photo) by email.
Fax: +31 (0) 206388953
Address: Ajax.org B.V. Keizersgracht 241 1016 EA, Amsterdam the Netherlands