# buddy

A skill that teaches your agent to drive Buddy cloud through bdy: sandboxes, artifacts, tunnels, domains and pipelines.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1400 installs · ★ 20
- Author: buddy
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/buddy/buddy-plugin/tree/HEAD/skills/buddy/SKILL.md
- Updated: 2026-07-20
- HTML: https://affpapa.org/en/nevibecode/skills/buddy

## What it does

The skill hands the agent a working map of the Buddy platform, reached through the `bdy` command line. Sandboxes come first: create one, copy the project over, install dependencies, then start the app as a managed service so you get status, logs and restarts instead of a bare process. Other sections cover artifacts — BUCKET for static sites and build output, CONTAINER for Docker images — plus tunnels, domains, distributions and CI/CD pipelines.

Some rules are non-negotiable. An app inside a sandbox has to bind to `0.0.0.0`; on `127.0.0.1` the endpoint simply won't answer. Project copies should skip `node_modules` and `.git` and let the sandbox install packages itself. A static site needs its entry file named `index.html`, or visitors get a directory listing. Tunnel commands hold the terminal, so they belong in the background.

Login stays with you. The agent can't walk through interactive OAuth, so when a command answers `Token not provided` or `Not logged in`, run `bdy login` yourself in a separate terminal. The same goes for `bdy artifact docker login` before pushing images. `bdy whoami` shows whether the session is alive, and the skill also reads it to find the project context — a sandbox can't exist outside a project.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add buddy/buddy-plugin --skill buddy -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/buddy/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/buddy/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add buddy/buddy-plugin --skill buddy -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/buddy/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add buddy/buddy-plugin --skill buddy -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/buddy/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install buddy/buddy-plugin buddy
```

2. **Manually: put the files in place**
- File: `.github/skills/buddy/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add buddy/buddy-plugin --skill buddy -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/buddy/buddy-plugin --path skills/buddy
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/buddy/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add buddy/buddy-plugin --skill buddy -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/buddy/buddy-plugin/tree/HEAD/skills/buddy/SKILL.md

## When to use it
- spin up a cloud sandbox and run an app in it
- publish a build as an artifact with a public URL
- expose a local service to the internet through a tunnel
- point a custom domain at a service or artifact
- start a CI/CD pipeline and read its run logs

## Example prompts
- Deploy this app to a Buddy sandbox and show me the public URL
- Publish the `dist` folder as artifact `my-site@1.0.0`
- Open a tunnel to `localhost:3000` with HTTP Basic Auth

## Similar
- [wizard](https://affpapa.org/en/nevibecode/skills/wizard.md) — skill · 553369 installs
- [hyperframes-cli](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes-cli.md) — skill · 1300000 installs
- [setup-pre-commit](https://affpapa.org/en/nevibecode/skills/setup-pre-commit.md) — skill · 489289 installs
- [using-git-worktrees](https://affpapa.org/en/nevibecode/skills/using-git-worktrees.md) — skill · 217153 installs
- [finishing-a-development-branch](https://affpapa.org/en/nevibecode/skills/finishing-a-development-branch.md) — skill · 214439 installs
- [orca-cli](https://affpapa.org/en/nevibecode/skills/orca-cli.md) — skill · 353600 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md