Get Started on Cloud

AI Integrations

AI coding agents

Deploy to Buddy with your favorite AI coding agents - pipelines, sandboxes, domains and logs from your terminal or editor.
Buddy's Remote MCP Server is available.

Codex + Buddy

Codex is OpenAI's agentic coding tool that lives in your terminal, working with the full context of your project - reading across the codebase, running shell commands, editing files, and handling git along the way. Paired with Buddy, it deploys your project, triggers and monitors pipelines, ships changes across environments, and digs through build output when something needs fixing.

Codex works in the terminal with the full context of the repository, git included, so shipping is just another step in the session that produced the commit. Buddy takes over from there and runs the pipeline the agent triggered.

Info
This page is a quick overview. For the full walkthrough - including MCP setup - see the Codex docs. You can also run agents in a fully isolated Buddy sandbox or as a pipeline action.

Quick start

1 Install the Buddy CLI
npm install -g bdy

3 Link your project
bdy proj link

4 Install the Buddy skill
npx skills add buddy/buddy-plugin

5 Start Codex
codex

The Buddy skill teaches the agent how to drive Buddy through the CLI, so you can ask for deployments and pipelines in your own words.

Example prompts

  • “Create a snake app and deploy it for me”
  • “Deploy an AI chatbot with Postgres for history and Redis for rate limiting”
  • “Add a pipeline that runs on every change in the repository and executes my test suite”
  • “Analyze the logs from the last production deployment and fix the errors”

Available commands

Available commands
bdy proj link
Link the current directory with a project in Buddy. See bdy project.
bdy sandbox
Create, start and manage on-demand sandboxes with apps, endpoints and snapshots.
bdy pipeline
Create, run and inspect pipelines and their runs.
bdy tunnel
Expose a locally running app to the internet over HTTP, TCP or TLS. See bdy tunnel.
bdy artifact
Publish, download and version build artifacts, including static sites.
bdy domain
Search, buy and manage domains used in distribution routes.

Connect MCP

Buddy's remote MCP server exposes over 90 tools, so Codex can run pipelines, manage deployments, and read logs straight through the API. Add the server to ~/.codex/config.toml - the transport is inferred from the url key:

toml
[mcp_servers.buddy]
url = "https://mcp.buddy.works/mcp"

Point it at the endpoint closest to your workspace region - mcp.buddy.works, mcp.eu.buddy.works or mcp.asia.buddy.works - and use the ?tools= parameter to narrow the exposed tool categories.