glac コマンドライン

glac は SDK と同じ API を呼び出します。コマンドはプラットフォームと同じく製品ごとにまとめられ（glac cube …、glac sandboxes …、glac drives …）、プロジェクトとアカウントは最上位にあります。ターミナルで作業する人、CI のスクリプト、コーディングエージェントという 3 種類のユーザーのために作られています。そのため、次のように動作します。

• デフォルトでは、求められたものだけを表示します（ID、表、コマンド自体の出力）。どのコマンドも --json を受け付け、その場合は API が返したものを、エラーも含めてそのまま表示します。
• glac run、glac sandboxes exec、glac sandboxes shell は、サンドボックス内のコマンドの終了コードで終了します。コマンド以外による失敗は 125 です。
• エラー時は、API の message と code を stderr に出力します。
• 読むよう指示されていない入力を待つことはなく、削除するよう指示されていないものを削除することもありません。

インストール

glac は 1 つのファイル（macOS arm64 で 1.7 MB、Linux x86_64 で 2.3 MB）で、約 3 ミリ秒で起動します。次のコマンドでインストールします。

curl -fsSL https://glac.ai/install.sh | sh

設定

glac は GLAC_API_URL と GLAC_API_KEY（SDK と同じ 2 つ）を読み、次に glac login が書き込むファイル（~/.config/glac/config.json、モード 0600。$XDG_CONFIG_HOME と GLAC_CONFIG で場所を変更可能）を読みます。どちらもなければ https://api.glac.ai に接続します。

glac login --api-url https://api.glac.ai --api-key -     # reads the key from standard input

1 つのサンドボックス用のトークン（st_…）も、そのサンドボックスに対する exec、cp、shell、url ではキーとして使えます。HTTPS には glac に組み込まれた Mozilla のルート証明書を使い、SSL_CERT_FILE で独自の証明書を追加できます。リダイレクトはたどらないため、キーがほかの場所へ送られることはありません。

コマンド一覧

glac deploy IMAGE …              the same as glac cube deploy
glac run COMMAND …               the same as glac sandboxes run
glac install APP …               the same as glac installations create

glac cube       deploy | ls | get | update | rm | versions | rollback | upgrade | upgrades | logs | log-usage | log-delete | metrics
glac cube instances       create | ls | get | rm
glac cube instances ports ls | open | close
glac cube key-secrets     create | ls | get | rm
glac cube keys            sign
glac compose    up | config | down | ps | logs | restart
glac deploys    create | ls | get
glac sandboxes  run | create | ls | get | update | rm | sleep | restart | exec | ps | logs | kill
                | shell | cp | url | fork | restore | ssh
glac sandboxes snapshots  create | ls | get | rename | rm
glac sandboxes ssh-keys   add | ls | get | rm
glac sandboxes tokens     revoke
glac sandboxes ports      ls | open | close
glac browsers   create | ls | get | update | sleep | rotate-url | live | save-profile | profiles ls | profiles rm | rm
glac drives     create | ls | get | rename | rm | attach | detach | fork | restore
glac drives snapshots     create | ls | get | rm
glac volumes    create | ls | get | rm | attach | detach
glac backups    ls | create | get | rm | restore
glac domains    create | ls | get | update | rm
glac db         create | ls | get | update | rm | sleep | wake | restore | roles | reset-password
glac db branches          ls | get | create | rm
glac catalogue  ls | get
glac installations  create | ls | get | update | rm

glac project · glac variables put | ls | rm · glac secrets put | hosts | ls | rm · glac events · glac audit
glac webhooks   create | ls | get | update | rm
glac keys       create | ls | get | rm
glac destinations   create | ls | get | update | test | rm
glac limits · glac limits request | requests
glac usage · glac account … · glac billing … · glac login · glac logout · glac version

