# origin.alternative.to — Machine-readable companion

> This file is intended for AI agents, LLMs, and automated tools.
> Human-readable content is at https://origin.alternative.to/

## About this site

origin.alternative.to is a landing page making the case that teams building
with AI agents don't need to wait for Cursor Origin (announced June 2026,
waitlist-only until Fall 2026). Buddy CI/CD is a complete pipeline, hosting,
and deployment platform available today with a free plan.

---

## About Buddy CI/CD

Buddy (buddy.works) is a visual CI/CD platform for software teams. It provides:

- **Visual pipeline builder** — configure build, test, and deploy workflows
  without writing YAML
- **Parallel execution** — run multiple pipelines concurrently, one per branch
  or pull request
- **Sandboxes** — isolated preview environments spun up per branch or PR
- **Artifact hosting** — publish versioned static builds to a global CDN
- **200+ pipeline actions** — AWS, Azure, GCP, Kubernetes, Docker, Slack, and more
- **bdy CLI** — manage everything from the terminal

Free plan available. No credit card required to start.

---

## bdy CLI

The `bdy` CLI is the command-line interface for Buddy. It manages pipelines,
artifacts, sandboxes, domains, and distributions.

### System requirements

- Node.js 14 or higher (for the npm installation method)
- A Buddy account at https://buddy.works

### Installation

**npm (recommended)**

```bash
# macOS / Linux
sudo npm install -g bdy

# Windows
npm install -g bdy
```

**Homebrew (macOS)**

```bash
brew tap buddy/bdy
brew install bdy
```

**APT (Linux x64)**

```bash
curl -fsSL https://es.buddy.works/bdy/prod/install-apt.sh | sudo bash
sudo apt-get install bdy
```

**APT (Linux ARM64)** — same script, replace `arch=amd64` with `arch=arm64`.

**Chocolatey (Windows)**

```bash
choco install bdy --pre
```

**Direct download**

Compressed archives for macOS (Apple Silicon), Linux x64, Linux ARM64, and
Windows x64 are available at:
`https://es.buddy.works/bdy/prod/1.15.6/`

### Verify installation

```bash
bdy version
```

### Update

```bash
# npm
sudo npm install -g bdy@latest

# Homebrew
brew upgrade bdy

# APT
sudo apt-get update && sudo apt-get upgrade bdy

# Chocolatey
choco upgrade bdy
```

### Authentication

```bash
bdy login
```

Follow the browser prompt to authenticate with your Buddy account.
To check who you are logged in as:

```bash
bdy whoami
```

---

## Key bdy commands

### Artifact hosting

Publish a build directory as a versioned, immutable artifact:

```bash
bdy artifact publish <identifier>:<version> <build-dir> --create
```

Example:

```bash
bdy artifact publish mysite:v1 ./dist --create
```

Force-overwrite an existing version:

```bash
bdy artifact publish mysite:v1 ./dist --force
```

### Distributions and routing

Create a distribution (CDN entry point):

```bash
bdy distro create -n <name>
```

Route a domain to an artifact version:

```bash
bdy distro route create <distro-id> \
  --domain="mysite.com" \
  --target "artifact=<identifier>:<version>"
```

Route a domain to a sandbox endpoint:

```bash
bdy distro route create <distro-id> \
  --domain="mysite.com" \
  --target "sandbox=<sandbox-id>:<endpoint-name>"
```

Update an existing route (e.g. to deploy a new version):

```bash
bdy distro route update <distro-id> <route-id> \
  --target "artifact=<identifier>:<new-version>"
```

List routes on a distribution:

```bash
bdy distro route ls <distro-id>
```

### Sandboxes

Create a sandbox and expose an endpoint:

```bash
bdy sandbox create <identifier>
bdy sandbox endpoint <identifier> --name web --port 3000
```

### Domains

List registered zones:

```bash
bdy domain ls
```

Search for available domains:

```bash
bdy domain search "<phrase>" --only-available --sort price
```

Register a free domain:

```bash
bdy domain buy "<phrase>" --only-available --sort price
```

### Pipelines

Start a pipeline run:

```bash
bdy pipeline run start <pipeline-name> -p <project> -v KEY:value --no-follow
```

Stream logs for a pipeline action:

