Launch Sublime Text from the command line on OSX
---

Sublime Text includes a command line tool, `subl`, to work with files on the command line. This can be used to open files and projects in Sublime Text, as well working as an EDITOR for unix tools, such as git and subversion.

Requirements
---
- Sublime text 2 or 3 installed in your system within `Applications` folder

Setup
---
In order to launch sublime from command line you only need to create a symlink `/usr/local/bin/subl` point to sublime app, to do so run the following in the command line.

### Sublime Text 2


	ln -sv "/Applications/Sublime Text 2.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl

### Sublime Text 3


	ln -sv "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl


### Test it out

open a new file from the command line:

	subl test.rb

*it should open new file `test.rb` in Sublime Text*

open a project folder 

	subl dir/project
	
to launch Sublime app

	subl
	
for more detailed options use the help:
	
	subl -h

### Config git to use Sublime Text as its editor globally
run the command as follows:

	git config --global core.editor "subl -w"

to config git to use Sublime Text as editor only for a particular repository/project run the same command above without `--global` option.

----

### NOTE: In order to execute Sublime from the Command Line you must:

have created a directory where you actually place binaries `/usr/local/bin` if not make it before creating a `symlink`:


	mkdir -p /usr/local/bin

have `/usr/local/bin` in your PATH environment variable, if not add by running the following command:

	echo 'export PATH=/usr/local/bin:$PATH' >> ~/.bash_profile

then reload the shell:

	source ~/.bash_profile

test again.

Further info read from [sublime docs](https://www.sublimetext.com/docs/2/osx_command_line.html)