grepai-installation

GrepAI のインストール

このスキルでは、あらゆるプラットフォームで GrepAI をインストールするすべての方法を説明します。

このスキルを使用するタイミング

• GrepAI を初めてインストールする場合
• 既存の GrepAI のインストールをアップグレードする場合
• GrepAI をソースからビルドする場合
• インストールが正常に完了したことを確認する場合

前提条件

• macOS/Linux： ターミナルへのアクセス
• Windows： PowerShell
• ソースからのビルド： Go 1.24+ のインストール

インストール方法

方法 1：Homebrew（macOS - 推奨）

macOS にインストールする最も簡単な方法です：

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

# Verify installation
grepai version

メリット：

• brew upgrade grepai で自動的にアップデートできます
• brew uninstall grepai でクリーンにアンインストールできます
• 依存関係が自動的に管理されます

方法 2：シェルスクリプト（Linux/macOS）

汎用インストールスクリプト：

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

# Verify installation
grepai version

スクリプトの処理内容：

1. OS とアーキテクチャを検出します
2. 適切なバイナリをダウンロードします
3. /usr/local/bin/ にインストールします
4. 実行権限を設定します

方法 3：PowerShell（Windows）

Windows ネイティブのインストール：

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

# Verify installation
grepai version

注： 実行ポリシーの変更が必要になる場合があります：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

方法 4：ソースからビルド

開発者向け、またはカスタムビルド向け：

# 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

必要なもの：

• Go 1.24 以降
• Make（任意。go build を直接使用することもできます）

インストールの確認

インストール後、すべて正常に動作することを確認します：

# Check version
grepai version
# Output: grepai version 0.24.0

# Check available commands
grepai --help

GrepAI のアップデート

アップデートを確認する

grepai update --check

アップデートを実行する

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

# Or via Homebrew
brew upgrade grepai

アンインストール

Homebrew

brew uninstall grepai

手動

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

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

次の手順

インストール後：

1. ローカル埋め込み用に Ollama をインストールします（grepai-ollama-setup スキルを参照）
2. grepai init で プロジェクトを初期化します
3. 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 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