Skill: Run

Description

Pulls the latest code from main or test and launches the ScribeVault PySide6 desktop app. Designed for the workflow where development happens on a remote server and the app is run locally from freshly pulled code.

Trigger

• •Invoked by the /run slash command.

Usage

/run              # Default: pull main and run
/run test         # Pull test branch and run
/run main         # Pull main branch and run (explicit)

Process

1. •Save current branch — Record which branch we're on.
2. •Auto-stash if dirty — If git status --porcelain shows changes, run git stash --include-untracked -m "run-auto-stash". Do NOT ask — just stash.
3. •Fetch latest — git fetch origin.
4. •Checkout branch — git checkout <branch> (default: main). Only main and test are valid targets.
5. •Pull — git pull origin <branch>.
6. •Sync dependencies — uv sync to ensure packages match the pulled code.
7. •Launch app — python main.py. This runs in the foreground — the app window opens and Claude waits for it to exit.
8. •Restore — After the app exits:
   • •git checkout <original-branch>
   • •If we stashed: git stash pop
9. •Report — What branch was run, commit hash, any dependency changes.

Key Rules

• •Only main and test are valid branches. Reject anything else.
• •No prompts. This is a pull-and-run — no approval needed.
• •Auto-stash, auto-restore. Working tree handled silently.
• •uv sync before run. The pulled code may have new/changed dependencies. Always sync first.
• •Foreground execution. The app runs in the foreground so Claude can detect when it exits and clean up.

Error Conditions