# Set up your machine

By the end of this guide, you'll have the command-line tools you need to work with the Golden Path installed on your machine.

It covers 8 short pages, one per tool. Each page is self-contained, so you can install them in any order or skip the ones you already have.

## Tools

The [Homebrew](https://brew.sh/){:target="_blank"} package manager is the recommended tool for installing software. Besides macOS, Homebrew also works on [Linux and Windows Subsystem for Linux (WSL)](https://docs.brew.sh/Homebrew-on-Linux){:target="_blank"}.

```sh
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

## Required tools

| Guide                                                  | External source                                                                                                                                 |
| ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| [`yq` with Homebrew](yq.md)                            | [`yq` on GitHub](https://github.com/mikefarah/yq/#install){:target="_blank"}                                                                    |
| [`gh` with Homebrew](gh.md)                            | [`gh` on GitHub](https://github.com/cli/cli){:target="_blank"}                                                                                  |
| [`jq` with Homebrew](jq.md)                            | [`jq` on GitHub](https://jqlang.github.io/jq/download/){:target="_blank"}                                                                       |
| [`fzf` with Homebrew](fzf.md)                          | [`fzf` on GitHub](https://github.com/junegunn/fzf#installation){:target="_blank"}                                                               |
| [Terraform (and TFSwitch) with Homebrew](terraform.md) | [HashiCorp's guide for installing Terraform](https://developer.hashicorp.com/terraform/tutorials/aws-get-started/install-cli){:target="_blank"} |
| [AWS CLI with Homebrew](aws-cli.md)                    | [AWS' guide for installing AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html){:target="_blank"}            |
| [Boilerplate](boilerplate.md)                          | [Gruntwork's guide for installing Boilerplate](https://github.com/gruntwork-io/boilerplate?tab=readme-ov-file#install){:target="_blank"}        |
| [`ok`](ok.md)                                          | -                                                                                                                                               |