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.