frappe-agent

Frappe Agent for Codex

frappe-agent is a Codex plugin for Frappe Framework and ERPNext development. It makes Codex more aware of Frappe-specific patterns so it can inspect benches more safely, choose the right customization layer, and avoid generic framework mistakes.

About

A Frappe and ERPNext agent plugin for Codex and Claude Code, with skills for backend, frontend, bench operations, SQL, customization, DocType design, and ERPNext workflows. 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 deciding between configuration, metadata, workflow, and code changes
• 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

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:

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: