nushell-config-sync

Sync Nushell configuration files between the repo (os-config/nushell) and the system config path ($nu.config-path). Use when the user wants to push, pull, or diff nushell config files.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

Nushell Config Sync is a specialized utility designed to automate the management of Nushell environment and configuration files. It bridges the gap between local system settings and version-controlled repositories, allowing developers to maintain a consistent shell environment through seamless push, pull, and diff operations for config.nu and env.nu files.

Use Cases

  • Version Control for Shell Configs: Easily track changes to your Nushell setup by syncing system configuration files with a Git-managed repository.
  • Environment Standardization: Quickly deploy a unified Nushell configuration across multiple machines or development environments to ensure workflow consistency.
  • Configuration Auditing: Use the built-in diff functionality to compare current system settings against the repository version to identify and review manual changes before syncing.
  • Safe Configuration Updates: Prevent configuration drift by running diffs before pushing or pulling updates, ensuring that only intended changes are applied to the system.
namenushell-config-sync
descriptionSync Nushell configuration files between the repo (os-config/nushell) and the system config path ($nu.config-path). Use when the user wants to push, pull, or diff nushell config files.

Nushell Config Sync

Synchronizes Nushell configuration files between this repository and the system.

Paths

  • Repo path: os-config/nushell/ in this repository
  • System path: The directory containing $nu.config-path (typically ~/.config/nushell/ on Linux/macOS or %APPDATA%\nushell\ on Windows)

Commands

Push (repo -> system)

Copies config files FROM os-config/nushell/ TO the system Nushell config directory.

python .claude/skills/nushell-config-sync/sync.py push

Pull (system -> repo)

Copies config files FROM the system Nushell config directory TO os-config/nushell/.

python .claude/skills/nushell-config-sync/sync.py pull

Diff (compare repo vs system)

Shows unified diff between repo and system config files.

python .claude/skills/nushell-config-sync/sync.py diff
python .claude/skills/nushell-config-sync/sync.py diff -f config.nu  # specific file

Files Synced

  • config.nu - Main Nushell configuration
  • env.nu - Environment configuration

Usage

When user says:

  • "push nushell config" or "sync config to system" -> run push command
  • "pull nushell config" or "sync config from system" -> run pull command
  • "diff nushell config" or "compare nushell config" -> run diff command

Always run diff before push/pull to show the user what will change.