A comprehensive Claude Code plugin for Frappe Framework development with 95% SDLC coverage - 15 commands, 10 agents, and 15 skills for complete Frappe/ERPNext development lifecycle.
Install in 2 commands:
/plugin marketplace add Venkateshvenki404224/frappe-apps-manager
/plugin install frappe-apps-manager@Venkateshvenki404224Then restart Claude Code and run /help to see all 15 Frappe commands!
The Frappe Apps Manager plugin extends Claude Code with specialized capabilities for building, deploying, and maintaining Frappe applications. Whether you're creating new apps, designing DocTypes, debugging issues, or deploying to production, this plugin provides expert assistance at every step.
What's New in v2.0.0:
- 🆕 8 new commands (site management, testing, debugging, operations)
- 🆕 7 new agents (testing, security, devops, performance, integration, data, UI/UX)
- 🆕 12 new skills (client scripts, tests, workflows, webhooks, migrations, and more)
- 🆕 Frappe conventional commit output style
- 🆕 Enhanced hooks with smart automation
- ⭐ All components reference real ERPNext/Frappe core code
- ⭐ 120+ core app references, 175+ working code examples
Site & Environment:
/frappe-new-site🆕 - Create new Frappe site with database setup/frappe-config🆕 - Manage site configuration and settings/frappe-db-reset🆕 - Reset database for development
Development & Testing:
/frappe-new-app- Create new Frappe application/frappe-new-doctype- Create new DocType/frappe-test🆕 - Run tests with coverage reports/frappe-console🆕 - Interactive Python console
Operations & Debugging:
/frappe-logs🆕 - View and analyze bench logs/frappe-cache🆕 - Manage Redis cache/frappe-role-manager🆕 - Manage roles and permissions/frappe-backup- Backup site data/frappe-migrate- Run database migrations
Deployment:
/frappe-install-app- Install app to site/frappe-bench-start- Start development server/frappe-deploy- Deploy to production
Strategic & Development:
- frappe-architect - System design and architecture
- frappe-developer - Implementation and coding
- frappe-ui-ux 🆕 - Frontend and user experience
Quality & Security:
- frappe-tester 🆕 - Testing strategies and QA
- frappe-security 🆕 - Security review and compliance
- frappe-performance 🆕 - Performance optimization
Operations & Integration:
- frappe-devops 🆕 - CI/CD and deployment
- frappe-debugger - Troubleshooting and diagnostics
- frappe-integration 🆕 - API and webhook integration
- frappe-data-engineer 🆕 - Data migration and management
Core Development:
- frappe-doctype-builder - Generate DocType JSON structures
- frappe-api-handler - Create REST API endpoints
- frappe-client-script-generator 🆕 - JavaScript form scripts (10 patterns)
- frappe-report-generator - Custom reports and analytics
Testing & Quality:
- frappe-unit-test-generator 🆕 - Unit test generation
- frappe-integration-test-generator 🆕 - Integration test scenarios
Workflows & States:
- frappe-workflow-generator 🆕 - Approval workflows
- frappe-state-machine-helper 🆕 - State transition logic
Integration & Data:
- frappe-webhook-manager 🆕 - Webhook handlers
- frappe-external-api-connector 🆕 - External API clients
- frappe-data-migration-generator 🆕 - Data migration scripts
- frappe-fixture-creator 🆕 - Test and master data fixtures
Optimization & UX:
- frappe-performance-optimizer 🆕 - Query and cache optimization
- frappe-web-form-builder 🆕 - Public web forms
- frappe-documentation-generator 🆕 - API documentation
- frappe-commit 🆕 - Frappe conventional commit standard with semantic versioning
Smart automation for common tasks:
- frappe-context-detector - Detects Frappe bench directory
- frappe-auto-migrate - Reminds to run migrations after DocType changes
- frappe-bench-validator - Validates bench setup
- frappe-test-file-validator 🆕 - Validates test file locations
- frappe-test-reminder 🆕 - Reminds to run tests after code changes
- frappe-cache-clear-reminder 🆕 - Suggests cache clear after JS changes
- frappe-site-check 🆕 - Verifies site exists for operations
# 1. Add the marketplace
/plugin marketplace add Venkateshvenki404224/frappe-apps-manager
# 2. Install the plugin
/plugin install frappe-apps-manager@Venkateshvenki404224
# 3. Restart Claude Code
# 4. Verify installation
/help # Should show all 15 Frappe commands
# 5. Try it out!
/frappe-new-siteFull GitHub URL:
/plugin marketplace add https://github.com/Venkateshvenki404224/frappe-apps-manager
/plugin install frappe-apps-manager@Venkateshvenki404224Local Development:
git clone https://github.com/Venkateshvenki404224/frappe-apps-manager.git
/plugin marketplace add ./frappe-apps-manager
/plugin install frappe-apps-manager@frappe-apps-managerTeam Auto-Install:
Add to your project's .claude/settings.json:
{
"pluginMarketplaces": [{
"name": "frappe-marketplace",
"source": "Venkateshvenki404224/frappe-apps-manager"
}],
"plugins": [{
"name": "frappe-apps-manager",
"marketplace": "frappe-marketplace",
"enabled": true
}]
}Team members who trust the repository will get the plugin automatically!
- Claude Code installed
- Frappe Framework knowledge (basic to intermediate)
- A Frappe bench for testing (recommended)
/frappe-new-appClaude will guide you through:
- App naming and configuration
- Module setup
- Installation to a site
- Next steps for development
/frappe-new-doctypeOr simply ask Claude:
"Create a Customer DocType with name, email, and phone fields"
Claude will automatically use the frappe-doctype-builder Skill to generate complete DocType JSON and controller files.
Ask Claude to create APIs:
"Create an API endpoint to get customer details by email"
Claude will use the frappe-api-handler Skill to generate secure, whitelisted methods with proper validation and error handling.
Request custom reports:
"Create a sales analysis report grouped by customer"
Claude will use the frappe-report-generator Skill to create query or script reports with filters, charts, and summaries.
When you encounter errors:
"I'm getting a permission error when submitting Sales Orders"
Claude can invoke the Frappe Debugger agent to analyze logs, check permissions, and provide solutions.
/frappe-deployClaude will guide you through:
- Pre-deployment checklist
- Backup creation
- Migration execution
- Service restart
- Post-deployment verification
frappe-marketplace/
├── .claude-plugin/
│ └── marketplace.json
└── frappe-apps-manager/
├── .claude-plugin/
│ └── plugin.json
├── commands/ # 7 custom commands
│ ├── frappe-new-app.md
│ ├── frappe-install-app.md
│ ├── frappe-bench-start.md
│ ├── frappe-migrate.md
│ ├── frappe-backup.md
│ ├── frappe-new-doctype.md
│ └── frappe-deploy.md
├── agents/ # 3 specialized agents
│ ├── frappe-developer.md
│ ├── frappe-debugger.md
│ └── frappe-architect.md
├── skills/ # 3 agent Skills
│ ├── frappe-doctype-builder/
│ │ └── SKILL.md
│ ├── frappe-api-handler/
│ │ └── SKILL.md
│ └── frappe-report-generator/
│ └── SKILL.md
└── hooks/ # Automated workflows
└── hooks.json
-
Navigate to your bench:
cd /path/to/frappe-bench claude -
Create a new app:
/frappe-new-app
-
Build your DocTypes:
"Create a Project DocType with fields for project name, start date, end date, and status"
-
Add business logic:
"Add validation to ensure end date is after start date"
-
Create APIs:
"Create an API to get all active projects"
-
Generate reports:
"Create a report showing projects by status"
-
Test and debug:
"Why am I getting a validation error when saving projects?"
-
Deploy:
/frappe-deploy
Use Commands when:
- You want guided, step-by-step workflows
- You're performing standard operations (backup, migrate, deploy)
- You want consistent, repeatable processes
Use Agents when:
- You need expert consultation on architecture
- You're debugging complex issues
- You want detailed code review or optimization suggestions
Skills are invoked automatically by Claude when appropriate. You don't need to explicitly call them. Just describe what you want:
DocType Building:
"I need a Customer DocType with contact details and credit limit"
API Creation:
"Create an endpoint to update customer email addresses"
Report Generation:
"Show me monthly sales trends by product category"
-
Verify installation:
/plugin
Check that
frappe-apps-managerappears in the installed plugins list. -
Check marketplace:
/plugin marketplace list
Ensure
frappe-marketplaceis added. -
Restart Claude Code
After installing the plugin, you may need to restart Claude Code for commands to appear in /help.
Hooks run based on specific conditions. Check:
- Are you in a Frappe bench directory?
- Are you using the relevant tools (Bash, Write, Edit)?
- Check hook configuration in
hooks/hooks.json
Example: Building a complete module
-
Plan the architecture:
"I want to build a project management module. Help me design the DocTypes and their relationships."
(Claude invokes Frappe Architect agent)
-
Create the app:
/frappe-new-app
-
Build DocTypes:
"Create the DocTypes we discussed"
(Claude uses frappe-doctype-builder Skill)
-
Add APIs:
"Create APIs for project CRUD operations"
(Claude uses frappe-api-handler Skill)
-
Build reports:
"Create a project timeline report"
(Claude uses frappe-report-generator Skill)
-
Test:
/frappe-bench-start
-
Deploy:
/frappe-deploy
You can extend this plugin by:
- Adding more commands - Create
.mdfiles incommands/ - Creating new agents - Add agent definitions in
agents/ - Building Skills - Create new Skills in
skills/ - Configuring hooks - Modify
hooks/hooks.json
See Claude Code Plugin Documentation for details.
Contributions are welcome! To contribute:
- Fork the repository
- Create a feature branch
- Add your enhancements
- Test thoroughly with a Frappe bench
- Submit a pull request
# Clone the marketplace
git clone <repository-url>
cd frappe-marketplace
# Make changes to the plugin
cd frappe-apps-manager
# Test locally
cd ../..
claude
/plugin marketplace add ./frappe-marketplace
/plugin install frappe-apps-manager@frappe-marketplace- Initial release
- 7 custom commands
- 3 specialized agents
- 3 agent Skills
- Automated hooks for common workflows
- Documentation: Frappe Framework Docs
- Plugin Issues: Create an issue in the repository
- Claude Code Help:
/helpcommand or Claude Code Docs
Q: Do I need a running Frappe bench to use this plugin? A: While many features work without a bench, having a test bench provides the best experience for testing commands and validating generated code.
Q: Can I use this with ERPNext? A: Yes! ERPNext is built on Frappe Framework, so all these tools work seamlessly with ERPNext development.
Q: Will this work with Frappe Cloud?
A: Most development features work locally. For deployment, adjust the /frappe-deploy workflow for Frappe Cloud's deployment process.
Q: Can I use this for Frappe version X? A: This plugin is designed to work with modern Frappe versions (v13+). Some features may need adjustments for older versions.
MIT License - See LICENSE file for details
- Frappe Framework team for the amazing framework
- Anthropic for Claude and Claude Code
- Frappe community for development best practices
Happy Frappe Development! 🚀
Built with ❤️ for the Frappe community