By 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