Claude-Code-Workflow/.claude/commands/version.md

name, description, usage, examples, allowed-tools

name	description	usage	examples	allowed-tools
version	Display version information and check for updates	/version	/version	Bash(*)

Version Command (/version)

Purpose

Display local and global installation versions, check for the latest updates from GitHub, and provide upgrade recommendations.

Execution Flow

1. Local Version Check: Read version information from ./.claude/version.json if it exists.
2. Global Version Check: Read version information from ~/.claude/version.json if it exists.
3. Fetch Remote Versions: Use GitHub API to get the latest stable release tag and the latest commit hash from the main branch.
4. Compare & Suggest: Compare installed versions with the latest remote versions and provide upgrade suggestions if applicable.

Step 1: Check Local Version

Check if local version.json exists

bash(test -f ./.claude/version.json && echo "found" || echo "not_found")

Read local version (if exists)

bash(cat ./.claude/version.json)

Extract version with jq (preferred)

bash(cat ./.claude/version.json | grep -o '"version": *"[^"]*"' | cut -d'"' -f4)

Extract installation date

bash(cat ./.claude/version.json | grep -o '"installation_date_utc": *"[^"]*"' | cut -d'"' -f4)

Output Format:

Local Version: 3.2.1
Installed: 2025-10-03T12:00:00Z

Step 2: Check Global Version

Check if global version.json exists

bash(test -f ~/.claude/version.json && echo "found" || echo "not_found")

Read global version

bash(cat ~/.claude/version.json)

Extract version

bash(cat ~/.claude/version.json | grep -o '"version": *"[^"]*"' | cut -d'"' -f4)

Extract installation date

bash(cat ~/.claude/version.json | grep -o '"installation_date_utc": *"[^"]*"' | cut -d'"' -f4)

Output Format:

Global Version: 3.2.1
Installed: 2025-10-03T12:00:00Z

Step 3: Fetch Latest Stable Release

Call GitHub API for latest release

bash(curl -fsSL "https://api.github.com/repos/catlog22/Claude-Code-Workflow/releases/latest" 2>/dev/null)

Extract tag name (version)

bash(curl -fsSL "https://api.github.com/repos/catlog22/Claude-Code-Workflow/releases/latest" 2>/dev/null | grep -o '"tag_name": *"[^"]*"' | head -1 | cut -d'"' -f4)

Output Format:

Latest Stable: v3.2.2

Step 4: Fetch Latest Main Branch

Call GitHub API for main branch

bash(curl -fsSL "https://api.github.com/repos/catlog22/Claude-Code-Workflow/branches/main" 2>/dev/null)

Extract commit SHA (short)

bash(curl -fsSL "https://api.github.com/repos/catlog22/Claude-Code-Workflow/branches/main" 2>/dev/null | grep -o '"sha": *"[^"]*"' | head -1 | cut -d'"' -f4 | cut -c1-7)

Output Format:

Latest Dev: a1b2c3d

Step 5: Compare Versions and Suggest Upgrade

Normalize versions (remove 'v' prefix)

bash(echo "v3.2.1" | sed 's/^v//')

Compare two versions

bash(printf "%s\n%s" "3.2.1" "3.2.2" | sort -V | tail -n 1)

Check if versions are equal

# If equal: Up to date
# If remote newer: Upgrade available
# If local newer: Development version

Output Scenarios:

Scenario 1: Up to date

✅ You are on the latest stable version (3.2.1)

Scenario 2: Upgrade available

⬆️ A newer stable version is available: v3.2.2
Your version: 3.2.1

To upgrade:
PowerShell: iex (iwr -useb https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.ps1)
Bash: bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.sh)

Scenario 3: Development version

✨ You are running a development version (3.3.0-dev)
This is newer than the latest stable release (v3.2.2)

Simple Bash Commands

Basic Operations

# Check local version file
bash(test -f ./.claude/version.json && cat ./.claude/version.json)

# Check global version file
bash(test -f ~/.claude/version.json && cat ~/.claude/version.json)

# Extract version from JSON
bash(cat version.json | grep -o '"version": *"[^"]*"' | cut -d'"' -f4)

# Extract date from JSON
bash(cat version.json | grep -o '"installation_date_utc": *"[^"]*"' | cut -d'"' -f4)

# Fetch latest release
bash(curl -fsSL "https://api.github.com/repos/catlog22/Claude-Code-Workflow/releases/latest")

# Extract tag name
bash(curl -s https://api.github.com/repos/catlog22/Claude-Code-Workflow/releases/latest | grep -o '"tag_name": *"[^"]*"' | cut -d'"' -f4)

# Compare versions
bash(printf "%s\n%s" "3.2.1" "3.2.2" | sort -V | tail -n 1)

# Remove 'v' prefix
bash(echo "v3.2.1" | sed 's/^v//')

Error Handling

No installation found

WARNING: Claude Code Workflow not installed
Install using:
PowerShell: iex (iwr -useb https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.ps1)

Network error

ERROR: Could not fetch latest version from GitHub
Check your network connection

Invalid version.json

ERROR: version.json is invalid or corrupted

Design Notes

• Uses simple, direct bash commands instead of complex functions
• Each step is independent and can be executed separately
• Fallback to grep/sed for JSON parsing (no jq dependency required)
• Network calls use curl with error suppression
• Version comparison uses sort -V for accurate semantic versioning

Related Commands

• /cli:cli-init - Initialize CLI configurations
• /workflow:session:list - List workflow sessions