# Honcho
A process manager for your `Procfile`(s).
## Installation
Install the Honcho archive into your Elixir:
```shell
mix archive.install hex honcho_supervisor
mix archive.install hex honcho
```
Add a file `Procfile` to your project. Procfiles are defined in the following
format:
```procfile
<process name>: <command>
```
For example:
```procfile
postgres: postgres: postgres -D ./_build/data/postgres
phoenix: mix phx.server
```
## Usage
Honcho will add several mix tasks your your project, including:
* `mix honcho.info` - prints information about your process definitions
* `mix honcho.start` - will start your process
These tasks take the following optional arguments:
* `-p, --procfile` - a path to a Procfile. This defaults to a file, `Procfile`,
in the current working directory.
## Internal dependencies
On starting Honcho, it will attempt to write a bash wrapper script, which
helps to interface between Erlang and the shell. It will put its internal
helpers and config into `~/.honcho`. For this reason, in order for Honcho
to work, `$HOME` must be set, and writeable by the user under which Honcho is
started.