# Codex

Use Codex with Buddy to deploy your project, trigger and monitor pipelines, and dig through build logs - all from your terminal.

Codex is OpenAI's agentic coding tool that lives in your terminal. It works with the full context of your project - reading across the codebase, running shell commands, editing files wherever changes are needed, and taking care of git along the way. Paired with Buddy, Codex can deploy your project and let Buddy handle the entire deployment workflow. On top of that, it can trigger and monitor your pipelines, ship changes across environments, and dig through build output and logs when something needs fixing.

<Hint type="info">
This page covers working with Buddy from within Codex. On top of that, you can run AI coding agents in a fully isolated Buddy sandbox - see [Run agents in a sandbox](/docs/ai-agents/sandboxes.md).
</Hint>

## Quick start

<Steps>
  <Step title="Install the Buddy CLI">
    ```bash
    npm install -g bdy
    ```
  </Step>
  <Step title="Log in to Buddy">
    ```bash
    bdy login
    ```
  </Step>
  <Step title="Link your project">
    Run this inside your project directory to connect it to a Buddy project:

    ```bash
    bdy proj link
    ```
  </Step>
  <Step title="Install the Buddy skill">
    ```bash
    npx skills add buddy/buddy-plugin
    ```
  </Step>
  <Step title="Start Codex">
    ```bash
    codex
    ```
  </Step>
  <Step title="Prompt the agent">
    Ask it to build and ship something end to end, for example:

    ```text
    Create a snake app and deploy it for me
    ```
  </Step>
</Steps>

## Example prompts

Once the agent is running and your project is linked to Buddy, try prompts like:

- Create a Next.js app and deploy it to production.
- Deploy an Umami analytics instance and wire it into my app.
- Deploy an AI chatbot with Postgres for history and Redis for rate limiting.
- Deploy my app, set up a CDN, and buy and configure a domain with SSL.
- Add a pipeline that runs on every change in the repository and executes my test suite.
- Add a pipeline that runs every minute, checks that my site is up, and sends a notification to Slack, email, Telegram, or SMS if anything is wrong.
- Check the last few CI pipeline runs for failures, read the logs, and fix the failing tests.
- Analyze the logs from the last production deployment and fix the errors.
- Find the last successful production deployment and roll back to it.
- Check my app logs and open issues based on what you find.

## Connect MCP

Give Codex access to Buddy over MCP so it can run pipelines, manage deployments, and read logs. See the [MCP](/docs/ai-agents/mcp.md) page for the regional server URLs and how to filter the exposed tool categories.

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"
```

Or ask Codex to set it up for you:

```text
Add the Buddy MCP server (https://mcp.buddy.works/mcp) to your MCP configuration.
```


---
Original source: https://buddy.works/docs/ai-agents/agents/codex