Buildfyio CLI

Install

npm i -g @fyio/buildfyio-cli   # binary: buildfy
buildfy login

Deploy

cd my-app
buildfy link                  # link this directory to a project
buildfy deploy                # production deploy of the current branch
buildfy deploy --preview      # preview deploy
buildfy deploy --branch dev   # deploy a specific branch

Logs

buildfy logs                                  # latest deployment, build stream
buildfy logs dpl_abc123 --stream deploy        # build | deploy | runtime

Why a build failed

Returns the failure reason, the diagnosis with a suggested fix, and only the error lines. Reach for this before buildfy logs — the raw log runs to thousands of lines and the root cause is rarely in the tail. With --json it is meant to be piped straight into an AI agent.

buildfy errors                                 # newest failed deployment
buildfy errors dpl_abc123                      # a specific one
buildfy errors --json                          # machine-readable, for agents and CI

Environment variables

buildfy env pull --env production --file .env.local
buildfy env pull --no-secrets                  # skip secret-marked values
buildfy env push --env preview --file .env.local

Wire up an AI agent

Registers Buildfyio as an MCP server in your agent and mints a scoped token for it.

buildfy mcp install claude-code      # or: claude-desktop | cursor | windsurf
buildfy mcp install cursor --scopes read,deploy

Self-hosted / custom API

Point the CLI at another Buildfyio API with BUILDFY_API_URL (defaults to https://api.buildfyio.com).