Fast Heroku client.
hk is a command line client to the Heroku runtime platform, designed to be as fast as possible.
This is pre-alpha software. It will undergo substantial changes during the coming months. Don't be surprised if it is broken or if the interface is completely altered without warning.
Issues and pull requests are still welcome, but please understand that they may be rejected if it's an issue we just aren't ready to tackle this early in the project.
## version
$ time heroku version >/dev/null
real 0m1.813s
$ time hk version >/dev/null
real 0m0.016s
## list
$ time heroku apps >/dev/null
real 0m3.830s
$ time hk apps >/dev/null
real 0m0.785s
We believe this is evidence that a first-class Heroku API trumps any particular client.
A release mechanism was created for hk in the beginning: the binary updates itself. This gives us confidence in iterative development, which we value highly, because it gives us the ability to release very often knowing users will see the updates in a timely manner.
hk demonstrates the power of the Go language, runtime, systems access, and distribution story (a single, statically linked binary with no dependencies) which are all very appealing to Heroku.
Heroku loves Unix. This client should reflect that. Commands are single, unhyphenated words that map to their unix ancestors’ names and flags where applicable.
Pre-built binaries are available for Mac OS X, Linux, and BSD. Once installed, these binaries will automatically update themselves when new releases are available.
To install a pre-built binary release, run the following one-liner:
$ curl -sL -A `uname -s` https://hk.heroku.com/hk.gz | zcat >/usr/local/bin/hk && chmod +x /usr/local/bin/hk
The URL https://hk.heroku.com/hk.gz will attempt to detect your OS and CPU architecture based on the User-Agent, then redirect you to the latest release for your platform.
Currently, you need to have a Go development environment to install hk on Windows. Compiled binaries with automatic updating are available for Windows, but the installer is not ready yet.
$ go get github.com/heroku/hk
Please note that versions of hk installed from source are unsupported and should only be installed for development purposes.
You'll need a line like this in $HOME/.netrc
machine api.heroku.com login <email> password <apitoken>
$ hk help
Usage: hk [-a app] [command] [options] [arguments]
Commands:
create create an app
apps list apps
dynos list dynos
releases list releases
addons list addons
scale change dyno counts
restart restart dynos
set set config var
unset unset config var
env list config vars
run run a process in a dyno
log stream app log lines
info show app info
open open app in a web browser
rename rename an app
destroy destroy an app
sshauth authorize ssh public keys
version show hk version
Run 'hk help [command]' for details.
Additional help topics:
environ environment variables used by hk
plugins interface to plugin commands
more additional commands, less frequently used
about information about hk (e.g. copyright, license, etc.)
Plugins are executables located in HKPATH or, if HKPATH does not exist, in /usr/local/lib/hk/plugin. They are executed when hk does not know command X and an installed plugin X exists. The special case default plugin will be executed iif hk has no command or installed plugin named X.
hk will set these environment variables for a plugin:
- HEROKU_API_URL - The url containing the username, password, and host to the api endpoint.
- HKAPP - The app as determined by the git heroku remote, if available.
- HKUSER - The username from either HEROKU_API_URL or .netrc
- HKPASS - The password from either HEROKU_API_URL or .netrc
- HKHOST - The hostname for the API endpoint
hk requires Go 1.1 or later.
$ cd hk
$ godep go get
$ mate main.go
$ godep go build
$ ./hk apps
Please follow the contribution guidelines before submitting a pull request.
$ cd hk
$ vim main.go # edit Version
$ godep go build