frappe-agent

Frappe Agent

frappe-agent is an AI coding assistant plugin for Frappe Framework, ERPNext, and the broader Frappe ecosystem. It gives Codex, Claude Code, Cursor, GitHub Copilot, and other assistant workflows Frappe-specific guidance for bench inspection, ERPNext customization, DocType design, SQL/ORM decisions, and ecosystem app development.

About

A Frappe and ERPNext agent plugin for AI coding tools, with skills for backend, frontend, bench operations, SQL, customization, DocType design, ERPNext modules, Frappe Helpdesk, Frappe CRM, Frappe LMS, Frappe Gameplan, Frappe Drive, Frappe HRMS, Frappe Insights, Frappe Builder, and Frappe Payments. Live plugin profile: hol.org/registry/plugins/dhairya-marwaha%2Ffrappe-agent

What It Covers

• Frappe full-stack reasoning across backend, frontend, customization, and bench work
• Bench-aware inspection before app installs, migrations, or environment changes
• Frappe-native SQL and ORM guidance
• Customization-layer routing for Custom Field, Property Setter, Client Script, Server Script, Workspace, Web Page, Report, Dashboard, and related surfaces
• DocType form UX guidance for useful fields, tabs, sections, columns, and required-field discipline
• ERPNext-aware guidance for accounting, selling, buying, stock, manufacturing, projects, HR, CRM, support, education, payments, and reporting
• Ecosystem app guidance for Helpdesk, CRM, LMS, Gameplan, Drive, HRMS, Insights, Builder, and Payments
• Frontend guidance for Vue, React, frappe-ui, desk pages, www, and external SPA patterns

Included Skills

• frappe-fullstack
• frappe-backend
• frappe-frontend
• frappe-bench
• frappe-sql
• frappe-customization
• frappe-doctype-design
• frappe-search
• frappe-erpnext
• frappe-helpdesk
• frappe-crm
• frappe-lms
• frappe-gameplan
• frappe-drive
• frappe-hrms
• frappe-insights
• frappe-builder
• frappe-payments

Installation

This repository currently ships:

• a real Codex plugin
• a native Claude Code plugin package and marketplace file
• portable and reusable Cursor rules plus command files
• GitHub Copilot repository instructions

Codex

Codex supports repo marketplaces and local plugin installation.

If you cloned this repository locally, add it as a local marketplace:

codex marketplace add /path/to/frappe-agent

Then enable frappe-agent from the added marketplace in Codex and restart Codex in a fresh session.

Local repo flow:

1. Clone this repository somewhere on disk.
2. Run:

codex marketplace add /path/to/frappe-agent

3. Enable frappe-agent from that marketplace in Codex.
4. Restart Codex.

GitHub repo flow:

1. Clone this repository or open the repo locally.
2. Run:

codex marketplace add /path/to/local/clone/of/frappe-agent

3. Enable frappe-agent and restart Codex.

This repo includes:

• .codex-plugin/plugin.json
• .agents/plugins/marketplace.json

so it can act as a self-contained Codex plugin repository.

Claude Code

Claude Code supports plugins and plugin marketplaces.

This repository now includes:

• .claude-plugin/plugin.json
• .claude-plugin/marketplace.json
• commands/
• skills/

Install from GitHub with:

/plugin marketplace add Dkm0315/frappe-agent
/plugin install frappe-agent@frappe-agent --scope local

Install from a local clone with:

/plugin marketplace add /path/to/frappe-agent
/plugin install frappe-agent@frappe-agent --scope local

For local development:

claude --plugin-dir /path/to/frappe-agent

Local repo flow:

1. Clone this repository locally.
2. In Claude Code, run:

/plugin marketplace add /path/to/frappe-agent
/plugin install frappe-agent@frappe-agent --scope local

3. Run /reload-plugins if Claude is already open.

After updates during a session, reload plugins with:

/reload-plugins

Cursor

Cursor uses repository instructions such as AGENTS.md, .cursor/rules, and .cursor/commands.

This repository now includes:

• AGENTS.md
• .cursor/rules/frappe-agent.mdc
• .cursor/commands/*.md

To install them into a local project repository: