---
name: self-upgrade
description: "Upgrade vellum to the latest version, restart the assistant, and restart the gateway"
license: "MIT"
compatibility: "Designed for Vellum personal assistants"
metadata:
  decimalai-skill-id: "a34669aa-bdd0-4073-b899-24baffa2112d"
  decimalai-version-id: "62290290-ead2-4914-b7f3-415b34814042"
  decimalai-version: "1"
  decimalai-body-sha256: "c1444444f294883cc1c63a1e55a52111420759b5f4169fecf1b61bd69987a763"
  decimalai-name: "self-upgrade"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "agent-tooling"
  decimalai-source: "https://app.decimal.ai/s/self-upgrade@1/SKILL.md"
---
You are performing a self-upgrade of the Vellum assistant. Follow these steps **in order**. Use the `bash` tool to run each command. Confirm each step succeeds before moving to the next.

## Step 1: Record the current version

```bash
vellum --version
```

Save this value to report later.

## Step 2: Install the latest vellum

```bash
bun install -g vellum@latest
```

After updating, verify the new version:

```bash
vellum --version
```

## Step 3: Restart the gateway

If a gateway process is running, restart it so it picks up any protocol or dependency changes from the new version:

```bash
pgrep -f 'vellum-gateway|gateway/src/index.ts' || echo "No gateway process found"
```

If a gateway PID is found, send it SIGTERM so it drains gracefully:

```bash
pkill -TERM -f 'vellum-gateway|gateway/src/index.ts'
```

Then start the gateway again using whatever method the user's deployment uses (e.g. `bun run gateway/src/index.ts`, a systemd service, or a container orchestrator). If you are unsure how the gateway is deployed, ask the user.

## Step 4: Restart the assistant

Use `vellum sleep` to stop the running assistant and gateway, then `vellum wake` to start them again from the updated binary:

```bash
vellum sleep && vellum wake
```

Verify it is running:

```bash
vellum ps
```

**Important:** This is the last step because the current assistant process is the one executing this conversation. After the restart, the new assistant takes over and this conversation ends gracefully.

## After Upgrade

Report back to the user with:

- The previous and new vellum version
- Assistant status (running, PID)
- Gateway status (restarted or not found)
- Any errors encountered during the process