クイックスタート

gg バイナリをインストールして、最初の図を 1 分以内にレンダリングできます。リモートスクリプトをシェルにパイプするのが気になる方は、手動のインストール方法を紹介したインストールを参照してください。

インストール

お使いの OS に合わせたコマンドを選んでください。どちらのスクリプトも自動で gg を PATH に追加します。

curl -fsSL https://bin.ideamans.com/install/gg.sh | bash

powershell

irm https://bin.ideamans.com/install/gg.ps1 | iex

gg --help

使い方のバナーが表示されれば成功です。gg: command not found と出る場合は、シェルを開き直す（更新後の PATH を読み込むため）か、インストールを参照してください。

1 行の .gg ソースを gg にパイプするだけで図が作れます。入力パスを - にすると gg は標準入力から読み取るので、; で文を区切ればワンライナーに収まります。

echo 'icon :u tabler/user "User"; icon :a tabler/server "API"; u --> a "request"' | gg -o hello.png - --width 1024

hello.png を hello.svg に変えれば（--width は省略）ベクター出力になります。--format svg --stdout でターミナルへ SVG を直接流し込むことも可能です。

powershell

'icon :u tabler/user "User"; icon :a tabler/server "API"; u --> a "request"' | gg -o hello.png - --width 1024

hello.png を画像ビューアで開くと、2 つのアイコンがラベル付きの矢印で繋がっているのが見えるはずです。これで CLI が動作していることが確認できました。