Skip to main content
plugin CX Codex

frappe-agent — Claude Code plugin: what it does, how to install

Frappe and ERPNext guidance for a coding assistant: bench checks, DocType design, SQL choices, customization layers and ecosystem apps.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install frappe-agent@awesome-codex-plugins
Open on GitHub

What frappe-agent does

frappe-agent supplies Frappe Framework and ERPNext context to a coding assistant. Its skills cover frappe-fullstack, frappe-backend, frappe-frontend, frappe-bench, frappe-sql, frappe-customization, frappe-doctype-design, plus one per ecosystem app: Helpdesk, CRM, LMS, Gameplan, Drive, HRMS, Insights, Builder, Payments.

Keeping the apps apart matters. A Client Script or Property Setter stays in the customization layer rather than turning into a core patch, and bench state gets inspected before an install, a migration or an environment change.

Codex wants a clone on disk: codex marketplace add /path/to/frappe-agent takes that path, then you enable the plugin and restart Codex in a fresh session. Claude installs from the marketplace instead.

What it helps with

  • Map where customization ends and core patching begins in a Frappe app
  • Lay out fields, tabs and required flags for a new DocType
  • Pick raw SQL or ORM calls for a query
  • Check bench state before installing an app or running a migration
  • Build a report or dashboard against an ERPNext module

Example prompts for the agent

  • Check the bench before I run a migration and tell me what could break
  • Use frappe-doctype-design to lay out tabs and required fields for a new DocType
  • Should this live in a Server Script or in a custom app?

How to install frappe-agent

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install frappe-agent@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about frappe-agent

How do I install frappe-agent in Claude Code?

Run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install frappe-agent@awesome-codex-plugins. Reload plugins with /reload-plugins if Claude is already open.

What does frappe-agent do?

It gives a coding assistant Frappe Framework and ERPNext context: backend and frontend work, bench operations, SQL versus ORM, DocType design, and ecosystem apps from Helpdesk to Payments.

Does frappe-agent work with Codex?

Yes, through a local clone. Add it with codex marketplace add /path/to/frappe-agent, enable the plugin from that marketplace, then restart Codex in a fresh session.

Source text

frappe-agent · MIT
# Frappe Agent

