// Update vault to the latest version of obsidian-claude-pkm. Creates backup, shows diffs, preserves your content. Use when a new version is available.
| name | upgrade |
| description | Update vault to the latest version of obsidian-claude-pkm. Creates backup, shows diffs, preserves your content. Use when a new version is available. |
| allowed-tools | Read, Write, Edit, Glob, Grep, Bash |
| model | sonnet |
| user-invocable | true |
Updates your vault's system files to the latest version while preserving all your personal content.
/upgrade # Interactive upgrade with backup and diff review
/upgrade check # Preview what's changed without making modifications
.claude/skills/*/SKILL.md — Skill definitions.claude/agents/*.md — Agent configurations.claude/hooks/*.sh — Automation scripts.claude/rules/*.md — Convention rules.claude/output-styles/*.md — Output style definitions.claude/settings.json — Permissions and hook configCLAUDE.md — Root context file (merged carefully)Templates/*.md — Note templatesDaily Notes/** — Your daily journal entriesGoals/** — Your goal files and reviewsProjects/** — Your project folders and CLAUDE.md filesArchives/** — Your archived contentInbox/** — Your captured itemsCLAUDE.local.md — Your personal overridesvault-config.json — Your preferencesRead the current version from CLAUDE.md (look for "System Version:" line).
Compare with the upstream repo. If using git:
git fetch origin
git log HEAD..origin/main --oneline
If not a git repo or no remote, inform user they need to download the latest vault-template/ manually.
Before any changes, create a timestamped backup:
BACKUP_DIR=".backup/upgrade-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BACKUP_DIR"
cp -r .claude "$BACKUP_DIR/"
cp CLAUDE.md "$BACKUP_DIR/"
cp -r Templates "$BACKUP_DIR/" 2>/dev/null
Tell the user: "Backup created at $BACKUP_DIR"
For each system file that differs from upstream:
For each confirmed file:
CLAUDE.md: merge carefully — preserve user customizations (Personal Mission, Current Focus sections) while updating system sections (Skills table, version number)settings.json: merge — add new permissions/hooks, preserve existing customizationschmod +x .claude/hooks/*.sh/onboard to reload context/upgrade check)When invoked with "check":
/upgrade to apply## Upgrade Check
**Current version:** 3.0 (The Cascade)
**Available version:** 3.1
### Files to Update
| File | Change Summary |
|------|---------------|
| `.claude/skills/daily/SKILL.md` | Added cascade context surfacing |
| `.claude/agents/goal-aligner.md` | Added memory: project |
| `.claude/hooks/session-init.sh` | Added priority surfacing |
### New Files
- `.claude/skills/review/SKILL.md` — Smart review router
- `.claude/hooks/skill-discovery.sh` — Auto-list skills
### No Changes Needed
- `.claude/rules/` — Already up to date
Run `/upgrade` to apply these updates (backup will be created first).
CLAUDE.local.md personal overrides preservedWorks with:
/onboard — Reload context after upgradeScaffold the PKM system onto an existing Obsidian vault. Scans your vault structure, maps folders interactively, and generates configuration — no template required.
Interactive vault setup and context loading. On first run, personalizes your vault. On subsequent runs, loads full context. Use at start of session or when Claude needs full vault context.
Smart review router. Detects context (morning, Sunday, end of month) and launches the appropriate review workflow. Use anytime for the right review at the right time.
Create daily notes and manage morning, midday, and evening routines. Structure daily planning, task review, and end-of-day reflection. Use for daily productivity routines or when asked to create today's note.
Track progress toward 3-year, yearly, monthly, and weekly goals. Calculate completion percentages, surface stalled goals, connect daily tasks to objectives. Use for goal reviews and progress tracking.
Monthly review and planning. Roll up weekly reviews, check quarterly milestones, set next month's focus. Use at end of month or start of new month.
