grepai-installation

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

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:

Note: You may need to adjust execution policy:

Method 4: Build from Source

For developers or custom builds:

Requirements:

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

Verifying Installation

After installation, verify everything works:

Updating GrepAI

Check for Updates

Perform Update

Uninstalling

Homebrew

Manual

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:

❌ 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:

Output Format

After successful installation: