vellum-assistant: Skill for Claude Code

Update - Restart Vellum (with Smart Branch Handling)

Restart the Vellum assistant and gateway services with branch-aware git behavior.

Arguments

The user may pass $ARGUMENTS to control branch behavior:

Steps

1. Ensure Bun is on PATH:

   export PATH="$HOME/.bun/bin:$PATH"
   

2. Preflight snapshot - capture current state before making changes:

   vellum ps
   

3. Quiesce with vellum sleep - stop assistant and gateway processes. This is directory-agnostic and stops processes globally regardless of CWD:

   vellum sleep || true
   

4. Verify stopped - run vellum ps and confirm no running processes. If vellum ps shows processes still running, run fallback cleanup to force-kill them:

   vellum ps
   

   Fallback cleanup if vellum ps confirms processes are still running:

   pkill -x "vellum-assistant" || true
   pkill -f "gateway/src/index" || true
   lsof -ti :7830 | xargs kill -9 2>/dev/null || true
   lsof -ti :7821 | xargs kill -9 2>/dev/null || true
   

   After fallback cleanup, run vellum ps again to confirm all processes are stopped.

5. Smart branch handling - determine what git operations (if any) to perform:

   CURRENT=$(git branch --show-current)
   GIT_OPS_RAN=false
   

   Case A - --pull flag: Force pull on the current branch.

   if [[ "$ARGUMENTS" == "--pull" ]]; then
     git pull
     GIT_OPS_RAN=true
   fi
   

   Case B - Explicit branch name provided: Check out the requested branch, pulling if possible. Before checking out, verify the working tree is clean - if there are uncommitted changes, stop and warn the user rather than silently losing work. Do NOT stash automatically.

   if [[ -n "$ARGUMENTS" && "$ARGUMENTS" != "--pull" ]]; then
     if ! git diff --quiet || ! git diff --cached --quiet; then
       echo "ERROR: Uncommitted changes detected. Commit or stash them before switching branches."
       # Stop and report the error to the user. Do not proceed.
     fi
     git checkout "$ARGUMENTS"
     git pull origin "$ARGUMENTS" 2>/dev/null || true
     GIT_OPS_RAN=true
   fi