Install your tools

The six things worth installing once.

If you used Claude Desktop or the Codex app to get your site live on the earlier pages, you didn't need any of this. But to unlock the real power — an agent that runs commands, installs packages, and carries a task through to a finished result on its own — a handful of tools need to live on your machine first. Ten minutes, once, then you never think about it again. One script below installs all six at once — or walk through them one at a time to see what each one does.

One script installs
all six at once.

Pick your OS. Each script checks what you already have and only installs what's missing — safe to run even if some of these are already on your machine, and safe to run again any time.

prompt
Install my development tools for me: Homebrew, Git, the GitHub CLI, Node.js, VS Code, and both Claude Code and Codex CLI. Run `curl -fsSL https://gitlab.com/eim_opensource/gravity-python/-/raw/master/scripts/install_tools_macos.sh | bash` — it skips anything already installed, so it's safe to run even if I have some of these already. If it asks for my password or anything else needs my input, ask me. Once it finishes, run `gh auth login` and tell me what to do next to finish signing in to the GitHub CLI.

Prefer to see what each tool actually does and install them one at a time? That's exactly what the rest of this page walks through, below.

01

Homebrew — the Mac package installer

Everything else on this page installs through this one command. On a Mac, it's the very first thing to run.

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

Not on a Mac? Skip this step — every command below links to its own installer instead. Windows: winget install or download from each tool's site. Linux: your package manager (apt, dnf, pacman) already does this job.

02

A text editor

Somewhere to actually look at the files your AI agent is changing. Visual Studio Code is the easiest default — it doesn't have to be VS Code.

terminal
brew install --cask visual-studio-code

Already have a favorite? Sublime Text, Cursor, Zed — any of them work fine. The AI agent edits files directly either way; the editor is just so you can see what changed.

03

Node.js — npm and npx come free

A lot of what you'll install next, including Claude Code and Codex, is distributed through npm, Node's package manager. One install gets you Node, npm, and npx together.

terminal
brew install node
Check it worked
node --versionNode itself
npm --versionNode's package manager
npx --versionruns a package without installing it first
04

Git

Version control — the thing that saves your history so you can undo a bad change or see exactly what an AI agent did. The next lesson covers it in full; this is just getting it installed.

terminal
brew install git

Mac sometimes already has an older Git bundled with the Xcode Command Line Tools — if you're ever asked to install those too, say yes. Homebrew's copy just stays newer.

05

The GitHub CLI — gh

Create and push to a GitHub repository from the terminal, no browser required. An AI agent can use it directly too — it's what powers make push-repo on a Gravity site.

terminal
brew install gh
gh auth login

gh auth login opens a browser to connect it to your GitHub account — do that once now, and both the terminal and any AI agent driving it can create repos and push code without asking you to log in again.

06

Your AI coding agent

a little more advanced worth doing now, not later. This is the terminal version of the same agent from the Get Started page — instead of a desktop app, it lives right in your terminal, can run commands on its own, and is the tool of choice for serious, multi-step building.

terminal
npm install -g @anthropic-ai/claude-code
claude

The first run of either one asks you to sign in — that's normal. Do it now, and by the time you reach Get Started or Building with AI, it's one less thing standing between you and a live site.

One command, six checks.

Paste this in any time — it just prints each tool's version, or nothing if it's missing.

terminal
brew --version; code --version; node --version; npm --version; git --version; gh --version; claude --version || codex --version

Everything's installed. On to Git.