blender-toolkit
Blender automation toolkit with CLI for geometry, materials, modifiers, collections, animation retargeting, and WebSocket-based real-time control
Summary
The Blender Toolkit skill equips Claude Code with a comprehensive CLI for automating Blender tasks including geometry creation, material assignment, modifier application, collection management, animation retargeting, and real-time control via WebSocket.
- It streamlines 3D workflows directly from the command line, saving time for artists and developers.
Overview
[Website →](https://dev-gom.github.io/claude-code-marketplace/)
Version: 2.31.0 | Last Updated: 2025-12-02
⚠️ Important Notice (>= v2.0.17)
There is a known issue where hook logs stack in the chat window. Until this is resolved, PostToolUse hook outputs are hidden using
suppressOutput: truein hooks.json. Stop hook messages can be controlled via.plugin-config/[plugin-name].jsonwith"showLogs": false(default). Set totrueto enable. See Configuration for details.
A collection of powerful productivity plugins for Claude Code to automate common development workflows.
Included Plugins
1. 🔄 Git Auto-Backup
<details> <summary><strong>📖 Plugin Details</strong> (Click to expand)</summary>
Automatically creates git commits after each Claude Code session to prevent work loss.
[Read Full Documentation →](plugins/hook-git-auto-backup/README.md)
</details>
2. 📋 TODO Collector
<details> <summary><strong>📖 Plugin Details</strong> (Click to expand)</summary>
Scans your entire project and collects all TODO, FIXME, HACK, XXX, NOTE, and BUG comments into a detailed report.
[Read Full Documentation →](plugins/hook-todo-collector/README.md)
</details>
3. 📊 Code Complexity Monitor
<details> <summary><strong>📖 Plugin Details</strong> (Click to expand)</summary>
Monitors code complexity metrics and warns when thresholds are exceeded.
[Read Full Documentation →](plugins/hook-complexity-monitor/README.md)
</details>
4. 📝 Auto Documentation Generator
<details> <summary><strong>📖 Plugin Details</strong> (Click to expand)</summary>
Automatically scans and documents your project structure with directory tree, scripts, and dependencies.
[Read Full Documentation →](plugins/hook-auto-docs/README.md)
</details>
5. 📊 Session File Tracker
<details> <summary><strong>📖 Plugin Details</strong> (Click to expand)</summary>
Tracks all file operations during a session and generates a summary report with directory tree visualization.
[Read Full Documentation →](plugins/hook-session-summary/README.md)
</details>
6. 🤖 AI Pair Programming Suite
<details> <summary><strong>📖 Plugin Details</strong> (Click to expand)</summary>
Complete AI pair programming experience with slash commands, expert agents, and intelligent hooks integrated together.
[Read Full Documentation →](plugins/ai-pair-programming/README.md)
</details>
7. 📋 Spec-Kit Integration
<details> <summary><strong>📖 Plugin Details</strong> (Click to expand)</summary>
GitHub Spec-Kit integration for Specification-Driven Development (SDD). Define WHAT and HOW before coding.
[Read Full Documentation →](plugins/spec-kit/README.md)
</details>
8. 🎮 Unity Dev Toolkit
<details> <summary><strong>📖 Plugin Details</strong> (Click to expand)</summary>
Comprehensive Unity game development toolkit with intelligent scripting assistance, code refactoring, performance optimization, UI Toolkit support, compile error resolution, and test automation.
[Read Full Documentation →](plugins/unity-dev-toolkit/README.md)
</details>
9. 🔧 Claude Dev Helper
<details> <summary><strong>📖 Plugin Details</strong> (Click to expand)</summary>
Development assistant with auto-open files, git diff review, and enhanced workflow integration with VS Code Extension.
[Read Full Documentation →](plugins/claude-dev-helper/README.md)
</details>
10. 🔔 Sound Notifications
<details> <summary><strong>📖 Plugin Details</strong> (Click to expand)</summary>
Audio notifications for Claude Code hook events with customizable sounds and volume control.
[Read Full Documentation →](plugins/hook-sound-notifications/README.md)
</details>
11. 🚀 Auto Release Manager
<details> <summary><strong>📖 Plugin Details</strong> (Click to expand)</summary>
Automate version updates and releases for any project type with intelligent detection and cross-platform support.
[Read Full Documentation →](plugins/auto-release-manager/README.md)
</details>
12. 🌐 Browser Pilot
<details> <summary><strong>📖 Plugin Details</strong> (Click to expand)</summary>
Chrome DevTools Protocol (CDP) based browser automation, web scraping, and crawling for Claude Code.
[Read Full Documentation →](plugins/browser-pilot/README.md)
</details>
14. 🎨 Blender Toolkit
<details> <parameter name="summary"><strong>📖 Plugin Details</strong> (Click to expand)</summary>
⚠️ Experimental Plugin - Blender automation toolkit with CLI-based geometry creation, materials, modifiers, collections, animation retargeting, and WebSocket-based real-time control.
[Read Full Documentation →](plugins/blender-toolkit/README.md)
</details>
15. 🎮 Unity Editor Toolkit
<details> <summary><strong>📖 Plugin Details</strong> (Click to expand)</summary>
⚠️ Experimental Plugin - Real-time Unity Editor control via WebSocket with SQLite database integration, GUID-based persistence, comprehensive automated testing and security hardening.
[Read Full Documentation →](plugins/unity-editor-toolkit/README.md)
</details>
Installation
Quick Start (Recommended)
- Add the marketplace in Claude Code:
``bash /plugin marketplace add https://github.com/Dev-GOM/claude-code-marketplace.git ``
- Install plugins:
``bash /plugin install hook-git-auto-backup@dev-gom-plugins ` `bash /plugin install hook-todo-collector@dev-gom-plugins ` `bash /plugin install hook-complexity-monitor@dev-gom-plugins ` `bash /plugin install hook-auto-docs@dev-gom-plugins ` `bash /plugin install hook-session-summary@dev-gom-plugins ` `bash /plugin install ai-pair-programming@dev-gom-plugins ` `bash /plugin install spec-kit@dev-gom-plugins ` `bash /plugin install unity-dev-toolkit@dev-gom-plugins ` `bash /plugin install claude-dev-helper@dev-gom-plugins ` `bash /plugin install hook-sound-notifications@dev-gom-plugins ` `bash /plugin install auto-release-manager@dev-gom-plugins ` `bash /plugin install browser-pilot@dev-gom-plugins ` `bash /plugin install unity-editor-toolkit@dev-gom-plugins ``
- Restart Claude Code to load the plugins:
``bash claude # or claude -r # Resume last session # or claude -c # Continue in current directory ``
- Check plugin installation:
``bash /plugin ``
Local Installation (For Development)
- Clone this repository and navigate to it
- Add the local marketplace:
``bash /plugin marketplace add dev-gom-plugins ./path/to/.claude-plugin/marketplace.json ``
- Install plugins as shown above
Usage
Once installed, the plugins work automatically:
- •Git Auto-Backup: Commits after each Claude session ends
- •TODO Collector: Scans and reports TODOs when session ends
- •Complexity Monitor: Checks code after Edit/Write operations
- •Auto-Docs: Updates documentation when session ends
- •Session File Tracker: Summarizes file operations when session ends
- •AI Pair Programming Suite: Provides intelligent assistance with commands, agents, and hooks
- •Spec-Kit Integration: Use
/spec-kit:*commands to guide specification-driven development workflow - •Unity Dev Toolkit: Use
/unity:*commands, invoke expert agents with@unity-*, and get automatic script validation through Agent Skills - •Claude Dev Helper: Automatically reviews git diffs, stages changes, and collects feedback; enhanced with VS Code Extension integration
- •Auto Release Manager: Ask Claude to "update version" or "create release" for automated version management and release workflow
Configuration
Plugin-Specific Settings
Each plugin automatically creates a configuration file in .plugin-config/[plugin-name].json when first run. These files are preserved across plugin updates.
Common settings:
- •
showLogs: Control Stop hook log visibility (falseby default to reduce chat clutter)
Example - Enable logs for TODO Collector:
Create or edit .plugin-config/hook-todo-collector.json:
{
"showLogs": true,
"outputDirectory": "",
"supportedExtensions": null,
"excludeDirs": null,
"commentTypes": null,
"outputFormats": null
}For detailed configuration options:
- •[Git Auto-Backup Configuration →](plugins/hook-git-auto-backup/README.md#configuration)
- •[TODO Collector Configuration →](plugins/hook-todo-collector/README.md#configuration)
- •[Complexity Monitor Configuration →](plugins/hook-complexity-monitor/README.md#configuration)
- •[Auto-Docs Configuration →](plugins/hook-auto-docs/README.md#configuration)
- •[Session Tracker Configuration →](plugins/hook-session-summary/README.md#configuration)
- •[AI Pair Programming Configuration →](plugins/ai-pair-programming/README.md#configuration)
- •[Spec-Kit Documentation →](plugins/spec-kit/README.md)
- •[Claude Dev Helper Documentation →](plugins/claude-dev-helper/README.md)
Quick Examples
Disable a specific plugin:
/plugin uninstall hook-git-auto-backup@dev-gom-pluginsEnable hook logs for a specific plugin: Edit .plugin-config/[plugin-name].json and set "showLogs": true
Customize complexity thresholds: See Complexity Monitor Configuration
Add custom TODO patterns: See TODO Collector Configuration
Output Files
The plugins generate the following files in your project root:
- •
.todos-report.md- Detailed TODO report - •
.todos.txt- Simple TODO list - •
.complexity-log.txt- Complexity issues log - •
.project-structure.md- Project structure documentation - •
.session-summary.md- Session file operations summary - •
.pair-programming-session.md- AI pair programming session report
Plugin configuration files (auto-generated in project root):
- •
.plugin-config/- Plugin-specific configuration files (preserves settings across plugin updates)
Tip: Add output files to .gitignore if you don't want to commit them. Configuration files in .plugin-config/ should be committed to share settings with your team:
# Plugin output files
.todos-report.md
.complexity-log.md
.project-structure.md
.structure-state.json
.structure-changes.json
.session-summary.md
.pair-programming-session.md
.state/
# Optional: Uncomment to exclude plugin configs (if you don't want to share settings)
# .plugin-config/Requirements
- •Claude Code CLI
- •Node.js (for running plugin scripts)
- •Git (for git-auto-backup plugin)
Troubleshooting
Plugins not running?
- Check plugin installation:
``bash /plugin ``
- Verify hooks are enabled in settings
- Check Node.js is in PATH:
``bash node --version ``
Git commits not working?
- Ensure you're in a git repository:
``bash git status ``
- Check git is configured:
``bash git config user.name git config user.email ``
Complexity monitor showing false positives?
Adjust thresholds in the plugin configuration file to match your project's needs.
Development
For Plugin Developers
Each plugin has detailed technical documentation in its README:
- •Git Auto-Backup Technical Details
- •TODO Collector Technical Details
- •Complexity Monitor Technical Details
- •Auto-Docs Technical Details
- •Session Tracker Technical Details
- •AI Pair Programming Technical Details
- •Spec-Kit Integration Guide
- •Claude Dev Helper Technical Details
Contributing
Feel free to customize these plugins for your needs:
- Fork/copy the
.claude-plugindirectory - Modify plugin scripts in
plugins/[plugin-name]/ - Update
plugin.jsonif changing hook behavior - Test with
/plugin validate .claude-plugin
License
Apache License 2.0 - see LICENSE and NOTICE for details.
Credits
Created for Claude Code to enhance developer productivity through automation.
Happy Coding! 🚀
For issues or suggestions, please open an issue on GitHub.
Install & Usage
/plugin marketplace add <org/repo>Add the configuration to /plugin install blender-toolkit@<marketplace>
/pluginUse Cases
Usage Examples
/blender-toolkit create cube --size 2 --location 0 0 0 --material 'Red'
/blender-toolkit retarget --source mixamo_anim.fbx --target my_rig.blend --output retargeted.fbx
/blender-toolkit modifier add --object 'Suzanne' --type subdivision --levels 2
Security Audits
Frequently Asked Questions
What is blender-toolkit?
The Blender Toolkit skill equips Claude Code with a comprehensive CLI for automating Blender tasks including geometry creation, material assignment, modifier application, collection management, animation retargeting, and real-time control via WebSocket. It streamlines 3D workflows directly from the command line, saving time for artists and developers.
How to install blender-toolkit?
To install blender-toolkit: add a marketplace (/plugin marketplace add <org/repo>), then add the config to /plugin install blender-toolkit@<marketplace>. Finally, /plugin in Claude Code.
What is blender-toolkit best for?
blender-toolkit is a plugin categorized under General. It is designed for: blender, 3d, animation, rigging, retargeting, mixamo, websocket, automation. Created by Dev GOM.
What can I use blender-toolkit for?
blender-toolkit is useful for: Automatically generate and modify 3D geometry (meshes, curves, etc.) using CLI commands without opening Blender's GUI.; Apply and adjust modifiers (subdivision, boolean, array) to multiple objects in batch for rapid prototyping.; Retarget Mixamo animations onto custom rigs with a single command, reducing manual re-rigging effort.; Manage Blender collections and materials programmatically to organize complex scenes for rendering or export.; Control Blender in real-time via WebSocket for live collaboration or integration with other tools.; Automate repetitive tasks like UV unwrapping, vertex painting, or object duplication across hundreds of assets..