Claude Code Plugins
Personal collection of Claude Code plugins for development workflows, extracted from real-world projects and designed for reusability across codebases.
Table of Contents
Overview
This repository serves as a local plugin marketplace for Claude Code, containing four production-ready plugins that enhance development workflows:
- bash-guard - Safety enforcement for shell commands
- format-and-lint - Automated code quality checks
- guardian - Test verification and quality gates
- development-agents - Specialized AI agents for development tasks
All plugins were extracted from the family-assistant and websidian projects, refactored for reusability, and enhanced with comprehensive configuration systems.
Why These Plugins?
These plugins solve real development workflow challenges:
- Prevent mistakes before they happen (bash-guard)
- Maintain code quality automatically (format-and-lint)
- Enforce testing discipline without manual checking (guardian)
- Delegate specialized tasks to focused agents (development-agents)
Quick Start
1. Add the Marketplace
# Local path (for development)
/plugin marketplace add /data/ssd/sync/workspace/src/claude-code-plugins
# Or from git remote
/plugin marketplace add https://github.com/your-username/claude-code-plugins
2. Install Plugins
# Install all plugins
/plugin install bash-guard@werdnum-plugins
/plugin install format-and-lint@werdnum-plugins
/plugin install guardian@werdnum-plugins
/plugin install development-agents@werdnum-plugins
# Or browse and install interactively
/plugin
3. Verify Installation
/plugin list
4. Bootstrap Configuration (Recommended)
Use the /bootstrap-plugins command to automatically configure all plugins:
/bootstrap-plugins
This command will:
- Auto-detect your project type and characteristics
- Ask a few critical configuration questions
- Generate optimal configurations for all plugins
- Set up the marketplace in
.claude/settings.json
5. Manual Configuration (Alternative)
If you prefer manual setup, each plugin works out of the box with sensible defaults. To customize:
# Create project-specific config
mkdir -p .claude
echo '{"bannedCommands": {"enabled": true}}' > .claude/bash-guard.json
# Or create global config
mkdir -p ~/.config/claude-code
echo '{"linting": {"enabled": true}}' > ~/.config/claude-code/format-lint.json
Available Plugins
bash-guard
Category: Safety & Protection
Hook Type: PreToolUse (Bash)
Configuration: bash-guard.json
Prevents dangerous shell commands from executing and enforces best practices. Supports automatic command rewriting and timeout enforcement with suggestion-based feedback.
Key Features:
- Block dangerous commands (rm -rf /, fork bombs, etc.)
- Prevent commits to protected branches (main/master)
- Enforce minimum timeouts for long-running commands
- Block specific commands from running in background
- Auto-fix/Suggestion mode: Suggest command rewrites and timeout adjustments
- Command replacement: Transform problematic commands into safer alternatives
Use Cases:
- Prevent accidental system damage
- Enforce git workflow conventions
- Ensure adequate test timeouts
- Project-specific command restrictions
Full Documentation →
format-and-lint
Category: Code Quality
Hook Type: PostToolUse (Edit/Write)
Configuration: format-lint.json
Automatically format and lint code after edits, providing immediate feedback on code quality issues.
Key Features:
- Python: ruff format, ruff check, basedpyright, ast-grep
- TypeScript/JavaScript: prettier, eslint
- Angular: prettier, eslint for .ts/.html/.css
- File formatters: ensure newline at EOF, trim whitespace
- Informational only (doesn't block)
Use Cases:
- Maintain consistent code style
- Catch type errors immediately
- Enforce project-specific patterns (ast-grep)
- Multi-language projects
Full Documentation →
guardian
Category: Quality Gates
Hook Types: PreToolUse (Bash), Stop
Configuration: guardian.json
Ensures code quality through test verification, pre-commit workflows, and completion validation.