AI Development Environment Bootstrap

A friendly script that helps beginners set up their Mac for AI-assisted coding.

What It Installs

Tool	Description
Homebrew	Package manager for macOS
Git	Version control
NVM	Node version manager
Node.js LTS	JavaScript runtime
GitHub CLI	GitHub from the command line
Ghostty	Modern GPU-accelerated terminal
AI Tools	Amp, Codex, OpenCode, Claude Code, Kilo Code

Quick Start

Visit abregainc.github.io/ai-bootstrap for the landing page.

For the step-by-step guide series (terminal path vs UI app path):

abregainc.github.io/ai-bootstrap/guides/

If you prefer not to use the terminal, use the UI Path page:

abregainc.github.io/ai-bootstrap/guides/ui/

Or run directly:

curl -fsSL https://abregainc.github.io/ai-bootstrap/bootstrap.sh | bash

To clone and run locally:

git clone https://github.com/AbregaInc/ai-bootstrap.git
cd ai-bootstrap
chmod +x bootstrap.sh
./bootstrap.sh

What to Expect

The script will:

1. ✅ Explain each step in plain English
2. ✅ Ask permission before installing anything
3. ✅ Skip tools that are already installed
4. ✅ Help you authenticate with GitHub
5. ✅ Let you choose which AI tools to install

Requirements

• macOS (Apple Silicon or Intel)
• Admin password for your Mac
• Internet connection

After Installation

You'll need API keys for the AI coding tools:

• Codex CLI: Get an OpenAI API key at https://platform.openai.com/api-keys
• Claude Code: Get an Anthropic API key at https://console.anthropic.com/

Troubleshooting

"command not found" after installation

Open a new terminal window. This loads the updated PATH.

Homebrew installation fails

Make sure you have Xcode Command Line Tools:

xcode-select --install

GitHub authentication issues

Run authentication manually:

gh auth login

Testing

Automated (headless)

Fully automated test in a Tart macOS VM - no clicking required:

./test/run-test-auto.sh

Requires Apple Silicon Mac. Installs sshpass if needed.

Interactive

Manual testing with VM GUI:

./test/run-test.sh

License

MIT