self-upgrade

name	self-upgrade
description	Upgrade vellum to the latest version, restart the assistant, and restart the gateway
compatibility	Designed for Vellum personal assistants
metadata	{"emoji":"⬆️","vellum":{"category":"system","display-name":"Self Upgrade"}}

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

vellum --version

Save this value to report later.

Step 2: Install the latest vellum

bun install -g vellum@latest

After updating, verify the new version:

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:

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:

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:

vellum sleep && vellum wake

Verify it is running:

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