どのグループも単数形で呼べます（glac sandbox、glac browser、glac drive、glac volume、glac backup、glac secret、glac variable、glac domain、glac database、glac installation、glac db branch、glac cube instance、glac sandboxes snapshot、glac sandboxes ssh-key、glac sandboxes token、glac sandboxes port、glac drives snapshot）。glac workers は glac cube と、glac sbx は glac sandboxes と同じで、たとえば glac sbx exec web ls は glac sandboxes exec web ls です。glac help はすべてのコマンドを製品ごとに一覧表示し、glac help sandboxes は 1 つのグループのコマンドを、glac help sandboxes exec は 1 つのコマンドが受け付けるものを表示します。オプションと列には API の名前を使うため、そこではキューブは app です。アプリ、サンドボックス、スナップショット、ドライブ、ボリューム、SSH キーは ID か名前で、アプリのバージョンは番号か ID で、ドライブのスナップショット（dsnap-…）とバックアップ（bak-…）は ID で指定します。

キューブ

キューブは、イメージをサービス（キューブ）として実行します。API ではこれをアプリと呼びます。glac workers …（または glac worker …）は glac cube … の別名です。

サンドボックス

コマンドの書き方：引数が 1 つなら sh -c に渡す 1 行（glac sandboxes exec web 'ls | wc -l'）、複数ならプログラムとその引数で、そのまま実行されます。ターミナルでない標準入力は glac sandboxes exec に渡され（tar c . | glac sbx exec web tar x -C /srv）、--no-stdin で止められます。最初の Ctrl-C はコマンドに送られ、2 回目でコマンドを動かしたまま抜けます。コマンドは接続ではなくサンドボックスに属するため、glac sandboxes exec と glac sandboxes logs --follow は、接続が切れても中断したところから再開します。

コマンドの出力は最後の 16 MiB だけが保持され、コマンドが遅い読み手を待つことはありません。glac sandboxes exec は出力の一部を取りこぼすと、欠けた出力を渡すのではなく、どれだけ取りこぼしたかを示して 125 で終了します。大きな出力はファイルに書き出し、glac sandboxes cp で取り出してください。

ドライブ

ドライブは、使用するサンドボックスより長く残るプロジェクトのディスクです。一度に 1 つのサンドボックスが読み書き可能な状態で持ち、中身は次のサンドボックスのために残ります。次のサンドボックスは同じリージョンのもの、またはマシンがドライブのホームのオブジェクトストアを読める別のリージョンのものです（下記の glac drives home）。書き込まれるそばからリージョンのオブジェクトストアにコピーされるため、別のノード上のサンドボックスもマウントできます。課金されるのは書き込まれたものだけです。ドライブはコントロールプレーンの機能で、単独で動くノードに対して glac drives … を実行するとノードの 404（終了コード 4）が返り、そのノードのディスクはボリュームであると表示されます。

スナップショットは、ドライブのリージョンのどのマシン上でも、いくつのサンドボックスからでも同時に読み取り専用でマウントできます。ドライブを誰が持っていても、ドライブが削除された後でも同じです。新しいサンドボックスには glac sandboxes create --drive data:/snap:dsnap-…（そこでの --snapshot は続きを始めるサンドボックスのスナップショットを指すため、:ro が --volume に付くのと同じように、ドライブのスナップショットは --drive に付けます）、実行中のサンドボックスには glac drives attach data web:/snap --snapshot dsnap-… を使います。ゲストはスナップショットに書き込めず、スナップショットをマウントしたサンドボックスは別のマシンに移されません。アプリのバージョンがドライブをマウントするのは、読み書き可能な場合だけです。

課金：スナップショットは、単独で保持する量（exclusive_bytes）に対して、1 時間ごとに、ドライブのデータの料金（1 GB-月あたり $0.02）で課金されます。フォークはほかのドライブと同じく、used_bytes、つまり論理的な内容全体で課金されます。10 GB のスナップショットのフォークは、10 GB のドライブとして課金されます。読み取り専用のマウントを通じてサンドボックスが読むものに料金はかかりません。glac usage --drive data は 1 つのドライブが保持した量、書き込まれた量、キャッシュ外から読まれた量を、glac usage --snapshot dsnap-… は 1 つのスナップショットが保持した量を表示します。

ドメイン

ブラウザ

**未公開。**Glac のブラウザはまだ利用できません。以下は公開に先立つ、現時点でのコマンドラインです。

セッションは、Playwright、Puppeteer など任意の Chrome DevTools Protocol（CDP）クライアントから外部で操作する、Glac がホストする Chromium です。クライアントの接続中は稼働し、最後のクライアントが離れると数秒後に、ページを保持したままスリープします。

