zsh-config-manager

Organize modular zsh configurations with OS-specific alternates and YADM version control.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/knowledgexhunta/devops-toolkit --skill zsh-config-manager-knowledgexhunta
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zsh-config-manager
Source: https://github.com/knowledgexhunta/devops-toolkit/tree/main/plugins/devops-toolkit/skills/zsh-config-manager
Command: npx skills add https://github.com/knowledgexhunta/devops-toolkit --skill zsh-config-manager-knowledgexhunta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It organizes and simplifies the maintenance of modular zsh configurations across multiple operating systems by centralizing components under ~/.zshrcd/, enabling automatic sourcing and version control via yadm.

Core Features & Use Cases

  • Modular conf.d files auto-sourced into the shell environment
  • OS-specific alternates using conf.d files with ##os markers
  • YADM-based tracking and version control for safe, auditable changes
  • Lightweight, one-component-per-file approach to incremental configuration
  • Quick customization and deployment across machines

Quick Start

Create a new tool configuration under ~/.zshrcd/conf.d/ and track it with yadm.

Frequently Asked Questions about zsh-config-manager

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

FAQPage Schema
How do I manage modular zsh configurations across different operating systems?▼

Modular zsh configurations are managed by organizing files under a central ~/.zshrcd/ directory and using YADM for version control, enabling automatic sourcing and OS-specific alternates via filename markers.

What is the best way to version control dotfiles across multiple OS environments?▼

The best way to version control dotfiles across multiple OS environments is using YADM to track your modular shell configuration. This provides safe, auditable change tracking and supports OS-specific alternates out of the box.

Can I use OS-specific zsh settings without maintaining separate configuration files?▼

Yes, you can apply OS-specific zsh settings within the same configuration tree by using YADM's alternates feature. This relies on ##os markers in your conf.d filenames to automatically load the correct environment settings.

How does automatic sourcing work for modular shell configurations?▼

Automatic sourcing works by placing individual component files into a designated conf.d directory. The shell environment automatically loads these one-component-per-file scripts upon startup, allowing incremental configuration without editing a single large file.

Do I need YADM to track changes across multi-OS workstation configurations?▼

Using YADM is required by this setup to track changes across multi-OS workstation configurations safely. It provides the version control and OS-specific alternate file handling needed for reliable, auditable modular management.