The bdy command-line interface lets you interact with Buddy services directly from your terminal.
Use it to create secure tunnels, manage CI/CD agents, run tests, and more.
Getting Started
Install and set up the bdy command-line interface.
bdy
Work seamlessly with Buddy from the command line.
bdy tunnel
Start tunnels to local services and manage the tunnel configuration file
bdy agent
Install and run bdy as a background service on Windows, macOS and Linux that keeps tunnels up
bdy tests
Manage unit tests and visual regression (Storybook, URL captures, test runners)
bdy api
Call the Buddy REST API directly
bdy artifact
Manage artifacts: file, Docker and Composer packages with versions
bdy context
Manage connection and workspace/project contexts
bdy crawl
Crawl websites into Markdown, HTML and screenshots
bdy discover
Discover CLI commands as JSON, without login or network access
bdy distro
Manage distributions that route traffic from domains to artifacts, sandboxes and other targets
bdy domain
Manage zones (called "domains" in Buddy). A zone can be used in distribution routes. Zones can be apex (example.com) or multi-level (my-app.example.dev) — the whole string is one zone
bdy environment
Manage environments
bdy login
Log in to Buddy Required scopes: WORKSPACE_READ
bdy logout
Log out from Buddy
bdy mcp
Run a local stdio MCP server proxying to the Buddy remote MCP server
bdy pipeline
Manage pipelines and their runs
bdy project
Manage projects
bdy register
Create a Buddy account
bdy sandbox
Create and manage cloud sandboxes: run commands and apps, take snapshots, expose endpoints
bdy target
Manage deployment targets
bdy update
Show the installed bdy version and how to update when a newer one is available
bdy whoami
Show who you are logged in as Required scopes: USER_READ
bdy workspace
Manage workspaces
bdy yaml
Browse and validate Buddy pipeline YAML