CDP=$(glac browsers create --name agent-42)
npx @playwright/mcp --cdp-endpoint "$CDP"        # or any CDP client

セッションは、ほかのインスタンスと同じく、使用したキューブのリソースで課金されます。処理している間の CPU、稼働中のメモリ、送信トラフィックです（料金とプラン）。glac usage は、セッションの使用量をそのサンドボックスと並べて表示します。

データベース

データベースはマネージド Postgres です。ドライブ上で動く専用の PostgreSQL で、何も要求がないときはスリープし、接続があればセッションを保ったまま復帰します。オーナーのパスワードは、作成とリセットに対する API のレスポンスにしか含まれず、どこにも保存されません。そのため create と reset-password はパスワード入りの接続文字列を表示し、ほかのコマンドは表示しません。

URI=$(glac db create shop)                                    # the owner's password is in it
glac sandboxes create --name client --project-network --image postgres:17-alpine
glac sandboxes exec client -- psql "$URI" -c 'select 1'       # on the project's network

現在、データベースには、プロジェクトのネットワーク上で、そのサンドボックス（--project-network）とサービスから名前でアクセスします。パブリックアドレスはプラットフォームの公開入口の提供とともに用意され、API がそれを返す場合、create は代わりにそれを表示します（--private なら、何があってもプロジェクトのネットワーク上のアドレスを表示）。--json は API のレスポンスをそのまま表示します。パスワードが含まれるのは、作成とリセットのレスポンスだけです。

マネージドアプリケーション

カタログのアプリケーション（たとえば Rivet）は、プロジェクトに専用のキューブのリソースとしてインストールされます。アプリ、ボリューム、シークレット、バケットで、インストールのラベルが付き、変更はインストールを通じてのみ行い、それぞれのリソースとして課金されます（マネージドアプリケーション）。

glac catalogue get rivet
glac install rivet --set disk_gib=20 --set size.vcpus=2

プロジェクト：シークレット、共有変数、イベント、監査ログ

アカウント、使用量、課金

課金、シークレット、ドメイン、キーの変更には、admin スコープを持つキーが必要です。

**すぐに受け取る購入（--start-now）。**欧州経済領域または英国の消費者（確認済み、または確認中の税番号を持たないアカウント）は、購入から 14 日以内であれば撤回でき、購入したものがすぐに提供されるのは、本人が明示的に求めた場合だけです。glac billing topup、glac billing plan（購入するプラン：無料プランからの変更、または上位への変更）、glac billing auto-reload on（自動チャージがオンの間のすべての自動チャージ）に付ける --start-now は、その要求を、コンソールのチェックボックスの横に表示される文言（GET /v1/billing/withdrawals の right.start_now にもあるもの）で伝えます。

撤回できる 14 日間のうちに、この購入をすぐに提供するよう求めます。撤回した場合は、それまでに提供された分を支払います。チャージのクレジットをすべて使った時点で全額が提供されたことになり、それ以降は撤回できなくなることを理解しています。

サービスはすぐに始まります。14 日以内なら購入者はまだ撤回でき、その場合はそれまでに提供された分を支払います。すべてが提供されると（チャージのクレジットをすべて使うと）、撤回する権利はなくなります。この要求は、購入する本人が求めたときだけ指定してください。glac は、指定されない限り決して送りません。指定がなければ、そのようなアカウントの購入は API の 400 start_now_required になり、何も購入されません。そのとき、標準入力と標準エラー出力がどちらもターミナルであれば、glac は文言とその意味を表示して Do you ask for this? [y/N] と尋ね、y か yes の場合に限り、同じ呼び出しを要求付きで送り直します（チャージなら新しい冪等キーで）。それ以外の場所（スクリプト、CI、コーディングエージェント）では、また --json を付けた場合は常に、何も尋ねません。API のエラーと終了コード 1 に加え、--start-now で何が伝わるかを示す 1 行を表示します。エージェントが人に代わって要求を伝えることは決してありません。それは本人が伝えるものです。要求なしで自動チャージをオンにしたアカウントでは何もチャージされず、月に 1 回通知されます（イベント auto_reload.no_request。glac events が文章で表示します）。

終了コード