We're happy to announce the release of the AppHarbor CLI. This utility gives you complete control over your applications using simple commands. After logging in, you can create new applications, retrieve build history, and manage configuration variables and host names.

Get started by downloading and installing the utility. The installer will add it to your system path.

Download AppHarbor CLI

In the first version, the following commands are supported. The commands at the end in parentheses are shortcuts that you can use directly. This will be demonstrated in the examples below.

app                         #  List your applications
app create [name]           #  Create an application ("create")
app delete                  #  Delete application
app info                    #  Get application details
app link [slug]             #  Link directory to an application ("link")
app unlink                  #  Unlink application from directory ("unlink")
build                       #  List latest builds
config add [key=value]      #  Add configuration variable to application
config                      #  List all configuration variables
config remove [key1 key2..] #  Remove configuration variable
help                        #  Display help summary
hostname add [hostname]     #  Add a hostname
hostname                    #  List all associated hostnames
hostname remove [hostname]  #  Remove hostname from application
user login                  #  Login to AppHarbor ("login")
user logout                 #  Logout of AppHarbor ("logout")
user                        #  Show currently logged in user

Example: Create a new application

Begin by opening a command prompt and logging with your AppHarbor user information.

c:\dev>appharbor user login
Username: js
Password: **********************
Successfully logged in as js

Create a new directory for your app and use the create shortcut to create the app with AppHarbor and initialize the directory with the Git settings your application needs to push and deploy your code to AppHarbor's servers.

c:\dev>mkdir MyFancyApp
c:\dev>cd MyFancyApp

c:\dev\MyFancyApp>appharbor create MyFancyApp
Created application "myfancyapp" | URL: https://myfancyapp.apphb.com

Git repository is not initialized in this folder. 
Do you want to initialize it (type "y")? y

Git repository was initialized with default .gitignore file.
Added "appharbor" as a remote repository. 
Push to AppHarbor with git push appharbor master.

Example: Link an existing application

If you already have an app in a folder configured for use with AppHarbor, you can link it to the existing application so that you can use the CLI commands to manage configuration variables and hostnames.

Navigate to the folder that contains your application and use the link command to tie it to the specified AppHarbor application slug. If the appharbor remote doesn't exist, it will be created for you.

c:\dev>mkdir MyExistingApp

c:\dev>cd MyExistingApp

c:\dev\MyExistingApp>appharbor link myexistingapp
Added "appharbor" as a remote repository. 
Push to AppHarbor with git push appharbor master.

More To Come

In this first version we wanted to make sure we supported the core interactions developers have with AppHarbor on a daily basis. We'll be adding more commands and features in the future so keep an eye on the GitHub project for changes. And since it's open source, if there's a command you'd like to add, feel free to fork the project and send a pull request.

Have questions or need help with AppHarbor CLI? We're standing by.