Update Nexus

Purpose: Sync system files from the upstream Nexus repository while protecting user data

Trigger: "update nexus", "sync nexus", "get updates", "check for updates"

Duration: 1-2 minutes

What This Does

• 00-system/

  - Core framework, skills, documentation

• CLAUDE.md

  - Entry point

• README.md

  - Project readme

• 01-memory/

  - Your goals, learnings, config

• 02-projects/

  - Your projects

• 03-skills/

  - Your custom skills

• 04-workspace/

  - Your files

• .env

  ,

  .claude/

  - Your secrets and settings

Workflow

Step 1: Check for Updates

python 00-system/core/nexus-loader.py --check-update

• If

  checked: false

  with error → Display error, exit gracefully
• If

  update_available: false

  → Display "Already up-to-date!", exit
• If

  update_available: true

  → Continue to Step 2

Step 2: Show What Will Change

UPDATE AVAILABLE

Current version: {local_version}
New version:     {upstream_version}

Files to update ({changes_count}):
{list changed_files, max 20}

PROTECTED (will NOT be touched):
- 01-memory/    (your goals & config)
- 02-projects/  (your projects)
- 03-skills/    (your custom skills)
- 04-workspace/ (your files)

Step 3: Confirm with User

• If no → Exit with "Update cancelled"
• If yes → Continue to Step 4

Step 4: Perform Sync

python 00-system/core/nexus-loader.py --sync --force

• If

  success: false

  → Display error message, suggest fixes
• If

  success: true

  → Continue to Step 5

Step 5: Display Results

UPDATE COMPLETE!

{local_version} → {upstream_version}

Updated paths:
{list files_updated}

Backup saved to: {backup_path}

To commit this update:
  git add . && git commit -m "Update Nexus to v{upstream_version}"

Error Handling

Advanced: Dry Run

python 00-system/core/nexus-loader.py --sync --dry-run

Notes

• Backup: Before any sync, your current system files are backed up to

  .sync-backup/{timestamp}/

• Safe: User data folders are NEVER in the sync paths - they cannot be touched
• Upstream Remote: Automatically added on first use (named "upstream")
• Default URL: https://github.com/beamanalytica/Nexus-v4.git (can override in user-config.yaml)