Padfile

A Padfile is a TOML file named Padfile (capital P) at the root of your project. It describes everything about the Pad you want to create: which Template to use, what repo to clone, what commands to run, which ports to expose, and which secrets and AI agents to attach.

The CLI sends the raw TOML to the backend. The server parses, validates, and enforces policy. The backend is the source of truth for Padfile semantics.

Minimal example

padfile_version = "1"

[template]
name = "pad/default"

Realistic example