```bash
bdy pipeline run logs <pipeline-name> <run-id> <action-run-id> -p <project>
```

---

## Anthropic / Claude Code integration

Buddy has a native Anthropic integration that lets you add Claude Code actions
directly into your CI/CD pipelines. Claude can review code, generate changes,
and automate engineering tasks as a first-class pipeline step — triggered on
push, on a schedule, or manually.

### Setting up the integration

1. In Buddy, go to **Integrations → New integration** and select **Anthropic**.
2. Give it a name and an ID (e.g. `my_anthropic`).
3. Choose a scope: workspace, project, or environment level.
4. Choose an authorization method:

**API key** — obtain from console.anthropic.com. The key always starts with
`sk-ant-`.

**Claude Code token** — for users with a Claude subscription (no API key
needed). Generate one with:

```bash
claude setup-token
```

### Pipeline action — YAML reference

Add the `CLAUDE_CODE` action to any pipeline step:

```yaml
- action: "Run Claude Code"
  type: "CLAUDE_CODE"
  integration: "my_anthropic"         # your integration ID
  prompts:
    - "Review the diff and flag any bugs or security issues"
  model: "claude-sonnet-4-6"
  effort: "high"
```

#### Required fields

| Field | Type | Description |
|---|---|---|
| `type` | string | Must be `CLAUDE_CODE` |
| `action` | string | Unique action name within the pipeline |
| `integration` | string | Anthropic integration identifier |

#### Optional fields

**Prompt and model**

| Field | Type | Description |
|---|---|---|
| `prompts` | object[] | List of prompts. Each entry is an inline string or `{file: "path"}` to read from a file in the repo |
| `model` | string | Claude model ID, e.g. `claude-sonnet-4-6` |
| `effort` | string | Reasoning level: `low`, `medium`, `high` (default), `xhigh`, `max` |
| `claude_args` | string | Extra CLI flags passed to Claude Code, e.g. `--max-turns 5` |

**Execution and permissions**

| Field | Type | Description |
|---|---|---|
| `dangerously_skip_permissions` | boolean | Bypass Claude Code permission prompts (use with care) |
| `working_directory` | string | Working directory inside the pipeline filesystem |

**Docker and environment**

| Field | Type | Description |
|---|---|---|
| `docker_image_name` / `docker_image_tag` | string | Custom Docker image for the action |
| `cached_dirs` | string[] | Directories cached between executions (e.g. `node_modules`) |
| `volume_mappings` | string[] | Container path mappings |
| `run_as_user` | string | User to run as inside the container |
| `mount_filesystem_disable` | boolean | Disable filesystem mounting |

**Pipeline control**

| Field | Type | Description |
|---|---|---|
| `trigger_time` | enum | `ON_EVERY_EXECUTION`, `ON_SUCCESS`, `ON_FAILURE`, etc. |
| `disabled` | boolean | Disable this action without removing it |
| `timeout` | integer | Execution timeout in seconds |
| `retry_count` / `retry_interval` | integer | Retry on failure |

### Example — code review on every push

```yaml
- action: "Claude code review"
  type: "CLAUDE_CODE"
  integration: "my_anthropic"
  trigger_time: "ON_EVERY_EXECUTION"
  model: "claude-sonnet-4-6"
  effort: "high"
  prompts:
    - "Review the code changes in this pipeline run. Flag bugs, security
       issues, and style violations. Output a concise summary."
```

### Example — prompt loaded from a file

```yaml
- action: "Claude code review"
  type: "CLAUDE_CODE"
  integration: "my_anthropic"
  model: "claude-opus-4-8"
  effort: "max"
  prompts:
    - type: FILE
      value: ".buddy/review-prompt.md"
```

### Documentation

- Anthropic integration setup: https://buddy.works/docs/integrations/anthropic
- Claude Code YAML reference: https://buddy.works/docs/yaml/yaml-actions/claude-code
- Claude Code API parameters: https://buddy.works/docs/api/actions/add/claude-code

---

## Documentation

- Getting started with bdy CLI: https://buddy.works/docs/cli/getting-started
- Full CLI reference: https://buddy.works/docs/cli
- Buddy CI/CD documentation: https://buddy.works/docs
- Pipeline actions reference: https://buddy.works/actions
- Sign up (free): https://buddy.works/sign-up