インストール

gg を最速でインストールする方法はクイックスタートで紹介したワンライナー — curl → bash のスクリプトが、プラットフォームに合ったバイナリをダウンロードして PATH に配置します。このページはそれ以外の手段 — インストールランディングページ、GitHub Releases、ソースからのビルド — をまとめたものです。

インストールランディングページ

インストールスクリプトは専用ページから配布しています：

https://bin.ideamans.com/oss/gg

TIP

ランディングページ自体は日本語ですが、インストールコマンドはロケールに依存せずどの環境でもそのまま動きます。

各プラットフォームごとに最新のバージョン付きスクリプトが公開されています：

プラットフォーム	コマンド
macOS / Linux	`curl -fsSL https://bin.ideamans.com/install/gg.sh \| bash`
Windows (PowerShell)	`irm https://bin.ideamans.com/install/gg.ps1 \| iex`

既定のインストール先：

Linux / macOS — システム共通のディレクトリ（通常は /usr/local/bin）。ユーザー単位にしたい場合は --install-dir $HOME/bin で上書き：
sh
```
curl -fsSL https://bin.ideamans.com/install/gg.sh | bash -s -- --install-dir "$HOME/bin"
```
Windows（管理者） — C:\Program Files\gg\gg.exe
Windows（一般ユーザー） — %USERPROFILE%\bin\gg.exe

カスタムディレクトリに入れた場合は PATH に追加されていることを確認してください。

GitHub Releases（手動ダウンロード）

タグ付きリリースごとにビルド済みアーカイブと checksums.txt が公開されます。ダウンロード → 検証 → バイナリを自分で配置する流れです。

https://github.com/ideamans/gridgram/releases/latest

プラットフォーム	アセット
Linux x64	`gridgram_<version>_linux_amd64.tar.gz`
Linux ARM64	`gridgram_<version>_linux_arm64.tar.gz`
macOS (Intel)	`gridgram_<version>_darwin_amd64.tar.gz`
macOS (Apple Silicon)	`gridgram_<version>_darwin_arm64.tar.gz`
Windows x64	`gridgram_<version>_windows_amd64.zip`

Linux / macOS

VERSION=0.1.0
OS=linux       # or darwin
ARCH=amd64     # or arm64

curl -fsSL -o gg.tar.gz \
  "https://github.com/ideamans/gridgram/releases/download/v${VERSION}/gridgram_${VERSION}_${OS}_${ARCH}.tar.gz"

tar -xzf gg.tar.gz
sudo mv "gridgram_${VERSION}_${OS}_${ARCH}/gg" /usr/local/bin/

Windows (PowerShell)

powershell

$Version = "0.1.0"
$Url = "https://github.com/ideamans/gridgram/releases/download/v$Version/gridgram_${Version}_windows_amd64.zip"

Invoke-WebRequest $Url -OutFile gg.zip
Expand-Archive gg.zip -DestinationPath .
# move gg.exe somewhere on your PATH, e.g. %USERPROFILE%\bin

チェックサムの検証

curl -fsSL -O "https://github.com/ideamans/gridgram/releases/download/v${VERSION}/checksums.txt"
sha256sum -c --ignore-missing checksums.txt

ソースからビルド

Gridgram は Bun でビルドします。Bun を入れたら：

git clone https://github.com/ideamans/gridgram
cd gridgram
bun install
bun run sync-tabler        # インストール後に必須（src/data/ を生成）
bun run compile            # リポジトリ直下に ./gg が生成される

コンパイルせずに動かす — CLI 自体をいじりたいときに便利：

bun run src/cli/gg.ts diagram.gg -o out.svg

アップグレード

クイックスタートのワンライナーを再実行するか、Releases から最新のアセットを取得してください。スクリプトはべき等で、既存バイナリをその場で置き換えます。

アンインストール

インストール先（/usr/local/bin/gg / $HOME/bin/gg / Windows のインストールディレクトリ）からバイナリを削除するだけです。インストーラが書き込むファイルはそれだけ。実行時には PNG 出力用に sharp のネイティブモジュールが ~/.cache/gridgram/ にキャッシュされるので、容量を空けたい場合はこのディレクトリも削除してください。

インストール ​