Connect your favorite AI coding agents with BYOB ->

Connecting Your Agents: BYOB CLI & MCP Integrations

AI coding agents have revolutionized the way developers write code. However, out of the box, most agents lack the context they need to truly be effective. They don't know your deployments, database statuses, environments, or project-specific coding conventions.

To solve this, we leverage the Model Context Protocol (MCP) via our new byob-cli npm package. This allows you to securely connect your favorite agents (Codex, Claude Code, and Antigravity) directly to your BYOB projects.

TLDR

1-Click Install: Use npx -y byob-cli <agent> install to authenticate and configure MCP instantly.
Platform Tooling: Exposes BYOB control plane features directly to your AI agent.
Context is King: The agent natively understands your deployed preview URLs, active workspaces, and synced coding skills.

The Power of the Model Context Protocol (MCP)

At its core, MCP provides a standardized way for AI agents to discover tools and resources about your environment. By installing the BYOB CLI, you are spinning up a local MCP server that acts as a bridge between the AI agent and the BYOB control plane (air.api.byob.studio).

This means you can type a natural language prompt like "Check my database schema and deploy this project," and the agent will natively route those intents to the byob database schema and byob deploy tools.

1-Click Installers

We've built dedicated installation wizards that handle OAuth, configuration, and skill syncing automatically. You can copy these commands directly from the Agent Connections tab in your Project Control Center, pre-filled with your specific Project ID.

Supported Agents

Codex:

bash

npx -y byob-cli codex install --project-id YOUR_PROJECT_ID

This triggers the OAuth device flow, configures ~/.codex/config.toml, and installs the BYOB skill into both ~/.agents/skills/byob_cli and ~/.codex/skills/byob_cli.

Claude Code:

bash

npx -y byob-cli claude install --project-id YOUR_PROJECT_ID

This runs claude mcp add --scope user (or safely merges the MCP server block into ~/.claude.json) and installs the shared byob_cli skill into ~/.claude/skills/byob_cli.

Antigravity (Gemini):

bash

npx -y byob-cli gemini install --project-id YOUR_PROJECT_ID

This writes the MCP server config to ~/.gemini/config/mcp_config.json and installs the shared byob_cli skill into ~/.agents/skills/byob_cli.

OpenCode:

bash

npx -y byob-cli opencode install --project-id YOUR_PROJECT_ID

After running the install command on your local machine, click the Approve agent button in the dashboard to complete the authorization loop.

Workspace SSH Configuration

If you prefer to connect directly to the underlying workspace via SSH (for IDEs like VS Code or Cursor), you can easily install the SSH configuration for your project:

bash

npx -y byob-cli workspace ssh-config --install --project-id YOUR_PROJECT_ID

Synced AIR Coding Skills

The magic isn't just in the tools; it's in the knowledge.

When you run an installer (or manually run byob <agent> sync-skills), the CLI downloads BYOB AIR coding skills directly into your local agent environment. These skills act as the "brain" for the agent, providing it with deep, reusable implementation knowledge on:

SvelteKit & UI Quality Standards
BYOB DB (Cloudflare D1)
Better Auth & Magic Links
Paddle Payments Orchestration

By syncing these skills, the agent writes code that exactly matches BYOB's production conventions rather than hallucinating generic boilerplate.

✨

TIP

You can also authenticate without linking a specific agent by running byob login. This starts the device flow and stores BYOB auth for standalone CLI usage.

Multiple Projects & Targeting

BYOB CLI grants are scoped to your account, meaning you can control which project the agent is focused on. For project-specific commands, the agent will pass --project-id via the MCP server.

If you ever need to inspect what projects your account has access to, you can simply run:

bash

byob projects

Security & Local Telemetry

Your credentials stay local. The BYOB CLI stores the OAuth token securely on your machine. To ensure we continually improve the CLI experience, it records compact local diagnostics (like command success/failure and durations) in ~/.byob/telemetry.jsonl.

We explicitly redact project IDs, URLs, emails, tokens, and raw server errors. You can easily manage or disable telemetry with byob telemetry disable.

Summary

By connecting your AI coding agents to BYOB via MCP, you transform them from generic code generators into deeply integrated team members. They understand your deployments, they know your database, and they follow your architectural conventions.

Explore the BYOB CLI documentation and connect your agent today ->

Connecting Your Agents: BYOB CLI & MCP Integrations