# Setup

Nothing to install — this is a guide. Read README.md top to bottom.

The README itself walks you through installing everything it covers (Homebrew/winget, git, node, python3, ripgrep, Claude Code, SSH keys) with copy-paste commands and "check it worked" steps built in. There is no separate install process for this repo — you just need to be able to read the file and open a terminal.

## Get the guide onto your machine

You only need a terminal (Step 1 in the README explains how to open one) and `git`. If you don't have `git` yet, that's fine — just download the file directly instead (see option B).

### Option A: clone with git (if you already have git)

Mac / Linux / Windows (same command):
```
git clone <this-repo-url>
cd terminal-setup
```

### Option B: no git yet

Open the repo in KeyzHub and use the "Download" / raw-file option to save `README.md` to your computer, then open it in any text editor or Markdown viewer.

## Requirement checklist

| Requirement | Why | Have it already? |
|---|---|---|
| A computer running macOS or Windows 10/11 | The guide has a parallel track for each | Yes, if you're reading this on one |
| Ability to open a terminal app | Every step runs a command | Yes — Step 1 of the README shows you how |
| Internet connection | Installer scripts download from the internet | Check your connection |
| Docker | NOT needed | N/A |
| A paid account or API key | NOT needed | N/A |
| A GPU | NOT needed | N/A |

## Run it

Open `README.md` and start at "Step 1: Open your terminal." Follow it in order — later steps assume earlier ones are done.

## Troubleshooting

- **"command not found" after installing something**: close and reopen your terminal window. This reloads your `PATH` so it can find newly installed programs — the README calls this out at each install step.
- **Can't find README.md after cloning**: confirm you're in the right folder with `pwd` (Mac) or run `dir`/`ls` to list files; the clone creates a `terminal-setup` folder containing it.
- **Not sure which OS section to follow**: the README's Mac and Windows instructions are in separate subsections under each step — read only the subsection matching your computer, skip the other.