grasshopper-api's and grasshopper-admin's command line interface
JavaScript Smarty CSS HTML
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Grasshopper CLI

Grasshopper's command line interface

Use Grasshopper to drastically speed up development for distributed systems. Support your clients better. For more information about the grasshopper project click here.


To build a project you will have to install the following:

  • Node.js, a platform for easily building fast, scalable network applications.

  • MongoDB, an open-source document database that Grasshopper uses for data storage.

  • Grunt, the JavaScript task runner

npm install -g grunt-cli
  • bower, a package manager for the web
npm install -g bower
  • Sass: Syntactically Awesome Style Sheets. Click here for installation instructions.

  • Sass Globbing Plugin (used to compile the admin): Sass globbing allows you to import many sass or scss files in a single import statement.

gem install sass-globbing
  • Sass CSS Importer (used to compile the admin): The Sass CSS Importer allows you to import a CSS file into Sass.
gem install sass-css-importer
  • Bundler: Bundler provides a consistent environment for Ruby projects by tracking and installing the exact gems and versions that are needed.
gem install bundler


Install this npm globally to access Grasshopper utilities anywhere on your system.

npm install -g grasshopper-cli


  • grasshopper fly - Automated Grasshopper setup. Scaffolding will be created for this project and files could be overwritten.

  • grasshopper jump - Grasshopper setup will walk you through installing Grasshopper dependencies and generate all necessary config files.

  • grasshopper upgrade - Get the latest version of Grasshopper and rebuild into your existing project. Latest NPMs will be downloaded and the admin application will be recompiled using your existing configuration files. You should read the release notes for any changes that need to be made to your config files. Release notes can be found at

  • grasshopper build - Recompile your admin application using your existing configuration files.

Click here to watch a video of installing and running a grasshopper project.

grasshopper fly


If you have a common pattern that involves Grasshopper, submit your recipe (npms, scaffolding, data). If it would be useful to a large enough audience it can be added into this project.

Submit recommendations and issues to:


Ensure that you have the latest grasshopper-cli installed. To update, run npm update -g grasshopper-cli.

Ensure that you are using ruby 2.0.0. With RVM you can do rvm install 2.0.0 && rvm use 2.0.0. Also, ensure that you have bundler installed. type gem install -g bundler.

If you get this error after running grasshopper fly twice for the same project: insertDocument :: caused by :: 11000 E11000 duplicate key error index: somedatabase.content.$_id_ dup key: { : ObjectId('53c85bb59c38840000cae250') } You need to clear out your mongo databases. Enter the mongo repl with mongo then type show dbs to list out the local mongo databases. Find the database giving you the errors ( in the above error the database name is 'somedatabase') then type use <database name>. Once you are using the proper database, type db.dropDatabase() to drop it. This will let you run grasshopper fly again without duplicate key errors.

If for some reason building the grasshopper-admin fails then you can run bundle install manually. Just enter this command starting from your new project folder.

./node_modules/grasshopper-admin$ bundle install


grasshopper-cli is released under a MIT license.