[![HOL Trust Score](https://img.shields.io/endpoint?url=https%3A%2F%2Fhol.org%2Fapi%2Fregistry%2Fbadges%2Fplugin%3Fslug%3Ddhairya-marwaha%252Ffrappe-agent%26metric%3Dtrust%26style%3Dflat)](https://hol.org/registry/plugins/dhairya-marwaha%2Ffrappe-agent)
[![HOL Security](https://img.shields.io/endpoint?url=https%3A%2F%2Fhol.org%2Fapi%2Fregistry%2Fbadges%2Fplugin%3Fslug%3Ddhairya-marwaha%252Ffrappe-agent%26metric%3Dsecurity%26style%3Dflat)](https://hol.org/registry/plugins/dhairya-marwaha%2Ffrappe-agent)
[![Release](https://img.shields.io/github/v/release/Dkm0315/frappe-agent)](https://github.com/Dkm0315/frappe-agent/releases)
[![License](https://img.shields.io/github/license/Dkm0315/frappe-agent)](./LICENSE)

`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](https://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:

```bash
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:

```bash
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:

```bash
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:

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

Install from a local clone with:

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

For local development:

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

Local repo flow:

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

```text
/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:

```text
/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:

```bash
cp /path/to/frappe-agent/AGENTS.md /path/to/your-frappe-project/AGENTS.md
mkdir -p /path/to/your-frappe-project/.cursor/rules
cp /path/to/frappe-agent/.cursor/rules/frappe-agent.mdc /path/to/your-frappe-project/.cursor/rules/frappe-agent.mdc
mkdir -p /path/to/your-frappe-project/.cursor/commands
cp /path/to/frappe-agent/.cursor/commands/*.md /path/to/your-frappe-project/.cursor/commands/
```

Or use symlinks during development:

```bash
ln -s /path/to/frappe-agent/AGENTS.md /path/to/your-frappe-project/AGENTS.md
mkdir -p /path/to/your-frappe-project/.cursor
ln -s /path/to/frappe-agent/.cursor/rules /path/to/your-frappe-project/.cursor/rules
ln -s /path/to/frappe-agent/.cursor/commands /path/to/your-frappe-project/.cursor/commands
```

Cursor does not currently use the same repo-marketplace plugin install flow here that Claude Code does, so the practical local installation path is still repo-level rules and commands.

### GitHub Copilot

Copilot uses repository custom instructions and agent instructions.

To install the local guidance into a repository:

```bash
mkdir -p /path/to/your-frappe-project/.github
cp /path/to/frappe-agent/.github/copilot-instructions.md /path/to/your-frappe-project/.github/copilot-instructions.md
cp /path/to/frappe-agent/AGENTS.md /path/to/your-frappe-project/AGENTS.md
```

Or use symlinks during development:

```bash
mkdir -p /path/to/your-frappe-project/.github
ln -s /path/to/frappe-agent/.github/copilot-instructions.md /path/to/your-frappe-project/.github/copilot-instructions.md
ln -s /path/to/frappe-agent/AGENTS.md /path/to/your-frappe-project/AGENTS.md
```

Copilot does not use the same plugin marketplace flow here, so the practical local installation path is repository instructions.

## Releases

GitHub Releases are built by `.github/workflows/release.yml`.

Create a release from a tag:

```bash
git tag v0.1.0
git push upstream v0.1.0
```

Or run the `Release` workflow manually from GitHub Actions and provide a version such as `0.1.0`.

Each release uploads:

- `frappe-agent-{version}.zip`
- `frappe-agent-{version}.tar.gz`
- `frappe-agent-{version}.sha256`

## Usage Examples

Ask a supported AI coding assistant to use the plugin naturally in the prompt:

```text
Use Frappe Agent to inspect this bench before changing anything.
```

```text
Use Frappe Agent to choose the right Frappe customization layer for adding fields to Sales Order.
```

```text
Use Frappe Agent to design a clean DocType layout for a service request workflow.
```

```text
Use Frappe Agent to review whether this Frappe SQL should use frappe.db, frappe.qb, or raw SQL.
```

```text
Use Frappe Agent to decide whether this UI should be a desk page, a www page, a Vue frappe-ui page, or a React SPA.
```

```text
Use Frappe Agent to design a Helpdesk ticket workflow with SLA, assignment, portal, and reporting needs.
```

```text
Use Frappe Agent to plan a Frappe CRM pipeline customization and decide what belongs in CRM versus ERPNext Selling.
```

```text
Use Frappe Agent to improve SEO and form UX for a Frappe Builder landing page.
```

## Repository Layout

```text
frappe-agent/
├── .agents/
│   └── plugins/
│       └── marketplace.json
├── .cursor/
│   ├── commands/
│   │   └── frappe-*.md
│   └── rules/
│       └── frappe-agent.mdc
├── .claude-plugin/
│   ├── marketplace.json
│   └── plugin.json
├── .codex-plugin/
│   └── plugin.json
├── .github/
│   ├── copilot-instructions.md
│   └── workflows/
│       ├── plugin-scan.yml
│       └── release.yml
├── AGENTS.md
├── CLAUDE.md
├── commands/
│   └── frappe-*.md
├── skills/
│   └── frappe-*/
└── README.md
```

## Current Scope

This repository is now:

- a Codex-native plugin package
- a Claude Code-native plugin package
- a Cursor-ready repository rules and commands bundle
- a Copilot-ready repository instructions bundle

Planned future work:

- official Claude marketplace submission
- deeper Copilot instruction coverage

## Design Goals

- Inspect first, mutate second
- Prefer Frappe-native customization surfaces before invasive code changes
- Separate ERPNext configuration work from framework-code work
- Respect bench context, app provenance, and version boundaries
- Help agents make fewer generic Python, JavaScript, SQL, and frontend mistakes in Frappe codebases

## Roadmap

- Add more first-class skills for custom fields, reports, workflows, dashboards, upgrade planning, and additional Frappe ecosystem apps
- Add better source-backed command and flag coverage for Bench
- Add deeper distribution adapters for Claude Code, Cursor, and Copilot
- Add richer repo examples and team onboarding docs

## License

MIT

© Dhairya Marwaha · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Agent setup: memory, context, orchestration →
frappe-app-dev frappe The frappe-app-dev Claude Code skill guides development work in Frappe apps through Pilot. It activates for repositories with hooks.py and DocTypes, including code review, tests, migrations, and PR test sites. CX Codex +1 1,400installs Frappe Dev MCP Server SajmustafaKe Frappe Dev MCP Server is a Claude Code MCP server that streamlines Frappe/ERPNext development tasks. The tool integrates with AI agents to manage DocTypes, run bench commands, and build APIs. CX Codex +1 ★ 5repo stars frappe-code-review frappe frappe-code-review is a Claude Code skill that reviews Frappe apps by checklist, from correctness and stability to security and performance. Apply it to a diff, pull request or single file. CX Codex +1 546installs Pacioli — the ERPNext broker you can hand the books john-broadway Pacioli — the ERPNext broker you can hand the books is an MCP server for Claude Code that connects agents to ERPNext through MCP and A2A. It provides a governed route into the accounting system. CX Codex +1 ★ 8repo stars erpnext membrane A skill for working with ERPNext, an open-source ERP for accounting, manufacturing and CRM. Runs through Membrane CLI and lets you read, create and update ERPNext documents from your agent. CX Codex +1 224installs Black Book — Dirt Track Database lylegill02 Black Book — Dirt Track Database is a Claude Code MCP server with details on North American dirt tracks, including soil metrics, turn geometry, and chassis advice. CX Codex +1 342installs

From the same set391

The whole set →

Project sponsors

Companies that keep this analytics open