GrepAI 安装指南：macOS/Linux/Windows 全平台安装、升级与验证教程

grepai-installation by yoanbernabeu/grepai-skills

240 周安装量

15 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/yoanbernabeu/grepai-skills --skill grepai-installation

AI/机器学习开发命令行工具

🇨🇳中文介绍

GrepAI 安装指南

本技能涵盖在所有平台上安装 GrepAI 的各种方法。

何时使用此技能

首次安装 GrepAI
升级现有的 GrepAI 安装
从源代码构建 GrepAI
验证安装是否成功

先决条件

macOS/Linux: 终端访问权限
Windows: PowerShell
从源代码安装: 已安装 Go 1.24+

安装方法

方法 1：Homebrew (macOS - 推荐)

在 macOS 上最简单的安装方式：

# 添加 tap 并安装
brew install yoanbernabeu/tap/grepai

# 验证安装
grepai version

优势：

使用 brew upgrade grepai 自动更新
使用 brew uninstall grepai 干净卸载
自动管理依赖项

方法 2：Shell 脚本 (Linux/macOS)

通用安装脚本：

# 下载并运行安装程序
curl -sSL https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.sh | sh

# 验证安装
grepai version

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

方法 3：PowerShell (Windows)

原生的 Windows 安装方式：

# 在 PowerShell 中运行（建议使用管理员权限）
irm https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.ps1 | iex

# 验证安装
grepai version

注意： 您可能需要调整执行策略：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

方法 4：从源代码构建

适用于开发者或自定义构建：

# 克隆仓库
git clone https://github.com/yoanbernabeu/grepai.git
cd grepai

# 构建二进制文件
make build

# 全局安装
sudo mv ./bin/grepai /usr/local/bin/

# 验证安装
grepai version

Go 1.24 或更高版本
Make（可选，可以直接使用 go build）

安装完成后，验证一切是否正常：

# 检查版本
grepai version
# 输出：grepai version 0.24.0

# 检查可用命令
grepai --help

grepai update --check

# 自动更新（下载并安装最新版本）
grepai update

# 或通过 Homebrew
brew upgrade grepai

brew uninstall grepai

# 删除二进制文件
sudo rm /usr/local/bin/grepai

# 可选：删除配置目录
rm -rf ~/.grepai

安装 Ollama 用于本地嵌入（参见 grepai-ollama-setup 技能）
初始化项目：使用 grepai init
开始索引：使用 grepai watch

❌ 问题： command not found: grepai ✅ 解决方案： 确保 /usr/local/bin 在您的 PATH 环境变量中：

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

❌ 问题： 安装时权限被拒绝 ✅ 解决方案： 对安装命令使用 sudo 或安装到用户目录

❌ 问题： Homebrew tap 未找到 ✅ 解决方案： 先添加 tap：

brew tap yoanbernabeu/tap
brew install grepai

✅ GrepAI 安装成功
   版本：0.24.0
   位置：/usr/local/bin/grepai

后续步骤：
1. 安装 Ollama：brew install ollama
2. 初始化项目：grepai init
3. 开始索引：grepai watch

🇺🇸English

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:

Detects your OS and architecture
Downloads the appropriate binary
Installs to /usr/local/bin/
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:

Install Ollama for local embeddings (see grepai-ollama-setup skill)
Initialize a project with grepai init
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

Weekly Installs

240

Repository

yoanbernabeu/gr…i-skills

GitHub Stars

First Seen

Jan 28, 2026

Security Audits

Gen Agent Trust HubFail SocketPass SnykFail

Installed on

opencode191

codex187

gemini-cli170

github-copilot170

kimi-cli159

amp157

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

106,200 周安装

GrepAI 安装指南：macOS/Linux/Windows 全平台安装、升级与验证教程

🇨🇳中文介绍

GrepAI 安装指南

何时使用此技能

先决条件

安装方法

方法 1：Homebrew (macOS - 推荐)

方法 2：Shell 脚本 (Linux/macOS)

相关 Skills

方法 3：PowerShell (Windows)

方法 4：从源代码构建

验证安装

更新 GrepAI

检查更新

执行更新

卸载

Homebrew

手动卸载

后续步骤

常见安装问题

输出格式

🇺🇸English

GrepAI Installation

When to Use This Skill

Prerequisites

Installation Methods

Method 1: Homebrew (macOS - Recommended)

Method 2: Shell Script (Linux/macOS)

Method 3: PowerShell (Windows)

Method 4: Build from Source

Verifying Installation

Updating GrepAI

Check for Updates

Perform Update

Uninstalling

Homebrew

Manual

Next Steps

Common Installation Issues

Output Format

最新 Skills