# AI Terminal Kickstart β Set Up Claude Code, Codex, ChatGPT CLI & GitHub Copilot On A Fresh Box
Step-by-step install for Claude Code, OpenAI Codex, ChatGPT terminal, GitHub Copilot CLI and Netlify CLI on Windows (PowerShell) and Linux (Bash). Copy-paste commands for every dependency, auth step, and first session.
Author: J.A. Watte
Published: April 20, 2026
Source: https://jwatte.com/blog/blog-ai-terminal-kickstart/
---
Getting a fresh machine set up for AI coding, Claude Code, OpenAI Codex, ChatGPT in the terminal, GitHub Copilot CLI, plus Netlify CLI for deploys, is usually a scavenger hunt across five docs pages, three package managers, and one inevitable PATH issue. This is the condensed walk-through. Every command is copy-pasteable, paired for **Windows (PowerShell)** and **Linux (Bash)** so whichever box you're on, you're one paste away from a working environment.
The order matters: runtimes first, then CLIs that depend on them, then auth. If you skip a step you'll hit it later.
> π§ **Already got the CLI working?** The follow-on picks up where this post leaves off: **[You've Got The Claude Code CLI Installed β Now What?](/blog/ai-terminal-workflow-after-install/)** covers plan mode, CLAUDE.md as a living contract, the Q1 2026 slash commands (`/btw` `/fork` `/rewind` `/compact` `/loop` `/schedule` `/simplify` `/batch` `/powerup` `/insights` `/debug` `/claude-api`), Skills vs Rules vs Memory, Auto Mode boundaries, and a Day 0 β Day 7 ramp plan. Bookmark it for when you're through this install.
---
**π The full workflow series after this install primer** (this post is #1):
**Claude Code track:**
1. This post β install the CLIs.
2. **[CLI installed β now what?](/blog/ai-terminal-workflow-after-install/)** β plan mode, CLAUDE.md, the slash commands that matter, Day 0 β Day 7 ramp.
3. **[Skills, Rules, Memory deep-dive](/blog/claude-code-skills-rules-memory-deep-dive/)** β the four-layer hierarchy that keeps CLAUDE.md from bloating.
4. **[Adversarial subagents + worktrees](/blog/claude-code-adversarial-subagents-worktrees/)** β parallel Claudes with deliberately different review roles.
5. **[Hooks implementation guide](/blog/claude-code-hooks-approval-fatigue/)** β stop approving the same prompt 40 times a day.
6. **[/loop vs /schedule](/blog/claude-code-loop-vs-schedule/)** β in-session polling vs cron-style automation.
7. **[CLAUDE.md anti-patterns](/blog/claude-md-anti-patterns/)** β the 8 patterns that rot the file over time.
8. **[Auto Mode case studies](/blog/claude-code-auto-mode-case-studies/)** β four real classifier calls, wins and losses.
9. **[/insights-driven iteration](/blog/claude-code-insights-iteration-workflow/)** β the 30-minute Monday ritual.
10. **[Remote Control + Channels](/blog/claude-code-remote-control-channels/)** β running your session from iMessage, Telegram, Discord.
11. **[Multi-model routing](/blog/claude-code-multi-model-routing/)** β when to break out of Claude-only.
12. **[Agent skill marketplace](/blog/claude-code-agent-skill-marketplace/)** β Skills 2.0 ecosystem, evaluating before installing, publishing your own.
**Codex track (for readers using OpenAI's CLI or running both):**
1. **[Codex CLI after install](/blog/codex-cli-after-install/)** β OpenAI-specific first-week habits, model selection, cost mechanics.
2. **[Codex vs Claude Code β task-level comparison](/blog/codex-vs-claude-code-comparison/)** β where each one actually wins.
3. **[Prompt style β GPT vs Claude](/blog/prompt-style-gpt-vs-claude/)** β the four stylistic differences that matter in practice.
4. **[ChatGPT CLI / Codex CLI / GitHub Copilot CLI β positioning](/blog/chatgpt-codex-copilot-cli-positioning/)** β three products that sound alike and do different jobs.
5. **[Two-CLI workflow](/blog/two-cli-workflow-codex-claude-code/)** β split-screen routine for running Codex + Claude Code in parallel.
**Open-weights + Google-stack track:**
1. **[Qwen self-hosted at home](/blog/qwen-open-weights-self-hosted-at-home/)** β when open-weights beats proprietary, hardware tiers, Ollama setup, quantization trade-offs.
2. **[Gemini CLI β when to use](/blog/gemini-cli-when-to-use/)** β long context, multimodal, Google-ecosystem fit, and where Gemini falls short against Claude Code.
3. **[Gemma β where it fits next to Qwen](/blog/gemma-open-weights-where-it-fits/)** β Google's open-weights counterpart; when to pick it over Qwen and vice versa.
---
## What you're installing
| Layer | Tools |
|---|---|
| Runtimes | Node.js LTS, Python 3.12, Git |
| Package managers | Chocolatey (Windows), apt/dnf (Linux), npm, pip |
| AI terminals | **Claude Code** (Anthropic), **Codex** / **ChatGPT terminal** (OpenAI), **GitHub Copilot CLI** |
| Deploy | **Netlify CLI** |
| Utilities | ripgrep, jq, fd, ImageMagick |
The AI terminals differ in what they're good at. Claude Code edits files and runs commands end-to-end inside a repo, best for real work. Codex / ChatGPT CLI is better for quick questions and one-shot generations. Copilot CLI suggests shell commands from natural language.
## One-shot install: full scripts you can save and run
If you'd rather run an automated installer than paste each of the Step 1-7 blocks individually, the two scripts below do every install + auth wiring in one go. Save the matching file for your OS, run it once, and you end up with Claude Code, OpenAI Codex, ChatGPT CLI, GitHub Copilot CLI, Netlify CLI, and every dependency on your PATH.
**Both are also downloadable:**
- Bash (Linux / macOS / WSL): [`/downloads/start-ai-terminal-kickstart.sh`](/downloads/start-ai-terminal-kickstart.sh)
- PowerShell (Windows 10/11 / Server 2022): [`/downloads/Start-AITerminalKickstart.ps1`](/downloads/Start-AITerminalKickstart.ps1)
### Save and run β Linux / macOS / WSL (Bash)
1. Copy the Bash script (expand the *"Full Bash script"* block below and click inside the code block, then `Ctrl+A` β `Ctrl+C`).
2. Save it as `start-ai-terminal-kickstart.sh` in your home directory:
```bash
nano ~/start-ai-terminal-kickstart.sh
# paste, then Ctrl+O Enter Ctrl+X
```
Or, if you downloaded the file from the link above, move it to `~/` and skip to step 3.
3. Make it executable and run it:
```bash
chmod +x ~/start-ai-terminal-kickstart.sh
sudo ~/start-ai-terminal-kickstart.sh
# or, unattended (install everything, no prompts):
sudo ~/start-ai-terminal-kickstart.sh --auto
```
4. Close the terminal and open a fresh one so PATH updates take effect. Then `claude`, `codex`, `chatgpt`, `gh copilot`, and `netlify` are all on your PATH.
### Save and run β Windows (PowerShell)
1. Copy the PowerShell script (expand the *"Full PowerShell script"* block below, click inside the code block, `Ctrl+A` β `Ctrl+C`).
2. Save as `Start-AITerminalKickstart.ps1` in your Downloads folder (or wherever you prefer).
Open Notepad, paste, `File β Save Asβ¦`, set *"Save as type"* to **All Files**, name the file `Start-AITerminalKickstart.ps1`, and save with encoding **UTF-8**. Or if you downloaded the file from the link above, skip to step 3.
3. Open **PowerShell as Administrator** (Start menu β type `PowerShell` β right-click β *Run as administrator*), then:
```powershell
# Allow the script to run for this session only
Set-ExecutionPolicy Bypass -Scope Process -Force
# cd to where you saved it
cd $env:USERPROFILE\Downloads
# Run it (interactive menu)
.\Start-AITerminalKickstart.ps1
# Or unattended β install everything, no prompts:
.\Start-AITerminalKickstart.ps1 -AutoMode
```
4. Close the PowerShell window and open a fresh one. `claude`, `codex`, `chatgpt`, `gh copilot`, and `netlify` should all resolve.
> If PowerShell refuses the script with *"cannot be loaded because running scripts is disabled"*, you skipped step 3's `Set-ExecutionPolicy` line. The `-Scope Process` flag is the safe version, it only lifts the restriction for the current terminal, not system-wide.
### Two known install errors on Server 2022 / Win 11 (and the one-liner fixes)
The script auto-detects and works around both of these β they only matter if you're running the install commands by hand outside the script. They are also documented in the script's `.NOTES` header for offline reference.
**1. Chocolatey:** *"Cannot overwrite variable result because the variable has been optimized."*
Chocolatey's `install.ps1` was authored for Windows PowerShell 5.1 and trips a known optimization bug in PowerShell 7+. Manual workaround β run from an elevated **Windows PowerShell 5.1** (`powershell.exe`), not `pwsh` 7:
```powershell
Set-ExecutionPolicy Bypass -Scope Process -Force
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
```
If you are already in `pwsh` 7, shell out to PS 5.1 in one line:
```powershell
& "$env:WINDIR\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -ExecutionPolicy Bypass -Command "Set-ExecutionPolicy Bypass -Scope Process -Force; [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))"
```
**2. Python:** *"Python not found after install"*
The installer succeeded, but the new install path isn't in the current shell's `$env:Path`. Common locations: `C:\Python312` (python.org `InstallAllUsers=1`), `C:\Program Files\Python312` (winget system scope), `$env:LOCALAPPDATA\Programs\Python\Python312` (winget per-user, default). To refresh PATH in the current session:
```powershell
$env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User')
```
Or skip `winget` and Chocolatey entirely and install Python 3.12 directly from python.org:
```powershell
$v = '3.12.13'
$u = "https://www.python.org/ftp/python/$v/python-$v-amd64.exe"
$f = "$env:TEMP\python-$v-amd64.exe"
Invoke-WebRequest $u -OutFile $f -UseBasicParsing
Start-Process $f -ArgumentList '/quiet','InstallAllUsers=1','PrependPath=1' -Wait
```
### Full Bash script
Expand start-ai-terminal-kickstart.sh, 1205 lines
{% raw %}
```bash
#!/usr/bin/env bash
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
# AI Terminal Kickstart - Linux Edition
# Supports: Ubuntu 20.04+, Linux Mint 20+, RHEL 8+/9+, Fedora, AlmaLinux
#
# One script to prep a Linux PC for AI-powered terminal work:
# 1. Claude Code (Anthropic)
# 2. ChatGPT CLI (OpenAI)
# 3. GitHub Copilot CLI (GitHub)
# + Netlify CLI for direct site deployment
#
# Usage:
# chmod +x start-ai-terminal-kickstart.sh
# sudo ./start-ai-terminal-kickstart.sh
# sudo ./start-ai-terminal-kickstart.sh --auto # unattended mode
#
# Author : AI Terminal ops
# Date : 2026-03-25
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
set -uo pipefail
# NOTE: -e (errexit) is intentionally omitted. This script uses manual error
# handling with || true and explicit checks. set -e causes false exits on
# arithmetic operations returning 0 and optional package installs failing.
# βββ Configuration ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
TEMP_DIR="/tmp/ai-kickstart-$(date +%Y%m%d)"
LOG_FILE="$TEMP_DIR/kickstart.log"
AUTO_MODE=false
ACTUAL_USER="${SUDO_USER:-$USER}"
ACTUAL_HOME=$(eval echo "~$ACTUAL_USER")
# Parse arguments
for arg in "$@"; do
case "$arg" in
--auto|-a) AUTO_MODE=true ;;
--help|-h)
echo "Usage: sudo $0 [--auto]"
echo " --auto Install everything without prompts"
exit 0
;;
esac
done
mkdir -p "$TEMP_DIR"
touch "$LOG_FILE"
# βββ Detect Distro βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
DISTRO="unknown"
PKG_MGR="unknown"
PKG_INSTALL=""
PKG_UPDATE=""
if [ -f /etc/os-release ]; then
. /etc/os-release
case "$ID" in
ubuntu|linuxmint|pop|elementary|zorin)
DISTRO="debian"
PKG_MGR="apt"
PKG_INSTALL="apt-get install -y"
PKG_UPDATE="apt-get update -qq"
;;
rhel|centos|rocky|alma|ol)
DISTRO="rhel"
PKG_MGR="dnf"
PKG_INSTALL="dnf install -y"
PKG_UPDATE="dnf check-update || true"
;;
fedora)
DISTRO="rhel"
PKG_MGR="dnf"
PKG_INSTALL="dnf install -y"
PKG_UPDATE="dnf check-update || true"
;;
*)
# Try to detect by package manager
if command -v apt-get &>/dev/null; then
DISTRO="debian"
PKG_MGR="apt"
PKG_INSTALL="apt-get install -y"
PKG_UPDATE="apt-get update -qq"
elif command -v dnf &>/dev/null; then
DISTRO="rhel"
PKG_MGR="dnf"
PKG_INSTALL="dnf install -y"
PKG_UPDATE="dnf check-update || true"
elif command -v yum &>/dev/null; then
DISTRO="rhel"
PKG_MGR="yum"
PKG_INSTALL="yum install -y"
PKG_UPDATE="yum check-update || true"
fi
;;
esac
fi
# βββ Helper Functions ββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[0;33m'
CYAN='\033[0;36m'
MAGENTA='\033[0;35m'
WHITE='\033[1;37m'
GRAY='\033[0;37m'
NC='\033[0m' # No Color
log() { echo "[$(date +%H:%M:%S)] $*" >> "$LOG_FILE"; }
section() { echo -e "\n ${CYAN}=================================================================${NC}"; echo -e " ${CYAN}$1${NC}"; echo -e " ${CYAN}=================================================================${NC}"; log "SECTION: $1"; }
step() { echo -e "\n ${CYAN}>> $1${NC}"; log "STEP: $1"; }
ok() { echo -e " ${GREEN}[OK]${NC} $1"; log " OK: $1"; }
warn() { echo -e " ${YELLOW}[WARN]${NC} $1"; log "WARN: $1"; }
fail() { echo -e " ${RED}[FAIL]${NC} $1"; log "FAIL: $1"; }
info() { echo -e " ${GRAY}$1${NC}"; }
tip() { echo -e " ${YELLOW}[TIP]${NC} $1"; }
cmd_exists() { command -v "$1" &>/dev/null; }
# βββ Progress bar ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
TOTAL_PHASES=6
CURRENT_PHASE=0
show_progress() {
local label="$1"
CURRENT_PHASE=$((CURRENT_PHASE + 1))
local pct=$((CURRENT_PHASE * 100 / TOTAL_PHASES))
local bar_len=30
local filled=$((bar_len * CURRENT_PHASE / TOTAL_PHASES))
local empty=$((bar_len - filled))
local bar=$(printf '%0.sβ' $(seq 1 $filled 2>/dev/null) || true)
local space=$(printf '%0.sβ' $(seq 1 $empty 2>/dev/null) || true)
printf "\r ${CYAN}[%s%s] %3d%% - Phase %d/%d: %s${NC} \n" \
"$bar" "$space" "$pct" "$CURRENT_PHASE" "$TOTAL_PHASES" "$label"
}
# Spinner for long-running commands
run_with_spinner() {
local label="$1"
shift
local cmd="$*"
local spin='β β β Ήβ Έβ Όβ ΄β ¦β §β β '
local i=0
eval "$cmd" &
local pid=$!
while kill -0 "$pid" 2>/dev/null; do
local c="${spin:i++%${#spin}:1}"
printf "\r ${CYAN}%s${NC} %s " "$c" "$label"
sleep 0.15
done
wait "$pid"
local rc=$?
printf "\r \r"
return $rc
}
# βββ Version Configuration (change these to update targets) ββββββββββββββββββ
NODE_MAJOR="22" # Node.js LTS major version
# Python version is auto-detected from system package manager
ask_yn() {
local prompt="$1"
local default="${2:-y}"
if $AUTO_MODE; then
[[ "$default" == "y" ]] && return 0 || return 1
fi
local hint="Y/n"
[[ "$default" == "n" ]] && hint="y/N"
echo -ne " ${YELLOW}$prompt ($hint): ${NC}"
read -r answer
answer="${answer:-$default}"
[[ "$answer" =~ ^[Yy] ]]
}
run_as_user() {
# Run a command as the actual user (not root)
# Uses "$@" quoting pattern via a helper to preserve spaces in arguments
if [ "$EUID" -eq 0 ] && [ -n "${SUDO_USER:-}" ]; then
sudo -u "$SUDO_USER" -- bash -c "$1"
else
bash -c "$1"
fi
}
# Track results for final summary
declare -a RESULT_NAMES=()
declare -a RESULT_STATUS=()
declare -a RESULT_DETAIL=()
add_result() {
RESULT_NAMES+=("$1")
RESULT_STATUS+=("$2")
RESULT_DETAIL+=("${3:-}")
}
# βββ Banner βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
echo -e "${MAGENTA}"
cat << 'BANNER'
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β β
β A I T E R M I N A L K I C K S T A R T β
β βββββββββββββββββββββββββββββββββββββββββ β
β Linux Edition (Ubuntu / RHEL / Mint) β
β β
β Claude Code | ChatGPT CLI | GitHub Copilot CLI β
β β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
BANNER
echo -e "${NC}"
# βββ System Info ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
echo -e " ${WHITE}System Info:${NC}"
echo -e " ${GRAY}OS : $(cat /etc/os-release 2>/dev/null | grep PRETTY_NAME | cut -d= -f2 | tr -d '"')${NC}"
echo -e " ${GRAY}Kernel : $(uname -r)${NC}"
echo -e " ${GRAY}Distro Type : $DISTRO ($PKG_MGR)${NC}"
echo -e " ${GRAY}User : $ACTUAL_USER${NC}"
echo -e " ${GRAY}Bash : $BASH_VERSION${NC}"
echo -e " ${GRAY}Log File : $LOG_FILE${NC}"
echo ""
if [ "$EUID" -ne 0 ]; then
echo -e " ${YELLOW}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"
echo -e " ${YELLOW}β WARNING: Not running as root. Re-run with sudo: β${NC}"
echo -e " ${YELLOW}β sudo $0${NC}"
echo -e " ${YELLOW}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"
echo ""
fi
if [ "$DISTRO" = "unknown" ]; then
fail "Could not detect your Linux distribution."
echo -e " Supported: Ubuntu, Linux Mint, RHEL, CentOS, Rocky, Alma, Fedora"
exit 1
fi
# βββ Pre-flight: Admin, Network, Disk, Repos, TLS ββββββββββββββββββββββββββββ
show_progress "Pre-flight Checks"
section "PRE-FLIGHT CHECKS"
# Log session separator
echo "" >> "$LOG_FILE"
echo "======================================================================" >> "$LOG_FILE"
echo "Session started: $(date '+%Y-%m-%d %H:%M:%S')" >> "$LOG_FILE"
echo "OS: $(cat /etc/os-release 2>/dev/null | grep PRETTY_NAME | cut -d= -f2 | tr -d '"')" >> "$LOG_FILE"
echo "Distro type: $DISTRO ($PKG_MGR) | User: $ACTUAL_USER | EUID: $EUID" >> "$LOG_FILE"
echo "======================================================================" >> "$LOG_FILE"
# Admin / root access check
step "Checking root/sudo privileges"
if [ "$EUID" -eq 0 ]; then
ok "Running as root - full install capability"
add_result "Root Access" "OK" "Elevated"
else
warn "NOT running as root. Package installs WILL fail."
info "Re-run with: sudo $0"
info "The following require root: apt/dnf install, repo setup, locale changes"
add_result "Root Access" "FAILED" "Not root"
fi
# TLS / certificates check
step "Checking TLS certificates"
if [ -f /etc/ssl/certs/ca-certificates.crt ] || [ -d /etc/pki/tls/certs ]; then
ok "CA certificate bundle present"
else
warn "CA certificates may be missing - HTTPS downloads could fail"
if [ "$DISTRO" = "debian" ]; then
$PKG_INSTALL ca-certificates >> "$LOG_FILE" 2>&1 || true
elif [ "$DISTRO" = "rhel" ]; then
$PKG_INSTALL ca-certificates >> "$LOG_FILE" 2>&1 || true
fi
fi
# OpenSSL version check
if cmd_exists openssl; then
SSL_VER=$(openssl version 2>/dev/null || true)
ok "OpenSSL: $SSL_VER"
else
warn "openssl not found - some tools may have TLS issues"
fi
add_result "TLS/Certs" "OK" ""
# Network connectivity - test multiple download sources
step "Testing internet connectivity to download sources"
REACHABLE=0
UNREACHABLE=0
declare -A NET_ENDPOINTS=(
["GitHub API"]="https://api.github.com"
["NodeSource"]="https://deb.nodesource.com"
["Claude installer"]="https://claude.ai"
["npm registry"]="https://registry.npmjs.org"
["PyPI"]="https://pypi.org"
)
for name in "${!NET_ENDPOINTS[@]}"; do
url="${NET_ENDPOINTS[$name]}"
if curl -sf --connect-timeout 8 --max-time 12 -o /dev/null "$url" 2>/dev/null; then
ok "$name reachable"
((REACHABLE++)) || true
else
warn "$name ($url) - UNREACHABLE"
((UNREACHABLE++)) || true
fi
done
TOTAL_EP=$((REACHABLE + UNREACHABLE))
if [ "$UNREACHABLE" -eq 0 ]; then
ok "All $REACHABLE download sources reachable"
add_result "Network" "OK" "$REACHABLE/$TOTAL_EP reachable"
elif [ "$UNREACHABLE" -lt 3 ]; then
warn "$UNREACHABLE of $TOTAL_EP sources unreachable. Some installs may fail."
add_result "Network" "PARTIAL" "$REACHABLE/$TOTAL_EP reachable"
else
fail "Most download sources unreachable. Script will likely fail."
info "Check: DNS, proxy, firewall, or VPN settings."
add_result "Network" "FAILED" "$REACHABLE/$TOTAL_EP reachable"
fi
# Disk space check
step "Checking available disk space"
FREE_GB=$(df -BG / 2>/dev/null | awk 'NR==2{print $4}' | tr -d 'G')
TOTAL_GB=$(df -BG / 2>/dev/null | awk 'NR==2{print $2}' | tr -d 'G')
if [ "${FREE_GB:-0}" -lt 2 ]; then
fail "CRITICAL: Only ${FREE_GB}GB free on / (${TOTAL_GB}GB total). Need at least 2GB."
info "Free up disk space before continuing."
add_result "Disk Space" "FAILED" "${FREE_GB}GB free"
elif [ "${FREE_GB:-0}" -lt 5 ]; then
warn "Low: ${FREE_GB}GB free on / (${TOTAL_GB}GB total). Recommend 5+ GB."
add_result "Disk Space" "WARN" "${FREE_GB}GB free"
else
ok "Disk space: ${FREE_GB}GB free on / (${TOTAL_GB}GB total)"
add_result "Disk Space" "OK" "${FREE_GB}GB free"
fi
# Check for package manager lock files
step "Checking for package manager locks"
if [ "$DISTRO" = "debian" ]; then
if fuser /var/lib/dpkg/lock-frontend &>/dev/null 2>&1 || fuser /var/lib/apt/lists/lock &>/dev/null 2>&1; then
warn "apt/dpkg is locked by another process. Wait for it to finish."
info "Run: sudo lsof /var/lib/dpkg/lock-frontend to see what holds it."
add_result "Package Lock" "WARN" "apt locked"
else
ok "No package manager locks detected"
add_result "Package Lock" "OK" ""
fi
elif [ "$DISTRO" = "rhel" ]; then
if [ -f /var/run/yum.pid ] || [ -f /var/run/dnf.pid ]; then
warn "dnf/yum lock file found. Another install may be running."
add_result "Package Lock" "WARN" "dnf locked"
else
ok "No package manager locks detected"
add_result "Package Lock" "OK" ""
fi
fi
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
# PHASE 1: SYSTEM UPDATE & CORE PACKAGES
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
show_progress "System Update & Core Packages"
section "PHASE 1: System Update & Core Packages"
step "Updating package lists"
eval "$PKG_UPDATE" >> "$LOG_FILE" 2>&1 || true
ok "Package lists updated"
# βββ Essential build tools ββββββββββββββββββββββββββββββββββββββββββββββββββββ
step "Installing essential build tools"
if [ "$DISTRO" = "debian" ]; then
$PKG_INSTALL build-essential curl wget ca-certificates gnupg lsb-release \
software-properties-common unzip tar >> "$LOG_FILE" 2>&1 || true
elif [ "$DISTRO" = "rhel" ]; then
$PKG_INSTALL gcc gcc-c++ make curl wget ca-certificates gnupg2 unzip tar \
>> "$LOG_FILE" 2>&1 || true
# Enable EPEL for extra packages
if ! rpm -q epel-release &>/dev/null; then
$PKG_INSTALL epel-release >> "$LOG_FILE" 2>&1 || true
fi
fi
ok "Build tools installed"
add_result "Build Tools" "INSTALLED" ""
step "Checking locale and UTF-8 support"
CURRENT_LANG="${LANG:-}"
if [[ "$CURRENT_LANG" == *"UTF-8"* ]] || [[ "$CURRENT_LANG" == *"utf8"* ]]; then
ok "Locale is UTF-8: $CURRENT_LANG"
else
warn "Locale is '$CURRENT_LANG' - may cause display issues with AI terminal output"
if [ "$DISTRO" = "debian" ]; then
$PKG_INSTALL locales >> "$LOG_FILE" 2>&1 || true
locale-gen en_US.UTF-8 >> "$LOG_FILE" 2>&1 || true
update-locale LANG=en_US.UTF-8 >> "$LOG_FILE" 2>&1 || true
fi
tip "Add to ~/.bashrc: export LANG=en_US.UTF-8"
if ! grep -q 'LANG=en_US.UTF-8' "$ACTUAL_HOME/.bashrc" 2>/dev/null; then
echo 'export LANG=en_US.UTF-8' >> "$ACTUAL_HOME/.bashrc"
fi
fi
# βββ Git ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
step "Checking Git"
if cmd_exists git; then
ok "Git already installed ($(git --version))"
add_result "Git" "PRESENT" "$(git --version)"
else
info "Git is REQUIRED for Claude Code and version control."
if ask_yn "Install Git?"; then
$PKG_INSTALL git >> "$LOG_FILE" 2>&1 || true
ok "Git installed ($(git --version))"
add_result "Git" "INSTALLED" "$(git --version)"
else
warn "Skipping Git - Claude Code WILL NOT WORK without it!"
add_result "Git" "SKIPPED" "WARNING"
fi
fi
# Git user config check
if cmd_exists git; then
step "Checking Git configuration"
GIT_USER=$(run_as_user "git config --global user.name" 2>/dev/null)
GIT_EMAIL=$(run_as_user "git config --global user.email" 2>/dev/null)
if [ -z "$GIT_USER" ] || [ -z "$GIT_EMAIL" ]; then
warn "Git user.name or user.email not set. Commits will fail without these."
tip "Run: git config --global user.name 'Your Name'"
tip "Run: git config --global user.email 'you@example.com'"
else
ok "Git user: $GIT_USER <$GIT_EMAIL>"
fi
run_as_user "git config --global init.defaultBranch main" 2>/dev/null
run_as_user "git config --global core.autocrlf input" 2>/dev/null
fi
# βββ Node.js (via NodeSource) ββββββββββββββββββββββββββββββββββββββββββββββββ
step "Checking Node.js"
if cmd_exists node; then
ok "Node.js already installed ($(node --version))"
cmd_exists npm && ok "npm $(npm --version)"
cmd_exists npx && ok "npx available"
add_result "Node.js" "PRESENT" "$(node --version)"
else
info "Node.js is required for Claude Code, npm tools, and MCP servers."
if ask_yn "Install Node.js ${NODE_MAJOR} LTS?"; then
if [ "$DISTRO" = "debian" ]; then
# NodeSource setup for Debian/Ubuntu
curl -fsSL https://deb.nodesource.com/setup_${NODE_MAJOR}.x | bash - >> "$LOG_FILE" 2>&1 || true
$PKG_INSTALL nodejs >> "$LOG_FILE" 2>&1 || true
elif [ "$DISTRO" = "rhel" ]; then
curl -fsSL https://rpm.nodesource.com/setup_${NODE_MAJOR}.x | bash - >> "$LOG_FILE" 2>&1 || true
$PKG_INSTALL nodejs >> "$LOG_FILE" 2>&1 || true
fi
if cmd_exists node; then
ok "Node.js $(node --version) installed"
ok "npm $(npm --version)"
add_result "Node.js" "INSTALLED" "$(node --version)"
else
fail "Node.js installation failed"
add_result "Node.js" "FAILED" ""
fi
else
add_result "Node.js" "SKIPPED" ""
fi
fi
# Fix npm global permissions for the actual user
if cmd_exists npm; then
step "Configuring npm global directory (no-sudo installs)"
NPM_GLOBAL="$ACTUAL_HOME/.npm-global"
run_as_user "mkdir -p '$NPM_GLOBAL'"
run_as_user "npm config set prefix '$NPM_GLOBAL'"
# Add to PATH in bashrc if not already there
BASHRC="$ACTUAL_HOME/.bashrc"
if ! grep -q 'npm-global' "$BASHRC" 2>/dev/null; then
echo '' >> "$BASHRC"
echo '# npm global packages (no sudo needed)' >> "$BASHRC"
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> "$BASHRC"
fi
export PATH="$NPM_GLOBAL/bin:$PATH"
ok "npm global dir: $NPM_GLOBAL"
fi
# βββ Python βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
step "Checking Python"
PYTHON_CMD=""
if cmd_exists python3; then
PYTHON_CMD="python3"
elif cmd_exists python; then
PYTHON_CMD="python"
fi
if [ -n "$PYTHON_CMD" ]; then
ok "Python already installed ($($PYTHON_CMD --version 2>&1))"
add_result "Python" "PRESENT" "$($PYTHON_CMD --version 2>&1)"
else
info "Python is used for MCP servers, AI SDKs, and data processing."
if ask_yn "Install Python 3?"; then
if [ "$DISTRO" = "debian" ]; then
$PKG_INSTALL python3 python3-pip python3-venv python3-dev >> "$LOG_FILE" 2>&1 || true
elif [ "$DISTRO" = "rhel" ]; then
$PKG_INSTALL python3 python3-pip python3-devel >> "$LOG_FILE" 2>&1 || true
fi
PYTHON_CMD="python3"
if cmd_exists python3; then
ok "Python $(python3 --version 2>&1) installed"
add_result "Python" "INSTALLED" "$(python3 --version 2>&1)"
else
fail "Python installation failed"
add_result "Python" "FAILED" ""
fi
else
add_result "Python" "SKIPPED" ""
fi
fi
# Upgrade pip
if [ -n "$PYTHON_CMD" ] && cmd_exists "$PYTHON_CMD"; then
step "Upgrading pip"
run_as_user "$PYTHON_CMD -m pip install --upgrade pip --quiet" 2>/dev/null || true
ok "pip upgraded"
fi
# βββ CLI Utilities ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
step "Installing CLI utilities"
declare -A CLI_TOOLS
if [ "$DISTRO" = "debian" ]; then
CLI_TOOLS=(
[ripgrep]="ripgrep"
[jq]="jq"
[fd]="fd-find"
[imagemagick]="imagemagick"
[p7zip]="p7zip-full"
[ghostscript]="ghostscript"
[ffmpeg]="ffmpeg"
[bat]="bat"
[fzf]="fzf"
[yq]="yq"
[tree]="tree"
[delta]="git-delta"
[shellcheck]="shellcheck"
[tmux]="tmux"
[sqlite3]="sqlite3"
)
elif [ "$DISTRO" = "rhel" ]; then
CLI_TOOLS=(
[ripgrep]="ripgrep"
[jq]="jq"
[fd]="fd-find"
[imagemagick]="ImageMagick"
[p7zip]="p7zip"
[ghostscript]="ghostscript"
[ffmpeg]="ffmpeg"
[bat]="bat"
[fzf]="fzf"
[yq]="yq"
[tree]="tree"
[delta]="git-delta"
[shellcheck]="ShellCheck"
[tmux]="tmux"
[sqlite3]="sqlite"
)
fi
CLI_CMDS=(
[ripgrep]="rg"
[jq]="jq"
[fd]="fdfind"
[imagemagick]="convert"
[p7zip]="7z"
[ghostscript]="gs"
[ffmpeg]="ffmpeg"
[bat]="batcat"
[fzf]="fzf"
[yq]="yq"
[tree]="tree"
[delta]="delta"
[shellcheck]="shellcheck"
[tmux]="tmux"
[sqlite3]="sqlite3"
)
CLI_DESC=(
[ripgrep]="Ultra-fast code search (used by Claude Code)"
[jq]="JSON processor for API responses"
[fd]="Fast file finder"
[imagemagick]="Image processing (convert, resize)"
[p7zip]="Archive compression"
[ghostscript]="PDF/PostScript engine (required by ImageMagick for PDFs)"
[ffmpeg]="Video/audio processing and media conversion"
[bat]="Syntax-highlighted file viewer (better cat)"
[fzf]="Fuzzy finder for files, history, and commands"
[yq]="YAML processor (like jq but for YAML)"
[tree]="Directory structure viewer"
[delta]="Enhanced git diff viewer with syntax highlighting"
[shellcheck]="Shell script linter and validator"
[tmux]="Terminal multiplexer for persistent sessions"
[sqlite3]="Lightweight database engine and client"
)
for tool in ripgrep jq fd imagemagick p7zip ghostscript ffmpeg bat fzf yq tree delta shellcheck tmux sqlite3; do
pkg="${CLI_TOOLS[$tool]:-}"
cmd="${CLI_CMDS[$tool]:-$tool}"
desc="${CLI_DESC[$tool]:-}"
if cmd_exists "$cmd"; then
ok "$tool is installed"
add_result "$tool" "PRESENT" ""
else
info "$tool: $desc"
if ask_yn "Install $tool?"; then
$PKG_INSTALL "$pkg" >> "$LOG_FILE" 2>&1 || true
ok "$tool installed"
add_result "$tool" "INSTALLED" ""
else
add_result "$tool" "SKIPPED" ""
fi
fi
done
# βββ Python Packages βββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
if [ -n "$PYTHON_CMD" ] && cmd_exists "$PYTHON_CMD"; then
step "Python packages for AI development"
info "These packages enhance what Claude Code and AI tools can do:"
info " Data: numpy, pandas, polars, matplotlib, openpyxl"
info " Web: requests, httpx, beautifulsoup4"
info " AI: anthropic, openai, fastmcp, mcp"
info " Dev: pydantic, rich, pyyaml, python-dotenv"
if ask_yn "Install recommended Python packages?"; then
PACKAGES="numpy pandas polars matplotlib openpyxl requests httpx beautifulsoup4 lxml anthropic openai fastmcp mcp pydantic rich pyyaml python-dotenv Pillow chardet tabulate jsonlines"
run_as_user "$PYTHON_CMD -m pip install --user $PACKAGES --quiet" >> "$LOG_FILE" 2>&1 || true
ok "Python packages installed"
add_result "Python Packages" "INSTALLED" "22 packages"
else
add_result "Python Packages" "SKIPPED" ""
fi
# uv package manager
step "Checking uv (fast Python package manager)"
if cmd_exists uv; then
ok "uv already installed ($(uv --version 2>/dev/null))"
add_result "uv" "PRESENT" ""
else
if ask_yn "Install uv?"; then
run_as_user "curl -LsSf https://astral.sh/uv/install.sh | sh" >> "$LOG_FILE" 2>&1 || true
export PATH="$ACTUAL_HOME/.cargo/bin:$PATH"
ok "uv installed"
add_result "uv" "INSTALLED" ""
else
add_result "uv" "SKIPPED" ""
fi
fi
fi
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
# PHASE 2: AI TERMINAL INSTALLATIONS
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
show_progress "AI Terminal Solutions"
section "PHASE 2: AI Terminal Solutions"
echo ""
echo -e " ${WHITE}Which AI terminal solutions would you like to set up?${NC}"
echo ""
echo -e " ${CYAN}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"
echo -e " ${CYAN}β 1. Claude Code (Anthropic) β${NC}"
echo -e " ${GRAY}β Best for: Deep code understanding, multi-file edits, β${NC}"
echo -e " ${GRAY}β agentic coding, MCP servers, security research β${NC}"
echo -e " ${GRAY}β Auth: Browser login (OAuth) or ANTHROPIC_API_KEY β${NC}"
echo -e " ${CYAN}β β${NC}"
echo -e " ${CYAN}β 2. ChatGPT CLI (OpenAI) via npx chatgpt β${NC}"
echo -e " ${GRAY}β Best for: Quick questions, brainstorming, general AI β${NC}"
echo -e " ${GRAY}β Auth: OPENAI_API_KEY environment variable β${NC}"
echo -e " ${CYAN}β β${NC}"
echo -e " ${CYAN}β 3. GitHub Copilot CLI (GitHub) β${NC}"
echo -e " ${GRAY}β Best for: Shell command suggestions, git operations β${NC}"
echo -e " ${GRAY}β Auth: gh auth login (browser-based) β${NC}"
echo -e " ${CYAN}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"
echo ""
INSTALL_CLAUDE=false
INSTALL_CHATGPT=false
INSTALL_COPILOT=false
ask_yn "Install Claude Code?" && INSTALL_CLAUDE=true
ask_yn "Install ChatGPT CLI tools?" && INSTALL_CHATGPT=true
ask_yn "Install GitHub Copilot CLI?" && INSTALL_COPILOT=true
# βββ Claude Code ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
if $INSTALL_CLAUDE; then
section "Installing Claude Code"
if cmd_exists claude; then
ok "Claude Code already installed ($(claude --version 2>/dev/null || echo 'installed'))"
add_result "Claude Code" "PRESENT" ""
else
step "Installing Claude Code via official installer..."
info "This uses Anthropic's official install script."
run_as_user "curl -fsSL https://claude.ai/install.sh | sh" >> "$LOG_FILE" 2>&1 || true
# Add to PATH
export PATH="$ACTUAL_HOME/.local/bin:$PATH"
if ! grep -qF '.local/bin' "$ACTUAL_HOME/.bashrc" 2>/dev/null; then
echo '' >> "$ACTUAL_HOME/.bashrc"
echo '# Claude Code PATH' >> "$ACTUAL_HOME/.bashrc"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$ACTUAL_HOME/.bashrc"
fi
if run_as_user "command -v claude" &>/dev/null; then
ok "Claude Code installed!"
add_result "Claude Code" "INSTALLED" ""
else
# Fallback: npm install
warn "Official installer may need a new shell. Trying npm fallback..."
if cmd_exists npm; then
run_as_user "npm install -g @anthropic-ai/claude-code" >> "$LOG_FILE" 2>&1 || true
if run_as_user "command -v claude" &>/dev/null; then
ok "Claude Code installed via npm"
add_result "Claude Code" "INSTALLED" "via npm"
else
fail "Claude Code install needs a terminal restart"
tip "Close this terminal, open a new one, and run: claude"
add_result "Claude Code" "INSTALLED" "restart terminal"
fi
else
fail "npm not available for fallback install"
add_result "Claude Code" "FAILED" "npm missing"
fi
fi
fi
# Claude Code authentication guide
echo ""
echo -e " ${CYAN}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"
echo -e " ${CYAN}β CLAUDE CODE AUTHENTICATION β${NC}"
echo -e " ${CYAN}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€${NC}"
echo -e " ${GRAY}β β${NC}"
echo -e " ${GRAY}β Option A - Browser Login (easiest): β${NC}"
echo -e " ${WHITE}β 1. Run: claude β${NC}"
echo -e " ${WHITE}β 2. Browser opens -> log in at claude.ai β${NC}"
echo -e " ${WHITE}β 3. Click Authorize -> return to terminal β${NC}"
echo -e " ${GRAY}β β${NC}"
echo -e " ${GRAY}β Option B - API Key: β${NC}"
echo -e " ${WHITE}β 1. Get key from console.anthropic.com/settings/keys β${NC}"
echo -e " ${WHITE}β 2. export ANTHROPIC_API_KEY=\"sk-ant-your-key\" β${NC}"
echo -e " ${WHITE}β 3. Add to ~/.bashrc to persist β${NC}"
echo -e " ${GRAY}β β${NC}"
echo -e " ${CYAN}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"
if ask_yn "Set ANTHROPIC_API_KEY now?" "n"; then
echo -ne " ${YELLOW}Enter your Anthropic API key (sk-ant-...): ${NC}"
read -r ANTHROPIC_KEY
if [[ "$ANTHROPIC_KEY" == sk-ant-* ]]; then
echo "export ANTHROPIC_API_KEY=\"$ANTHROPIC_KEY\"" >> "$ACTUAL_HOME/.bashrc"
export ANTHROPIC_API_KEY="$ANTHROPIC_KEY"
ok "ANTHROPIC_API_KEY saved to ~/.bashrc"
else
warn "Key doesn't start with sk-ant- . Skipped. Use browser login instead."
fi
fi
fi
# βββ ChatGPT CLI βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
if $INSTALL_CHATGPT; then
section "Installing ChatGPT CLI Tools"
step "Installing OpenAI-compatible CLI tools..."
# Install the Node.js based chatgpt client
if cmd_exists npm; then
info "Installing chatgpt npm package..."
run_as_user "npm install -g chatgpt-cli" >> "$LOG_FILE" 2>&1 || true
ok "chatgpt-cli installed (run: chatgpt)"
add_result "ChatGPT CLI" "INSTALLED" "chatgpt-cli"
else
warn "npm not available - cannot install ChatGPT CLI"
add_result "ChatGPT CLI" "FAILED" "npm missing"
fi
# Install the Python openai package for scripting
if [ -n "${PYTHON_CMD:-}" ] && cmd_exists "$PYTHON_CMD"; then
run_as_user "$PYTHON_CMD -m pip install --user openai --quiet" >> "$LOG_FILE" 2>&1 || true
ok "OpenAI Python SDK installed"
fi
# Authentication guide
echo ""
echo -e " ${CYAN}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"
echo -e " ${CYAN}β CHATGPT AUTHENTICATION β${NC}"
echo -e " ${CYAN}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€${NC}"
echo -e " ${GRAY}β β${NC}"
echo -e " ${WHITE}β 1. Get API key: https://platform.openai.com/api-keys β${NC}"
echo -e " ${WHITE}β 2. Set it: export OPENAI_API_KEY=\"sk-your-key\" β${NC}"
echo -e " ${WHITE}β 3. Persist: add the export line to ~/.bashrc β${NC}"
echo -e " ${WHITE}β 4. Test: curl https://api.openai.com/v1/models \\ β${NC}"
echo -e " ${WHITE}β -H \"Authorization: Bearer \$OPENAI_API_KEY\" β${NC}"
echo -e " ${GRAY}β β${NC}"
echo -e " ${CYAN}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"
if ask_yn "Set OPENAI_API_KEY now?" "n"; then
echo -ne " ${YELLOW}Enter your OpenAI API key (sk-...): ${NC}"
read -r OPENAI_KEY
if [[ "$OPENAI_KEY" == sk-* ]]; then
echo "export OPENAI_API_KEY=\"$OPENAI_KEY\"" >> "$ACTUAL_HOME/.bashrc"
export OPENAI_API_KEY="$OPENAI_KEY"
ok "OPENAI_API_KEY saved to ~/.bashrc"
else
warn "Key format not recognized. Set it manually later."
fi
fi
fi
# βββ GitHub Copilot CLI ββββββββββββββββββββββββββββββββββββββββββββββββββββββ
if $INSTALL_COPILOT; then
section "Installing GitHub Copilot CLI"
# Install GitHub CLI first
step "Checking GitHub CLI (gh)"
if cmd_exists gh; then
ok "GitHub CLI already installed ($(gh --version 2>/dev/null | head -1))"
else
info "GitHub CLI is required for Copilot CLI."
if ask_yn "Install GitHub CLI?" "y"; then
if [ "$DISTRO" = "debian" ]; then
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg 2>/dev/null
chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg || true
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" > /etc/apt/sources.list.d/github-cli.list
apt-get update -qq >> "$LOG_FILE" 2>&1 || true
$PKG_INSTALL gh >> "$LOG_FILE" 2>&1 || true
elif [ "$DISTRO" = "rhel" ]; then
dnf install -y 'dnf-command(config-manager)' >> "$LOG_FILE" 2>&1 || true
dnf config-manager --add-repo https://cli.github.com/packages/rpm/gh-cli.repo >> "$LOG_FILE" 2>&1 || true
$PKG_INSTALL gh >> "$LOG_FILE" 2>&1 || true
fi
fi
fi
if cmd_exists gh; then
ok "GitHub CLI: $(gh --version 2>/dev/null | head -1)"
add_result "GitHub CLI" "PRESENT" ""
step "Installing Copilot CLI extension..."
run_as_user "gh extension install github/gh-copilot" >> "$LOG_FILE" 2>&1 || true
ok "Copilot CLI extension installed"
add_result "GitHub Copilot CLI" "INSTALLED" ""
# Authentication guide
echo ""
echo -e " ${CYAN}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"
echo -e " ${CYAN}β GITHUB COPILOT AUTHENTICATION β${NC}"
echo -e " ${CYAN}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€${NC}"
echo -e " ${GRAY}β β${NC}"
echo -e " ${WHITE}β 1. Run: gh auth login β${NC}"
echo -e " ${WHITE}β 2. Choose: GitHub.com β${NC}"
echo -e " ${WHITE}β 3. Choose: Login with a web browser β${NC}"
echo -e " ${WHITE}β 4. Copy the one-time code shown β${NC}"
echo -e " ${WHITE}β 5. Browser opens -> paste code -> Authorize β${NC}"
echo -e " ${WHITE}β 6. Return to terminal -> authenticated β${NC}"
echo -e " ${GRAY}β β${NC}"
echo -e " ${GRAY}β Requires: GitHub Copilot subscription (\$10/mo or free β${NC}"
echo -e " ${GRAY}β for students and open source maintainers) β${NC}"
echo -e " ${GRAY}β β${NC}"
echo -e " ${CYAN}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"
if ask_yn "Log in to GitHub now?" "n"; then
run_as_user "gh auth login"
fi
else
fail "GitHub CLI not available"
add_result "GitHub Copilot CLI" "FAILED" "gh CLI missing"
fi
fi
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
# PHASE 3: NETLIFY CLI & DEPLOYMENT TOOLS
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
show_progress "Deployment & Extras"
section "PHASE 3: Netlify CLI & Deployment"
step "Checking Netlify CLI"
if cmd_exists netlify; then
ok "Netlify CLI already installed ($(netlify --version 2>/dev/null))"
add_result "Netlify CLI" "PRESENT" ""
else
info "Netlify CLI lets you deploy websites directly from your terminal."
info "Free tier: 100GB bandwidth, 300 build minutes/month, custom domains."
if ask_yn "Install Netlify CLI?"; then
if cmd_exists npm; then
run_as_user "npm install -g netlify-cli" >> "$LOG_FILE" 2>&1 || true
export PATH="${NPM_GLOBAL:-$ACTUAL_HOME/.npm-global}/bin:$PATH"
if run_as_user "command -v netlify" &>/dev/null || cmd_exists netlify; then
ok "Netlify CLI installed"
add_result "Netlify CLI" "INSTALLED" ""
else
warn "Netlify CLI installed but needs terminal restart for PATH"
add_result "Netlify CLI" "INSTALLED" "restart terminal"
fi
else
fail "npm not available - install Node.js first"
add_result "Netlify CLI" "FAILED" "npm missing"
fi
else
add_result "Netlify CLI" "SKIPPED" ""
fi
fi
# Netlify authentication guide
echo ""
echo -e " ${CYAN}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"
echo -e " ${CYAN}β NETLIFY AUTHENTICATION & DEPLOYMENT β${NC}"
echo -e " ${CYAN}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€${NC}"
echo -e " ${GRAY}β β${NC}"
echo -e " ${WHITE}β LOGIN: β${NC}"
echo -e " ${WHITE}β netlify login β${NC}"
echo -e " ${WHITE}β (browser opens -> click Authorize -> return to terminal) β${NC}"
echo -e " ${GRAY}β β${NC}"
echo -e " ${WHITE}β FIRST DEPLOY (link a folder to a Netlify site): β${NC}"
echo -e " ${WHITE}β cd /path/to/my-website β${NC}"
echo -e " ${WHITE}β netlify init β${NC}"
echo -e " ${WHITE}β netlify deploy # preview draft β${NC}"
echo -e " ${WHITE}β netlify deploy --prod # push live β${NC}"
echo -e " ${GRAY}β β${NC}"
echo -e " ${WHITE}β AI-POWERED DEPLOY (use Claude to edit then deploy): β${NC}"
echo -e " ${WHITE}β cd /path/to/my-website β${NC}"
echo -e " ${WHITE}β claude β${NC}"
echo -e " ${WHITE}β > fix the broken nav menu and deploy a draft to Netlify β${NC}"
echo -e " ${GRAY}β β${NC}"
echo -e " ${WHITE}β ENVIRONMENT VARIABLES: β${NC}"
echo -e " ${WHITE}β netlify env:set MY_VAR \"value\" β${NC}"
echo -e " ${WHITE}β netlify env:list β${NC}"
echo -e " ${GRAY}β β${NC}"
echo -e " ${CYAN}ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"
if cmd_exists netlify || run_as_user "command -v netlify" &>/dev/null; then
if ask_yn "Log in to Netlify now?" "n"; then
run_as_user "netlify login"
fi
fi
# βββ Vercel CLI βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
step "Checking Vercel CLI"
if cmd_exists vercel || run_as_user "command -v vercel" &>/dev/null; then
ok "Vercel CLI already installed"
add_result "Vercel CLI" "PRESENT" ""
else
info "Vercel is another popular hosting platform (like Netlify)."
if ask_yn "Install Vercel CLI?" "n"; then
if cmd_exists npm; then
run_as_user "npm install -g vercel" >> "$LOG_FILE" 2>&1 || true
ok "Vercel CLI installed"
add_result "Vercel CLI" "INSTALLED" ""
else
fail "npm not available"
add_result "Vercel CLI" "FAILED" "npm missing"
fi
else
add_result "Vercel CLI" "SKIPPED" ""
fi
fi
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
# PHASE 4: ENVIRONMENT HEALTH CHECK
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
show_progress "Validation & Health Check"
section "PHASE 4: Environment Health Check"
echo ""
printf " ${WHITE}%-18s %-10s %-35s${NC}\n" "Component" "Status" "Version / Details"
printf " %-18s %-10s %-35s\n" "ββββββββββββββββββ" "ββββββββββ" "βββββββββββββββββββββββββββββββββββ"
# βββ Functional Validation (not just version checks) ββββββββββββββββββββββββββ
step "Running functional validation tests"
# Test Node.js can execute JavaScript
if cmd_exists node; then
NODE_TEST=$(run_as_user "node -e \"console.log('node-ok')\"" 2>/dev/null || true)
if [[ "$NODE_TEST" == *"node-ok"* ]]; then
ok "Node.js exec: PASS"
else
warn "Node.js exec: FAIL - node installed but cannot run JS"
fi
fi
# Test Python SSL and package imports
if [ -n "${PYTHON_CMD:-}" ] && cmd_exists "$PYTHON_CMD"; then
PY_SSL=$(run_as_user "$PYTHON_CMD -c \"import ssl; print('py-ssl-ok:', ssl.OPENSSL_VERSION)\"" 2>/dev/null || true)
if [[ "$PY_SSL" == *"py-ssl-ok"* ]]; then
ok "Python SSL: PASS (${PY_SSL#*: })"
else
warn "Python SSL: FAIL - HTTPS requests may not work"
fi
PY_IMPORT=$(run_as_user "$PYTHON_CMD -c \"import requests, pydantic; print('imports-ok')\"" 2>/dev/null || true)
if [[ "$PY_IMPORT" == *"imports-ok"* ]]; then
ok "Python packages: PASS"
else
warn "Python packages: FAIL - some packages not importable"
fi
fi
# Test npm registry connectivity
if cmd_exists npm; then
NPM_PING=$(run_as_user "npm ping" 2>/dev/null || true)
if [ $? -eq 0 ] || [[ "$NPM_PING" != *"ERR"* ]]; then
ok "npm registry: PASS"
else
warn "npm registry: FAIL - npm cannot reach registry"
fi
fi
# Test Git HTTPS connectivity
if cmd_exists git; then
GIT_LS=$(run_as_user "git ls-remote --heads https://github.com/anthropics/claude-code.git" 2>/dev/null || true)
if [ -n "$GIT_LS" ]; then
ok "Git HTTPS: PASS"
else
warn "Git HTTPS: FAIL - git cannot reach GitHub"
fi
fi
echo ""
CHECKS=(
"Git:git --version"
"Node.js:node --version"
"npm:npm --version"
"npx:npx --version"
"Python:python3 --version"
"pip:python3 -m pip --version"
"uv:uv --version"
"Claude Code:claude --version"
"GitHub CLI:gh --version"
"Netlify CLI:netlify --version"
"Vercel CLI:vercel --version"
"ripgrep:rg --version"
"jq:jq --version"
"ImageMagick:convert --version"
"GhostScript:gs --version"
"FFmpeg:ffmpeg -version"
"tmux:tmux -V"
"sqlite3:sqlite3 --version"
"bat:batcat --version"
"fzf:fzf --version"
"shellcheck:shellcheck --version"
)
PASS_COUNT=0
FAIL_COUNT=0
for check in "${CHECKS[@]}"; do
name="${check%%:*}"
cmd="${check#*:}"
padded_name=$(printf "%-18s" "$name")
ver=$(run_as_user "$cmd" 2>/dev/null | head -1 || true)
if [ -n "$ver" ]; then
truncated="${ver:0:35}"
printf " %s ${GREEN}%-10s${NC} ${GRAY}%s${NC}\n" "$padded_name" "PASS" "$truncated"
PASS_COUNT=$((PASS_COUNT + 1))
else
printf " %s ${RED}%-10s${NC} ${GRAY}%s${NC}\n" "$padded_name" "MISSING" "Not installed"
FAIL_COUNT=$((FAIL_COUNT + 1))
fi
done
echo ""
echo -e " βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ"
if [ "$FAIL_COUNT" -eq 0 ]; then
echo -e " ${GREEN}Total: $PASS_COUNT passed, $FAIL_COUNT missing${NC}"
else
echo -e " ${YELLOW}Total: $PASS_COUNT passed, $FAIL_COUNT missing${NC}"
fi
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
# PHASE 5: QUICK REFERENCE GUIDE
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
show_progress "Complete"
section "PHASE 5: Quick Reference Guide"
echo -e "${CYAN}"
cat << 'GUIDE'
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β HOW TO USE YOUR AI TERMINALS β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β β
β CLAUDE CODE (Best for coding, files, agents) β
β βββββββββββββββββββββββββββββββββββββββββββββ β
β claude Start interactive session β
β claude "fix this bug" One-shot command β
β claude doctor Diagnose configuration β
β /help In-session help β
β β
β First time: run 'claude' -> browser opens -> log in -> β
β click Authorize -> return to terminal -> start coding! β
β β
β CHATGPT CLI (Best for quick Q&A, brainstorming) β
β βββββββββββββββββββββββββββββββββββββββββββββ β
β chatgpt Start interactive chat (if avail) β
β Set OPENAI_API_KEY first, then use CLI tools β
β β
β GITHUB COPILOT CLI (Best for shell commands) β
β βββββββββββββββββββββββββββββββββββββββββββββ β
β gh copilot suggest "..." Get command suggestions β
β gh copilot explain "..." Explain a command β
β gh auth login Log in to GitHub first β
β β
β NETLIFY DEPLOYMENT β
β ββββββββββββββββββ β
β netlify login Authenticate β
β cd /path/to/site β
β netlify init Link folder to Netlify site β
β netlify deploy Preview deploy β
β netlify deploy --prod Production deploy β
β β
β AI + DEPLOY WORKFLOW (the magic combo) β
β βββββββββββββββββββββββββββββββββββββ β
β cd /path/to/site && claude β
β > make the hero section more engaging, then deploy β
β a draft to Netlify so I can preview it β
β β
β GUI & WEB INTERFACES (when you prefer a visual tool) β
β βββββββββββββββββββββββββββββββββββββββββββββββ β
β Claude web app: https://claude.ai/code β
β Claude VS Code: Extensions > search "Claude Code" β
β ChatGPT web: https://chatgpt.com β
β ChatGPT desktop: https://openai.com/chatgpt/download β
β Copilot VS Code: Extensions > "GitHub Copilot" β
β Netlify GUI: https://app.netlify.com β
β β
β APP CONNECTORS (via Claude Code MCP Servers) β
β ββββββββββββββββββββββββββββββββββββββββββββ β
β claude mcp add gdrive -- npx @anthropic/gdrive-mcp β
β claude mcp add slack -- npx @anthropic/slack-mcp β
β claude mcp add github -- npx @anthropic/github-mcp β
β claude mcp add playwright -- npx @playwright/mcp@latest β
β claude mcp list # see all connected services β
β β
β COMMON TIPS β
β βββββββββββ β
β - Always cd into your project folder BEFORE starting claude β
β - Be specific in prompts for better results β
β - Open a NEW terminal after install for PATH changes β
β - Run 'claude doctor' if something seems broken β
β β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
GUIDE
echo -e "${NC}"
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
# FINAL SUMMARY
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
ELAPSED=$((SECONDS / 60))m$((SECONDS % 60))s
echo -e " ${GREEN}βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"
echo -e " ${GREEN}β KICKSTART COMPLETE β${NC}"
echo -e " ${GREEN}β ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ£${NC}"
echo -e " ${GREEN}β β${NC}"
printf " ${GREEN}β${NC} ${WHITE}%-22s %-12s %-25s${NC} ${GREEN}β${NC}\n" "Component" "Status" "Detail"
printf " ${GREEN}β${NC} %-22s %-12s %-25s ${GREEN}β${NC}\n" "ββββββββββββββββββββββ" "ββββββββββββ" "βββββββββββββββββββββββββ"
for i in "${!RESULT_NAMES[@]}"; do
name="${RESULT_NAMES[$i]}"
status="${RESULT_STATUS[$i]}"
detail="${RESULT_DETAIL[$i]:0:25}"
case "$status" in
INSTALLED|PRESENT|RAN|OK) color="$GREEN" ;;
SKIPPED|PARTIAL) color="$YELLOW" ;;
FAILED|ERROR) color="$RED" ;;
*) color="$GRAY" ;;
esac
printf " ${GREEN}β${NC} ${color}%-22s %-12s${NC} ${GRAY}%-25s${NC} ${GREEN}β${NC}\n" "$name" "$status" "$detail"
done
echo -e " ${GREEN}β β${NC}"
echo -e " ${GREEN}β Time elapsed: $ELAPSED ${GREEN}β${NC}"
echo -e " ${GREEN}β Log file : $LOG_FILE${GREEN}$(printf '%*s' $((35 - ${#LOG_FILE})) '')β${NC}"
echo -e " ${GREEN}β β${NC}"
echo -e " ${GREEN}β NEXT STEPS: β${NC}"
echo -e " ${GREEN}β 1. CLOSE this terminal and open a NEW one (PATH refresh) β${NC}"
echo -e " ${GREEN}β 2. Run 'claude' to start Claude Code (browser auth first time) β${NC}"
echo -e " ${GREEN}β 3. Run 'gh auth login' for GitHub Copilot β${NC}"
echo -e " ${GREEN}β 4. Run 'netlify login' to authenticate Netlify β${NC}"
echo -e " ${GREEN}β 5. cd into your project folder, then 'claude' to start! β${NC}"
echo -e " ${GREEN}β β${NC}"
echo -e " ${GREEN}βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ${NC}"
echo ""
```
{% endraw %}
### Full PowerShell script
Expand Start-AITerminalKickstart.ps1, 1718 lines
{% raw %}
```powershell
#Requires -Version 5.1
<#
.SYNOPSIS
AI Terminal Kickstart - One script to prep any Windows PC for AI-powered terminal work.
.DESCRIPTION
Interactive, menu-driven installer that bootstraps a Windows PC with everything
needed for the top 3 AI terminal solutions:
1. Claude Code (Anthropic) - Terminal AI coding assistant
2. ChatGPT CLI (OpenAI) - Interactive GPT in your terminal
3. GitHub Copilot CLI (GitHub) - AI-powered shell suggestions
The script:
- Self-upgrades to PowerShell 7 if running from PS 5.x
- Installs all prerequisites (Git, Node.js, Python, etc.)
- Runs your existing installer scripts as sub-modules
- Provides a guided, color-coded experience any junior tech can follow
- Validates every install step with logic tests
- Generates a final health-check report
.PARAMETER AutoMode
Skip all menus and install everything. Great for unattended setup.
.PARAMETER SkipPowerShell7
Don't attempt to upgrade PowerShell (stay on 5.x).
.PARAMETER ScriptsDir
Directory containing your helper PS1 scripts. Defaults to the same folder as this script.
.EXAMPLE
.\Start-AITerminalKickstart.ps1
# Interactive menu - pick what you want
.EXAMPLE
.\Start-AITerminalKickstart.ps1 -AutoMode
# Install everything, no prompts (except API keys)
.NOTES
Author : Endpoint Security / AI Terminal ops
Date : 2026-03-25
Tested : Windows Server 2022, Windows 10/11, PowerShell 5.1+
#>
[CmdletBinding()]
param(
[switch]$AutoMode,
[switch]$SkipPowerShell7,
[string]$ScriptsDir = ""
)
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
# CONFIGURATION
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
$ErrorActionPreference = 'Continue'
Set-StrictMode -Version Latest
if (-not $ScriptsDir) {
$ScriptsDir = Split-Path -Parent $MyInvocation.MyCommand.Definition
if (-not $ScriptsDir) { $ScriptsDir = Get-Location }
}
$script:TempDir = Join-Path $env:TEMP "ai-kickstart-$(Get-Date -Format 'yyyyMMdd')"
$script:LogFile = Join-Path $script:TempDir "kickstart.log"
$script:Results = [System.Collections.ArrayList]::new()
$script:StartTime = Get-Date
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
# HELPER FUNCTIONS
# βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
function Write-Banner {
$banner = @"
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β β
β A I T E R M I N A L K I C K S T A R T β
β βββββββββββββββββββββββββββββββββββββββββ β
β One Script To Prep Them All β
β β
β Claude Code | ChatGPT CLI | GitHub Copilot CLI β
β β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
"@
Write-Host $banner -ForegroundColor Magenta
}
function Write-Section {
param([string]$Title)
$line = "=" * 65
Write-Host ""
Write-Host " $line" -ForegroundColor DarkCyan
Write-Host " $Title" -ForegroundColor Cyan
Write-Host " $line" -ForegroundColor DarkCyan
}
function Write-Step {
param([string]$Msg)
Write-Host "`n >> $Msg" -ForegroundColor Cyan
Add-Content -Path $script:LogFile -Value "[$(Get-Date -Format 'HH:mm:ss')] STEP: $Msg" -ErrorAction SilentlyContinue
}
function Write-OK {
param([string]$Msg)
Write-Host " [OK] $Msg" -ForegroundColor Green
Add-Content -Path $script:LogFile -Value "[$(Get-Date -Format 'HH:mm:ss')] OK: $Msg" -ErrorAction SilentlyContinue
}
function Write-Warn {
param([string]$Msg)
Write-Host " [WARN] $Msg" -ForegroundColor Yellow
Add-Content -Path $script:LogFile -Value "[$(Get-Date -Format 'HH:mm:ss')] WARN: $Msg" -ErrorAction SilentlyContinue
}
function Write-Fail {
param([string]$Msg)
Write-Host " [FAIL] $Msg" -ForegroundColor Red
Add-Content -Path $script:LogFile -Value "[$(Get-Date -Format 'HH:mm:ss')] FAIL: $Msg" -ErrorAction SilentlyContinue
}
function Write-Info {
param([string]$Msg)
Write-Host " $Msg" -ForegroundColor Gray
}
function Write-Tip {
param([string]$Msg)
Write-Host " [TIP] $Msg" -ForegroundColor DarkYellow
}
function Add-Result {
param([string]$Component, [string]$Status, [string]$Detail = "")
[void]$script:Results.Add([PSCustomObject]@{
Component = $Component
Status = $Status
Detail = $Detail
Time = Get-Date -Format 'HH:mm:ss'
})
}
function Test-CmdExists {
param([string]$Name)
$null -ne (Get-Command $Name -ErrorAction SilentlyContinue)
}
function Refresh-Path {
# Rebuild from registry but PRESERVE any paths added during this session
$machine = [Environment]::GetEnvironmentVariable('Path', 'Machine')
$user = [Environment]::GetEnvironmentVariable('Path', 'User')
$basePath = "$machine;$user"
# Preserve session-added paths that aren't in the registry yet
$currentParts = $env:Path -split ';' | Where-Object { $_ -ne '' }
$baseParts = $basePath -split ';' | Where-Object { $_ -ne '' }
$sessionOnly = $currentParts | Where-Object { $_ -notin $baseParts }
$env:Path = $basePath
foreach ($sp in $sessionOnly) {
if ($env:Path -notlike "*$sp*") { $env:Path += ";$sp" }
}
# Also add common tool paths that might not be registered yet
$extras = @(
"$env:ProgramFiles\Git\cmd",
"$env:ProgramFiles\Git\bin",
"$env:ProgramFiles\nodejs",
"$env:USERPROFILE\.local\bin",
"$env:USERPROFILE\.cargo\bin",
"$env:APPDATA\npm",
"$env:LOCALAPPDATA\Programs\Python\Python312",
"$env:LOCALAPPDATA\Programs\Python\Python312\Scripts",
"$env:LOCALAPPDATA\Programs\Python\Python313",
"$env:LOCALAPPDATA\Programs\Python\Python313\Scripts"
)
foreach ($p in $extras) {
if ((Test-Path $p) -and $env:Path -notlike "*$p*") {
$env:Path += ";$p"
}
}
}
function Test-IsAdmin {
([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()
).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
}
function Show-Progress {
param(
[string]$Activity,
[string]$Status,
[int]$Step,
[int]$TotalSteps
)
$pct = [math]::Round(($Step / $TotalSteps) * 100)
$barLen = 30
$filled = [math]::Round($barLen * $Step / $TotalSteps)
$empty = $barLen - $filled
$bar = "$([char]0x2588)" * $filled + "$([char]0x2591)" * $empty
Write-Host "`r [$bar] $pct% - $Status " -NoNewline -ForegroundColor Cyan
Write-Progress -Activity $Activity -Status "$Status ($pct%)" -PercentComplete $pct
}
function Complete-Progress {
param([string]$Activity)
Write-Progress -Activity $Activity -Completed
Write-Host "" # newline after progress bar
}
function Invoke-Download {
# Download with progress display, retry on failure
param(
[string]$Uri,
[string]$OutFile,
[string]$Description = "Downloading",
[int]$MaxRetries = 2
)
$attempt = 0
while ($attempt -le $MaxRetries) {
try {
Write-Info "$Description (attempt $($attempt + 1))..."
$ProgressPreference = 'SilentlyContinue' # Invoke-WebRequest's built-in progress is slow
Invoke-WebRequest -Uri $Uri -OutFile $OutFile -UseBasicParsing -TimeoutSec 120
$ProgressPreference = 'Continue'
$sizeKB = [math]::Round((Get-Item $OutFile).Length / 1KB)
Write-OK "$Description complete (${sizeKB} KB)"
return $true
}
catch {
$attempt++
if ($attempt -gt $MaxRetries) {
Write-Fail "$Description failed after $($MaxRetries + 1) attempts: $_"
return $false
}
Write-Warn "Download failed, retrying in 3 seconds... ($_)"
Start-Sleep -Seconds 3
}
}
return $false
}
# Version-flexible package names (auto-detect latest where possible)
$script:PythonVersion = "3.12" # Change this single value to update Python target
$script:PythonWingetId = "Python.Python.$($script:PythonVersion)"
$script:PythonChocoId = "python$($script:PythonVersion -replace '\.','')"
$script:NodeMajor = "22" # Change this to update Node.js LTS target
# Phase tracking for progress bar
$script:TotalPhases = 6
$script:CurrentPhase = 0
function Enter-Phase {
param([string]$Name)
$script:CurrentPhase++
Show-Progress -Activity "AI Terminal Kickstart" -Status "Phase $($script:CurrentPhase)/$($script:TotalPhases): $Name" -Step $script:CurrentPhase -TotalSteps $script:TotalPhases
}
function Get-UserChoice {
param(
[string]$Prompt,
[string[]]$Options,
[int]$Default = 0
)
if ($AutoMode) { return $Default }
Write-Host ""
for ($i = 0; $i -lt $Options.Count; $i++) {
$marker = if ($i -eq $Default) { "*" } else { " " }
$color = if ($i -eq $Default) { "White" } else { "Gray" }
Write-Host " [$($i+1)]$marker $($Options[$i])" -ForegroundColor $color
}
Write-Host ""
Write-Host " $Prompt [$($Default+1)]: " -NoNewline -ForegroundColor Yellow
$input = Read-Host
if ($input -match '^\d+
### Windows (PowerShell, as Administrator)
```powershell
# One-time: allow the current session to run scripts
Set-ExecutionPolicy Bypass -Scope Process -Force
# Install Chocolatey (Windows package manager)
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
# Install runtimes + utilities
choco install -y git nodejs-lts python312 ripgrep jq fd 7zip imagemagick pwsh
# Verify
node --version ; npm --version ; python --version ; git --version
```
### Linux (Bash, Ubuntu / Debian / Mint)
```bash
# Update + install runtimes + utilities
sudo apt update
sudo apt install -y git curl build-essential python3 python3-pip python3-venv ripgrep jq fd-find imagemagick
# Install Node.js LTS via NodeSource (the apt package is usually out of date)
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs
# Verify
node --version ; npm --version ; python3 --version ; git --version
```
### Linux (Bash, Fedora / RHEL / Rocky)
```bash
sudo dnf install -y git curl python3 python3-pip ripgrep jq fd-find ImageMagick
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo dnf install -y nodejs
```
> Close the terminal and open a **new one** after runtime installs. PATH updates only take effect in fresh sessions.
## Step 2 β Install Claude Code
Anthropic's AI coding terminal. Reads your repo, edits files, runs commands, opens PRs.
### Windows (PowerShell)
```powershell
# Official installer (puts 'claude' on your PATH)
irm https://claude.ai/install.ps1 | iex
```
### Linux (Bash)
```bash
curl -fsSL https://claude.ai/install.sh | sh
```
Both platforms verify:
```bash
claude --version
```
**Authenticate once** by just running `claude` in any directory, it opens a browser to claude.ai, you click Authorize, and you're done. No API key needed for the browser flow. If you prefer an API key (required for CI):
```powershell
# Windows (persists across sessions):
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-your-key-here", "User")
```
```bash
# Linux:
echo 'export ANTHROPIC_API_KEY="sk-ant-your-key-here"' >> ~/.bashrc
source ~/.bashrc
```
Get an API key at [console.anthropic.com/settings/keys](https://console.anthropic.com/settings/keys).
## Step 3 β Install OpenAI Codex / ChatGPT CLI
The official OpenAI CLI for coding (Codex) and a quick ChatGPT terminal for one-shot questions.
### Both platforms
```bash
# Official OpenAI Codex CLI (Node-based)
npm install -g @openai/codex
# Verify
codex --version
```
For a lightweight ChatGPT streaming terminal (python-based alternative):
```bash
pip install chatgpt-cli
# One-shot
chatgpt "explain rsync incremental backups in one paragraph"
# Interactive
chatgpt
```
**Authenticate** by setting your OpenAI key. Get one at [platform.openai.com/api-keys](https://platform.openai.com/api-keys) (requires a paid account, $5 prepaid is enough).
```powershell
# Windows
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-your-key-here", "User")
```
```bash
# Linux
echo 'export OPENAI_API_KEY="sk-your-key-here"' >> ~/.bashrc
source ~/.bashrc
```
## Step 4 β Install GitHub Copilot CLI
Copilot CLI lives inside the `gh` (GitHub) CLI as an extension.
### Windows (PowerShell)
```powershell
choco install -y gh
gh auth login # web browser flow β select GitHub.com + browser
gh extension install github/gh-copilot
```
### Linux (Bash, Ubuntu / Debian / Mint)
```bash
# Add GitHub CLI apt repo
type -p curl >/dev/null || sudo apt install -y curl
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update
sudo apt install -y gh
gh auth login # choose GitHub.com β web browser β paste one-time code
gh extension install github/gh-copilot
```
### Linux (Bash, Fedora / RHEL)
```bash
sudo dnf install -y 'dnf-command(config-manager)'
sudo dnf config-manager --add-repo https://cli.github.com/packages/rpm/gh-cli.repo
sudo dnf install -y gh
gh auth login
gh extension install github/gh-copilot
```
Verify:
```bash
gh copilot suggest "find all PNG files larger than 1MB in current directory"
gh copilot explain "tar -xzf archive.tar.gz -C /opt/"
```
Copilot CLI requires a **Copilot subscription** ($10/month individual, free for students / verified OSS maintainers).
## Step 5 β Install Netlify CLI
For deploying sites directly from the terminal after Claude / Codex writes them.
### Both platforms
```bash
npm install -g netlify-cli
netlify --version
netlify login # browser opens β Authorize β back to terminal
```
Verify auth:
```bash
netlify status
```
## Step 6 β Install Python AI SDKs (optional but useful)
For scripting against the APIs directly (no terminal UI).
```bash
# Both platforms β use pip (Linux may need python3 -m pip)
pip install anthropic openai google-generativeai fastmcp mcp requests httpx pandas
```
## Step 7 β Your first session
From your project directory:
```bash
cd ~/my-website # or: cd $env:USERPROFILE\my-website on Windows
claude
```
Then at the Claude prompt:
```text
> give me a summary of this project
> add a dark-mode toggle to the header, commit, and show me the diff
> deploy a draft to Netlify so I can preview it
```
Claude reads your files, edits them, runs commands, and reports back. When the draft looks right:
```text
> deploy to production
```
## One-shot mode (any of the three CLIs)
For quick answers without entering a session:
```bash
claude "explain what package.json does in this repo"
codex "write a bash script that rotates log files older than 14 days"
chatgpt "what's the difference between sync and async in Node.js?"
gh copilot suggest "rebase my feature branch on main without merge commits"
```
## Common gotchas
- **`command not found` after install.** Close and reopen your terminal. PATH changes only take effect in new sessions.
- **`Execution policy` error on Windows.** `Set-ExecutionPolicy Bypass -Scope Process -Force` then re-run.
- **`Permission denied` on Linux scripts.** `chmod +x ./script.sh` then rerun.
- **Netlify deploy shows wrong files.** Specify the directory explicitly: `netlify deploy --dir=_site --prod`.
- **`claude` says API key missing.** Either run `claude` with no args (triggers browser OAuth) or `echo $ANTHROPIC_API_KEY` to confirm it's set.
- **OpenAI `insufficient_quota` error.** The API tier is separate from ChatGPT Plus, prepay $5 at [platform.openai.com/account/billing](https://platform.openai.com/account/billing).
- **Copilot CLI says "no subscription."** A GitHub Pro / Team / Enterprise account doesn't include Copilot, you need the $10/mo Copilot plan or be in the free student/OSS program.
## Cheat sheet β the commands you'll use daily
```bash
# Start AI sessions
claude # Claude Code interactive
claude "one-shot prompt" # Quick Claude query
codex # OpenAI Codex interactive
chatgpt # ChatGPT streaming terminal
gh copilot suggest "β¦" # Shell command suggestion
# Inside Claude Code
/help # slash commands
/clear # reset conversation
/mcp list # show connected services
Esc # exit
# Git (used constantly)
git status ; git diff ; git add . ; git commit -m "msg"
# Deploy
netlify deploy # preview URL
netlify deploy --prod # live
netlify deploy --dir=_site --prod # for SSG builds (Eleventy etc.)
```
## Optional β connect Claude to Google Drive, Slack, GitHub via MCP
MCP (Model Context Protocol) servers let Claude read external apps from inside the terminal.
```bash
# Google Drive
claude mcp add gdrive -- npx @anthropic/gdrive-mcp
# Slack
claude mcp add slack -- npx @anthropic/slack-mcp
# GitHub (enhanced β reads issues, PRs, etc.)
claude mcp add github -- npx @anthropic/github-mcp
# Playwright (browser automation β screenshots, form-filling)
claude mcp add playwright -- npx @playwright/mcp@latest
# List / remove
claude mcp list
claude mcp remove gdrive
```
First run of each MCP prompts for OAuth. The tokens live locally; nothing is sent to Anthropic or OpenAI outside the normal API calls.
## Why the terminal wins over the web UI
The 30-second argument: **your code lives on the filesystem; your git history lives in the terminal; your builds run in the terminal; your deploys happen from the terminal.** The web GUI makes you *leave* where the work happens, describe your problem in isolation, receive a response in isolation, then manually carry that response back to where the work happens. The terminal eliminates the round trip entirely.
On a 50-file refactor, the terminal approach takes 2 minutes. The GUI approach takes 45 minutes of copy-paste-switch-paste-switch-paste.
### Side-by-side on one concrete task
**Task:** *"Add a dark mode toggle to my website."*
**Web GUI (ChatGPT / Claude.ai):**
1. Open browser β claude.ai (8s)
2. "add dark mode toggle" β AI asks for HTML β open file explorer, find `index.html`, copy β paste in browser
3. AI asks for CSS β repeat for `styles.css`
4. AI returns three code blocks β copy HTML β switch to editor β find insertion point β paste
5. Copy CSS β find insertion point β paste
6. Copy JS β create `toggle.js` β paste β add `