okr-upgrade

name	okr-upgrade
version	0.1.0
description	Update okr-os to the latest version. Use when: "upgrade okr-os", "update okr skills", "get latest version", "okr-os update", "new version".
allowed-tools	["Read","Bash","AskUserQuestion"]

Preamble

_SCRIPT_DIR=$(cd "$(dirname "$(readlink ~/.claude/skills/okr-os 2>/dev/null || echo ~/.claude/skills/okr-os)")" && pwd)
echo "INSTALL_DIR: $_SCRIPT_DIR"
_CURRENT_VERSION=$(cat "$_SCRIPT_DIR/VERSION" 2>/dev/null || echo "unknown")
echo "CURRENT_VERSION: $_CURRENT_VERSION"
_IS_GIT=$(cd "$_SCRIPT_DIR" && git rev-parse --is-inside-work-tree 2>/dev/null || echo "false")
echo "IS_GIT_INSTALL: $_IS_GIT"

Workflow

Step 1: Detect Installation Type

From preamble output:

• If IS_GIT_INSTALL: true — installed via git clone. Upgrade with git pull.
• If IS_GIT_INSTALL: false — installed manually (copied files). Cannot auto-upgrade. Tell user: "okr-os was installed manually (not via git clone). To upgrade, download the latest version and re-run ./setup"

Step 2: Check for Updates

cd "$_SCRIPT_DIR" && git fetch origin main 2>/dev/null
_REMOTE_VERSION=$(cd "$_SCRIPT_DIR" && git show origin/main:VERSION 2>/dev/null || echo "unknown")
echo "REMOTE_VERSION: $_REMOTE_VERSION"
_LOCAL_CHANGES=$(cd "$_SCRIPT_DIR" && git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
echo "LOCAL_CHANGES: $_LOCAL_CHANGES"

If versions match: "You're already on the latest version (v$CURRENT_VERSION). No upgrade needed."

If local changes exist: warn via AskUserQuestion: "You have local changes to okr-os files. Upgrading will overwrite them." Options:

• A) Upgrade anyway (discard local changes)
• B) Cancel — I'll back up my changes first

Step 3: Perform Upgrade

cd "$_SCRIPT_DIR" && git reset --hard origin/main

Step 4: Re-run Setup

cd "$_SCRIPT_DIR" && ./setup

Step 5: Show What Changed

cd "$_SCRIPT_DIR" && git log --oneline "$_CURRENT_VERSION"..HEAD 2>/dev/null | head -20

Read CHANGELOG.md and extract the section between the old and new version. Present a summary: "Updated from v{old} to v{new}. Here's what changed:"

Step 6: Clear Update Check Cache

rm -f ~/.okr-os/.update-snooze 2>/dev/null || true

Security Note

This skill pulls code from a remote git repository and executes a setup script. The setup script only creates symlinks and makes files executable. It does not run arbitrary code beyond that.

Users should verify the remote URL points to the official okr-os repository:

cd "$_SCRIPT_DIR" && git remote get-url origin

Voice

Brief and factual. State what version you're on, what's available, what changed. No sales pitch for upgrading. Just the facts.