jnsgruk / ght

Perform actions in Greenhouse from you terminal

Greenhouse Tooling

Greenhouse Tooling (ght) is a command line tool that will help you automate repetitive tasks on Greenhouse.

Since it only supports Ubuntu One login, this project can only be used by Canonical employees.

Install ght

On Linux it is available as a snap:

snap install ght

Usage

Replicate job posts

You can use ght to replicate job posts from the Canonical board in regions: americas, emea, apac, canada and latam.

ght replicate <JOB_POST_ID> --regions=europe,americas

If you want to use the interactive mode, you can run the command with the flag -i. Let yourself be guided by the tool:

ght replicate -i

Repost a specific job post

You can use ght to repost a specific job post - the old job post is deleted afterwards.

ght repost <JOB_POST_ID>

If you also want to use the interactive mode to repost a specific job post, you can run the command with the flags -i. Let yourself be guided by the tool:

ght repost -i

Assign graders to written interviews

You can use ght to assign random graders to written interviews. You should have a ght-graders.yml file in your home directory with the format:

Job name 1:
  Written Interview:
    - name: Grader One
      active: true
    - name: Grader Two
      active: false
    - name: Grader Three
      active: true
Job name 2:
  Written Interview:
    - name: Grader Four
      active: true

Running ght assign -i will guide you through the process of selecting the jobs. For the selected jobs, it will go through the written interviews needing graders (applications where only the hiring lead is assigned, since this is the default behaviour in Greenhouse) and will assign two random names from the list provided.

• name: should exactly match the name used when selecting the person is the scorecard assignment modal in Greenhouse
• active: only people with active set to true will be randomly selected. This allows you to define people that are on holiday or unavailable for a time.

Authentication

The CLI will manage authentication. To avoid entering credentials every time the command runs, the authorization cookie created by Greenhouse and SSO will be stored in the file: ~/.config/ght/.canonical-greenhouse.json.

Every time the authentication requires a refresh, you will be requested to authenticate.

Customising GHT

You can override some of the default values by providing your own config file. This has to be a yaml file containing the following (optional) values.

# Url to your greenhouse instance
# default: https://canonical.greenhouse.io
greenhouseUrl: https://example.greenhouse.io/
# Job board that contains the original job post to be copied
# default: Canonical
copyFromBoard: Jobs
# Job board where new posts will be located
# default: Canonical - Jobs
copyToBoard: Jobs
# Job boards that won't be considered when deleting job posts
# with the `reset` command
# default: [Canonical, Internal]
protectedBoards: [Internal]
# Regions to publish the job post
regions:
    emea:
        - "Home based - Africa, Accra"
    americas:
        - "Home based - Canada, Calgary"
        - "Home based - Canada, Montreal"

To do do, supply the file path with --config (or -c), i.e:

ght replicate -i --config ~/ght-config.yaml

Happy hiring!