<h1>
<a href="http://treeline.io" title="Visit the Treeline website" rel='nofollow' onclick='return false;'><img alt="A line of geometric trees" title="Treeline.io logo" src="http://i.imgur.com/lyxMr9Z.png" width="100" /></a>
treeline
</h1>
### [Website](http://treeline.io) [Getting Started](http://node-machine.org) [Docs](https://treeline.io/documentation) [Newsgroup](https://groups.google.com/forum/?hl=en#!forum/node-machine)
Command-line utility for working with Sails apps and machines in Treeline.
## Installation [](http://badge.fury.io/js/treeline)
```sh
$ npm install -g treeline
```
This will allow you to use `treeline` on the command-line, as well as `tl`, its alias.
## Usage [](https://gitter.im/node-machine/general?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
You should check out [https://treeline.io/documentation](https://treeline.io/documentation) for an in-depth tutorial, but here are a few highlights:
```bash
# locally preview the app in the current directory
$ treeline lift
# associate the current directory with an app on Treeline.io
$ treeline link
# authenticate this computer using your Treeline credentials
$ treeline login
```
<!--
```bash
# open generated manpage on node-machine.org in your browser of choice
tl browse
# run a machine
# (theres an interactive prompt- you'll get to choose from a list, then be prompted to provide values for required inputs)
# (supports json entry and validation, re-running using command-line flags, and protects inputs marked as "protected" so they don't show up in your bash history)
mp exec
# clean everything up: (re)scaffold JSON test files, (re)generate readme using latest metadata, make sure repo url is in package.json, etc.
mp scrub
# list machines (useful for remembering wtf you're doing)
mp ls
# add new machine w/ identity="do-some-stuff" and start interactive prompt to get the rest of the necessary info
mp add do-some-stuff
# copy machine (useful for quickly creating similar machines)
mp cp foo bar
# rename machine (useful for fixing misspellings)
mp mv initiate-denk-party initiate-dance-party
```
-->
## About
Treeline is a project by the [Sails core team](http://sailsjs.com/about) to make Node.js more approachable. Think about it like [blueprints](https://www.youtube.com/watch?v=GK-tFvpIR7c) for everything- web servers, APIs, background processes, devops scripts. To learn more about the project, please visit [our website](http://treeline.io).
The underlying technology at work is mostly composed of a number of open-source modules which are a collaborative effort from the Sails.js and node-machine projects.
<h4>
<a href="http://node-machine.org" rel='nofollow' onclick='return false;'><img width="50" src="http://node-machine.org/images/machine-anthropomorph-for-white-bg.png"/></a>
<span>+</span>
<a href="http://sailsjs.com" rel='nofollow' onclick='return false;'><img width="50" src="https://www.rosehosting.com/blog/wp-content/uploads/2014/03/sails.png"/></a>
</h4>
If you are interested in contributing to any of these modules, please follow the directions outlined in the relevant repo(s). Feature requests, bug reports, patches, tests, documentation, or even proof-reads are all welcome :)
## The Treeline.io Beta
So... Treeline is not publicly available yet. We're working very hard to get ready for GA, especially on docs and examples. For the latest release schedule, check out our website or @treeline on Twitter.
If you're interested in beta testing, please visit our website and sign up for early access.
> _If you're a Sails.js contributor still waiting on your beta code, hit me up on Twitter ([@mikermcneil](http://twitter.com/mikermcneil)) and I'll set up your account personally._
## Team
This module is developed and actively maintained with the help of these [contributors](https://github.com/treeline-io/cli/graphs/contributors):
[](http://michaelmcneil.com) | [](http://www.pigandcow.com/) | [](http://particlebanana.com) | [](http://twitter.com/fancydoilies) | [](http://irlnathan.github.io/sailscasts/)
:---:|:---:|:---:|:---:|:---:
[Mike McNeil](http://mikermcneil.com) | [Scott Gress](https://github.com/sgress454) | [Cody Stoltman](https://github.com/particlebanana) | [Rachael Shaw](https://github.com/rachaelshaw) | [Irl Nathan](https://github.com/irlnathan)
## License
The Treeline CLI tool is available under the MIT license.
© 2013-2014 Mike McNeil
© 2015-2017 [The Sails Company](http://sailsjs.com/about)