dataform-compile-local

A “dataform-compile-local” tool runs the dataform compile CLI command on a local project directory.

About

A dataform-compile-local tool runs the dataform compile command on a local Dataform project.

It is a standalone tool and is not compatible with any sources.

At invocation time, the tool executes dataform compile --json in the specified project directory and returns the resulting JSON object from the CLI.

dataform-compile-local takes the following parameter:

project_dir (string): The absolute or relative path to the local Dataform project directory. The server process must have read access to this path.

Requirements

Dataform CLI

This tool executes the dataform command-line interface (CLI) via a system call. You must have the dataform CLI installed and available in the server’s system PATH.

You can typically install the CLI via npm:

npm install -g @dataform/cli

See the official Dataform documentation for more details.

Example

tools:  
  my_dataform_compiler:  
    kind: dataform-compile-local  
    description: Use this tool to compile a local Dataform project.

Reference

field	type	required	description
kind	string	true	Must be “dataform-compile-local”.
description	string	true	Description of the tool that is passed to the LLM.

Last modified October 1, 2025: feat(tools/dataform): add dataform compile tool (#1470) (3be9b7b3bd)