Claude Plugin Configuration Manager
Standardizes per-project plugin settings and state management using YAML frontmatter and Markdown files within the .claude directory.
The source repository doesn't declare a license. Check its terms before reusing the code.
Key features
- Standardized YAML frontmatter for structured key-value configuration
- Best practices for secure local state management and gitignore handling
- Seamless integration with bash-based hooks and agent instructions
- Per-project isolation using the .claude directory pattern
- Markdown body support for storing dynamic prompts and context
Use cases
- Maintaining state and task progress for multi-agent coordination swarms
- Enabling or disabling specific plugin hooks without modifying source code
- Defining project-specific validation levels and processing constraints
FAQ
How do I parse these settings in a bash script?
You can use common terminal tools like sed to extract the YAML frontmatter between the triple-dash markers and grep to retrieve specific field values.
Why use the .local.md extension for configurations?
The .local suffix indicates that the file contains environment-specific settings that should not be committed to version control, typically being added to .gitignore.
Can I store large blocks of text in the settings file?
Yes, while the YAML frontmatter is for structured data, the Markdown body is ideal for storing detailed instructions, prompt templates, or documentation.
Where should I store plugin settings in my project?
Settings should be stored in the project root within the .claude/ directory, following the naming convention plugin-name.local.md.
Do I need to restart Claude Code after changing a settings file?
Yes, Claude Code typically requires a restart for changes in configuration files to be recognized by active hooks and plugin sessions.
Related skills
Claude Code Agent Architect
Guides developers through the creation, configuration, and optimization of autonomous subagents for Claude Code plugins.
Developer Tools142,11812 ptsHook Development
Create event-driven automation scripts (hooks) to validate operations, enforce policies, and customize Claude Code workflows.
Developer Tools46,24612 ptsCreate Agent Skills
Provides expert guidance for authoring, structuring, and refining new Claude Code Skills.
Developer Tools2,82412 pts