Frappe Claude

Install Frappe Claude

bench get-app https://github.com/UnityAppSuite/frappe-claude

Add the Frappe Gems badge to your README

Maintain Frappe Claude? Paste this into your README:

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=UnityAppSuite%2Ffrappe-claude)](https://frappegems.com/gems/apps/UnityAppSuite/frappe-claude)

About Frappe Claude

Frappe Claude — Plugin Marketplace

A Claude Code plugin marketplace for Frappe Framework and ERPNext development. This repository contains one or more plugins optimized for Frappe/ERPNext workflows.

Available Plugins

Plugin Description
frappe-fullstack Comprehensive full-stack development with DocType scaffolding, bench integration, hooks, a bench-error-log monitor, and specialized agents for backend, classic frontend, React SPA, React Native, ERPNext customization, debugging, planning, and Git workflows

Installation

# Clone this marketplace
git clone https://github.com/UnityAppSuite/frappe-claude.git

# Add the marketplace (inside Claude Code)
/plugin marketplace add ./frappe-claude

# Install the plugin
/plugin install frappe-fullstack@frappe-claude

On first install you will be prompted for bench_path, default_site, and (optionally) python_path. These values are reused by the plugin's hooks and the bench-error-log monitor.

Marketplace Structure

frappe-claude/
├── .claude-plugin/
│   └── marketplace.json          # Marketplace manifest
├── plugins/
│   └── frappe-fullstack/         # Full-stack Frappe plugin
│       ├── .claude-plugin/
│       │   └── plugin.json
│       ├── agents/               # 11 specialized agents
│       ├── commands/             # 9 user-typed slash commands
│       ├── skills/               # 13 model-invoked skills
│       ├── hooks/hooks.json      # SessionStart + PostToolUse
│       ├── monitors/monitors.json# Background bench-error-log tail
│       └── scripts/              # Hook scripts
└── README.md

Plugins Overview

frappe-fullstack

A comprehensive plugin for Frappe/ERPNext development featuring:

  • 11 Agentsdoctype-architect, frappe-backend, frappe-frontend, frappe-custom-frontend, react-spa-frontend, react-native-frontend, erpnext-customizer, frappe-debugger, frappe-reviewer, frappe-planner, github-workflow
  • 9 Slash Commands/frappe-fullstack (multi-agent orchestrator), /frappe-plan, /frappe-doctype-create, /frappe-doctype-field, /frappe-app, /frappe-bench, /frappe-test, /frappe-perf, /frappe-github
  • 13 Skillsbench-commands, client-scripts, doctype-patterns, frappe-api, react-native-patterns, react-spa-patterns, server-scripts, frappe-debug, frappe-review, workflow-patterns, print-format, testing-patterns, scheduler-and-jobs
  • Hooks — auto-format Python files inside the bench on save; remind to bench migrate after DocType JSON or hooks.py edits; inject bench/site context at session start
  • Monitors — tails web.error.log + worker.error.log and a filtered web.log (warnings, errors, 4xx/5xx, slow requests) whenever the frappe-debug skill is invoked, so the debugger agent sees both errors and problem requests live

Git Workflow Conventions

  • Branch naming: {type}/{task-id}-{description} (e.g., feature/123-payment-api)
  • Clean commits without co-author or generated footers
  • PR creation with proper formatting

View full documentation

Adding New Plugins

Per the current plugin spec, skills/ (with /SKILL.md) is preferred over commands/ for new component-style plugins; commands/ is reserved for user-typed entry points.

  1. Create a directory under plugins/:
    plugins/my-plugin/
    ├── .claude-plugin/
    │   └── plugin.json     # Manifest (name required, version optional)
    ├── skills/             # Model-invoked SKILL.md folders
    ├── commands/           # User-typed slash commands (.md)
    ├── agents/             # Subagent definitions (.md with frontmatter)
    ├── hooks/hooks.json    # Optional event handlers
    └── monitors/monitors.json  # Optional background watchers
    
  2. Add an entry to .claude-plugin/marketplace.json.
  3. Validate with claude plugin validate ..
  4. Submit a pull request.

Omit version from plugin.json if you want every commit to ship to users automatically (uses git SHA). Pin a version only if you intend to bump it on every release.

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Add or modify plugins
  4. Run claude plugin validate .
  5. Test with claude --plugin-dir ./plugins/
  6. Submit a pull request

License

MIT License

Resources

Related Developer Tools apps for Frappe & ERPNext

  • Frappe — Low code web framework for real world applications, in Python and Javascript
  • Frappe Docker — Docker environment for developing, deploying, and running Frappe applications (ERPNext and custom apps) in production and development
  • Builder — Craft beautiful websites effortlessly with an intuitive visual builder and publish them instantly
  • Bench — CLI to manage Multi-tenant deployments for Frappe apps
  • Frappe Ui — A set of components and utilities for rapid UI development
  • Press — Full service cloud hosting for the Frappe stack - powers Frappe Cloud
  • Gameplan — Open Source Discussions Platform for Remote Teams
  • Doppio — A Frappe app (CLI) to magically setup single page applications and Vue/React powered desk pages on your custom Frappe apps.