---name: grepai-installationdescription: Multi-platform installation guide for GrepAI. Use this skill when installing GrepAI on macOS, Linux, or Windows.---

GrepAI Installation

This skill covers all methods to install GrepAI on any platform.

When to Use This Skill

• Installing GrepAI for the first time
• Upgrading an existing GrepAI installation
• Building GrepAI from source
• Verifying a successful installation

Prerequisites

• macOS/Linux: Terminal access
• Windows: PowerShell
• From source: Go 1.24+ installed

Installation Methods

Method 1: Homebrew (macOS - Recommended)

The easiest way to install on macOS:

# Add the tap and install
brew install yoanbernabeu/tap/grepai

# Verify installation
grepai version

Advantages:

• Automatic updates with brew upgrade grepai
• Clean uninstall with brew uninstall grepai
• Manages dependencies automatically

Method 2: Shell Script (Linux/macOS)

Universal installation script:

# Download and run the installer
curl -sSL https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.sh | sh

# Verify installation
grepai version

What the script does:

1. Detects your OS and architecture
2. Downloads the appropriate binary
3. Installs to /usr/local/bin/
4. Sets executable permissions

Method 3: PowerShell (Windows)

Native Windows installation:

# Run in PowerShell (Admin recommended)
irm https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.ps1 | iex

# Verify installation
grepai version

Note: You may need to adjust execution policy:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Method 4: Build from Source

For developers or custom builds:

# Clone the repository
git clone https://github.com/yoanbernabeu/grepai.git
cd grepai

# Build the binary
make build

# Install globally
sudo mv ./bin/grepai /usr/local/bin/

# Verify installation
grepai version

Requirements:

• Go 1.24 or later
• Make (optional, can use go build directly)

Verifying Installation

After installation, verify everything works:

# Check version
grepai version
# Output: grepai version 0.24.0

# Check available commands
grepai --help

Updating GrepAI

Check for Updates

grepai update --check

Perform Update

# Auto-update (downloads and installs latest)
grepai update

# Or via Homebrew
brew upgrade grepai

Uninstalling

Homebrew

brew uninstall grepai

Manual

# Remove binary
sudo rm /usr/local/bin/grepai

# Optionally remove config directories
rm -rf ~/.grepai

Next Steps

After installation:

1. Install Ollama for local embeddings (see grepai-ollama-setup skill)
2. Initialize a project with grepai init
3. Start indexing with grepai watch

Common Installation Issues

❌ Problem: command not found: grepai ✅ Solution: Ensure /usr/local/bin is in your PATH:

export PATH="$PATH:/usr/local/bin"

❌ Problem: Permission denied during installation ✅ Solution: Use sudo for the installation command or install to a user directory

❌ Problem: Homebrew tap not found ✅ Solution: Add the tap first:

brew tap yoanbernabeu/tap
brew install grepai

Output Format

After successful installation:

✅ GrepAI installed successfully
   Version: 0.24.0
   Location: /usr/local/bin/grepai

Next steps:
1. Install Ollama: brew install ollama
2. Initialize project: grepai init
3. Start indexing: grepai watch