Skip to content

deltaforge-cli

Single binary for scripting queries, running SQL files, executing pipelines, and checking cluster health from any terminal or CI environment.

Signed binaries for every platform: deltaforge-org/delta-forge on GitHub

Install

curl -fsSL https://deltaforge.org/install.sh | sh -s -- --pkg deltaforge-cli

Or via Homebrew (add the DeltaForge tap once, then install deltaforge-cli as a formula):

# Add the tap (one-time)
brew tap deltaforge-org/tap
brew install deltaforge-cli

Tap source: github.com/deltaforge-org/homebrew-tap

PowerShell
iwr -useb https://deltaforge.org/install.ps1 | iex; Install-DeltaForge -Pkg deltaforge-cli

Or via winget (installs the signed binary into your PATH) or Scoop (the preferred choice for portable, no-admin installs):

winget
winget install DeltaForge.CLI
Scoop
# Add the bucket (one-time)
scoop bucket add deltaforge https://github.com/deltaforge-org/scoop-bucket
scoop install deltaforge-cli

Detects your architecture (x64 or ARM64), downloads the matching tarball, and drops the binary on your PATH:

curl -fsSL https://deltaforge.org/install.sh | sh -s -- --pkg deltaforge-cli

Or manually:

# Substitute the latest version from the releases page
curl -fsSL https://github.com/deltaforge-org/delta-forge/releases/download/v1.0.0/deltaforge-cli-1.0.0-linux-x64.tar.gz \
  | sudo tar -xz -C /usr/local/bin

Common commands

A few things you can do from the terminal once the binary is on your PATH.

Run a SQL file

Execute any SQL script against a DeltaForge workspace and stream results to your terminal.

deltaforge-cli run query.sql

Execute a pipeline

Trigger a numbered pipeline script and watch step-by-step progress in the terminal.

deltaforge-cli pipeline run --file pipeline.sql

Health check

Check the reachability and version of every registered compute node in a workspace.

deltaforge-cli status

Looking for the desktop app, MCP server, or compute node? See the install hub.

Got it installed. What now?

Register a workspace in the console, point it at a Git repo with SQL in it, and run your first query.