grepai-installation

name	grepai-installation
description	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