リモート実行

actrun は、ローカルにインストールしなくても graph を実行できます。

クイックスタート

curl -fsSL https://www.actionforge.dev/actrun.sh | bash -s -- <file-or-url> [options]

仕組み

actrun.sh スクリプトは以下のステップを実行します:

1. プラットフォームを検出 — OS（Linux、macOS、Windows）とアーキテクチャ（x64、arm64）を検出します。
2. 最新バージョンを取得 — Actionforge API から最新の安定版リリースを問い合わせます。
3. バイナリをキャッシュ — actrun バイナリを ~/.cache/actrun/ にダウンロードして展開します。以降の実行ではダウンロードをスキップします。
4. graph を実行 — すべての引数をキャッシュされたバイナリに渡します。

ローカル Graph の実行

curl -fsSL https://www.actionforge.dev/actrun.sh | bash -s -- my_graph.act

共有 Graph の実行

共有 graph は Actionforge 上にホストされており、URL から直接実行できます。URL の形式は以下の通りです:

https://app.actionforge.dev/shared/<id>.act

curl -fsSL https://www.actionforge.dev/actrun.sh | bash -s -- https://app.actionforge.dev/shared/divine-fog-f9cc9408.act

共有 URL が検出されると、スクリプトは Actionforge API から graph のコンテンツを取得し、一時ファイルとして actrun に渡します。

注意: ローカルに actrun がインストールされている場合は、共有 graph の URL を直接 actrun に渡すこともできます:

actrun https://app.actionforge.dev/shared/divine-fog-f9cc9408.act

Flag の受け渡し

graph ファイル（または URL）の後の引数は、graph の input として直接渡されます。

# graph に flag を渡す
curl -fsSL https://www.actionforge.dev/actrun.sh | bash -s -- my_graph.act --my-flag=test --count=5

# actrun の flag は graph ファイルの前に配置する
curl -fsSL https://www.actionforge.dev/actrun.sh | bash -s -- --env-file=.env my_graph.act --my-flag=test

注意: bash -s -- の部分は必須です。bash -s は標準入力からスクリプトを読み込み、-- は bash 自体のオプションとスクリプトに渡される引数を区切ります。

サポートされるプラットフォーム

OS	アーキテクチャ	パッケージ形式
Linux	x64, arm64	.tar.gz
macOS	x64, arm64	.pkg
Windows (MINGW/MSYS/Cygwin)	x64, arm64	.zip

キャッシュ

バイナリは ~/.cache/actrun/<version>/actrun にキャッシュされます。新しいバージョンがリリースされると、スクリプトは自動的にダウンロードします。以前のバージョンは削除されません。

ソースコード

ブートストラップスクリプトは github.com/actionforge/actrun-cli/blob/main/actrun.sh で公開されています。