Remote Execution#

actrun supports running graphs without a local installation.

Quick Start#

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

How It Works#

The actrun.sh script performs the following steps:

1. Detects your platform — OS (Linux, macOS, Windows) and architecture (x64, arm64).
2. Fetches the latest version — Queries the Actionforge API for the latest stable release.
3. Caches the binary — Downloads and extracts the actrun binary to ~/.cache/actrun/. Subsequent runs skip the download.
4. Executes your graph — Passes all arguments to the cached binary.

Running a Local Graph#

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

Running a Shared Graph#

Shared graphs are hosted on Actionforge and can be run directly by URL. The URL format is:

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

When a shared URL is detected, the script fetches the graph content from the Actionforge API and passes it to actrun as a temporary file.

Note: You can also pass shared graph URLs directly to actrun if you have it installed locally:

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

Passing Flags#

Arguments after the graph file (or URL) are passed directly to the graph as inputs.

# Pass flags to the graph
curl -fsSL https://www.actionforge.dev/actrun.sh | bash -s -- my_graph.act --my-flag=test --count=5

# Pass actrun flags before the graph file
curl -fsSL https://www.actionforge.dev/actrun.sh | bash -s -- --env-file=.env my_graph.act --my-flag=test

Note: The bash -s -- portion is required. bash -s reads the script from stdin, and -- separates bash's own options from the arguments passed to the script.

Supported Platforms#

Caching#

The binary is cached at ~/.cache/actrun/<version>/actrun. When a new version is released, the script downloads it automatically. Previous versions are not removed.

Source Code#

The bootstrap script is available at github.com/actionforge/actrun-cli/blob/main/actrun.sh .