update-nexus

Syncs Nexus system files from an upstream Git repository while protecting user data folders.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill update-nexus-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-nexus
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/system/update-nexus
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill update-nexus-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a Nexus installation current with upstream improvements normally requires manual Git operations that risk overwriting personal memory, projects, and custom skills. This Skill automates the update check and sync process while guaranteeing user data folders are never touched. ## Core Features & Use Cases - Update Detection: Runs nexus-loader.py with --check-update to compare local and upstream versions and list changed files. - Protected Sync: Updates only system paths (00-system/, CLAUDE.md, README.md) while excluding 01-memory/, 02-projects/, 03-skills/, and 04-workspace/. - Automatic Backup: Saves current system files to .sync-backup/{timestamp}/ before applying any changes. - Use Case: You hear a new Nexus version is released. Say "update nexus", review the listed changes, confirm, and the system files sync while your goals, projects, and custom skills remain untouched. ## Quick Start Say "update nexus" to check for upstream updates and sync the system files after confirming the listed changes.

Frequently Asked Questions about update-nexus

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update Nexus to the latest version?

Say "update nexus" or run python 00-system/core/nexus-loader.py --check-update to see available changes, then confirm to run the sync with --sync --force. The update takes 1-2 minutes and commits can be made afterward with git.

Will updating Nexus delete my projects or memory files?

No, user folders are never touched during sync. The update only modifies 00-system/, CLAUDE.md, and README.md, while 01-memory/, 02-projects/, 03-skills/, and 04-workspace/ are explicitly excluded from sync paths.

Can I preview Nexus updates before applying them?

Yes, run python 00-system/core/nexus-loader.py --sync --dry-run to preview changes without applying them. The normal workflow also shows the changed file list and asks for confirmation before syncing.

Why does the Nexus update fail with uncommitted changes?

The sync refuses to run when your Git working tree has uncommitted changes to prevent data loss. Commit them first with git add . && git commit -m 'Save changes', then retry the update.

Can I change the upstream repository Nexus syncs from?

Yes, the default upstream URL is https://github.com/beamanalytica/Nexus-v4.git but it can be overridden in user-config.yaml. The upstream remote is added automatically on first use.