self-upgrade

Upgrade the Vellum runtime and restart the gateway.

1.0k|158|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/vellum-ai/vellum-assistant --skill self-upgrade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-upgrade
Source: https://github.com/vellum-ai/vellum-assistant/tree/main/skills/self-upgrade
Command: npx skills add https://github.com/vellum-ai/vellum-assistant --skill self-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines updating the Vellum runtime to the latest release, ensuring the assistant and gateway are upgraded consistently and restarted safely.

Core Features & Use Cases

  • One-click upgrade flow: Detects the current version, installs the latest vellum globally, and restarts services to apply updates.
  • Safe restart sequence: Restarts the gateway and the assistant to ensure the new binary is in use.
  • Audit-friendly: Outputs version information before and after upgrade for verification and troubleshooting.

Quick Start

Run the self-upgrade routine to update vellum, restart the gateway, and bring the assistant back online.

Frequently Asked Questions about self-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade the Vellum CLI to the latest version?

To upgrade the Vellum CLI, the self-upgrade process detects the current version, installs the latest vellum binary globally, and restarts the gateway to apply the update.

What is the safest way to restart the Vellum gateway after an upgrade?

The safe restart sequence involves restarting the gateway and the assistant together, ensuring the newly installed binary is actively in use and confirming operational status.

Do I need to manually verify versions after a Vellum runtime upgrade?

No, the upgrade process is audit-friendly and automatically outputs version information before and after the update, allowing you to verify the runtime change and troubleshoot if necessary.

Can I update the Vellum assistant without restarting the gateway?

No, restarting the gateway is required to keep the runtime current and ensure the gateway remains in sync with the updated assistant binary.

Why does the Vellum gateway need to restart during a CLI upgrade?

Restarting the gateway during a CLI upgrade ensures the gateway service loads the updated binary, maintaining sync between the assistant and the gateway runtime.