К основному содержанию
плагин CX Codex

frappe-agent — плагин для Frappe и ERPNext

Подсказки по Frappe Framework и ERPNext для ИИ-ассистента: bench, DocType, SQL, слои кастомизации и приложения экосистемы.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install frappe-agent@awesome-codex-plugins
Открыть на GitHub

Что делает frappe-agent

Плагин добавляет ассистенту знания по Frappe Framework и ERPNext. Внутри скиллы frappe-fullstack, frappe-backend, frappe-frontend, frappe-bench, frappe-sql, frappe-customization, frappe-doctype-design и отдельные на каждое приложение экосистемы: Helpdesk, CRM, LMS, Gameplan, Drive, HRMS, Insights, Builder, Payments.

Разделение по приложениям помогает не мешать слои: правка через Custom Field или Property Setter остаётся кастомизацией, а не патчем ядра. Перед установкой приложения, миграцией или сменой окружения ассистент сначала разбирает состояние bench.

Для Codex нужен клон репозитория на диске: codex marketplace add /path/to/frappe-agent принимает путь, после этого плагин включают и перезапускают Codex в новой сессии. В Claude установка идёт из маркетплейса, без локальной копии.

Какие задачи решает

  • Отделить кастомизацию от правки ядра в приложении Frappe
  • Разложить поля и вкладки нового DocType, отметить обязательные
  • Выбрать сырой SQL или ORM для конкретного запроса
  • Проверить состояние bench перед установкой приложения и миграцией
  • Собрать отчёт или дашборд под модуль ERPNext

Примеры запросов агенту

  • Проверь bench перед миграцией и скажи, что может сломаться
  • Через frappe-doctype-design разложи поля нового DocType по вкладкам и разделам
  • Это лучше сделать в Server Script или вынести в отдельное приложение?

Как установить frappe-agent

Через маркетплейс плагинов

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

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о frappe-agent

Как установить frappe-agent в Claude Code?

Выполните /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install frappe-agent@awesome-codex-plugins. Если Claude уже открыт, плагины перезагружают командой /reload-plugins.

Что делает frappe-agent?

Даёт ассистенту контекст Frappe Framework и ERPNext: backend, frontend, работу с bench, выбор между SQL и ORM, проектирование DocType и приложения экосистемы от Helpdesk до Payments.

Работает ли плагин в Codex?

Да, но через локальный клон: добавьте его командой codex marketplace add /path/to/frappe-agent, включите плагин в Codex и перезапустите его в новой сессии.

Исходный текст

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

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
frappe-app-dev frappe Скилл frappe-app-dev для Claude Code помогает запускать и менять приложения Frappe через Pilot. Подключается перед работой с репозиторием, где есть hooks.py и DocTypes: от ревью кода до тестового сайта для PR. CX Codex +1 1 400установок Frappe Dev MCP Server SajmustafaKe Frappe Dev MCP Server — MCP-сервер для Claude Code, автоматизирующий разработку в экосистеме Frappe/ERPNext. Скилл ускоряет создание DocType и управление bench-командами прямо из интерфейса ИИ-агента. CX Codex +1 ★ 5звёзд репо frappe-code-review frappe Скилл frappe-code-review для Claude Code проверяет приложения Frappe по чек-листу: сначала корректность и стабильность, затем безопасность и производительность. Его применяют к дифу, PR или отдельному файлу. CX Codex +1 546установок Pacioli — the ERPNext broker you can hand the books john-broadway MCP-сервер Pacioli — the ERPNext broker you can hand the books для Claude Code открывает агенту управляемый доступ к ERPNext через MCP и A2A. Он связывает запросы агента с учётной системой. CX Codex +1 ★ 8звёзд репо erpnext membrane Читает, создаёт и обновляет документы в ERPNext — open-source ERP для учёта, производства и CRM. CX Codex +1 224установок Black Book — Dirt Track Database lylegill02 MCP-сервер Black Book — Dirt Track Database для Claude Code предоставляет данные о грунтовых автодромах Северной Америки: параметры почвы, геометрию поворотов и рекомендации по настройке шасси. CX Codex +1 342установок

Из того же набора391

Весь набор →
graymatter Плагин graymatter подключает долговременную память и общее контекстное хранилище для агентов Claude Code и Codex через протокол MCP. CX Codex ★ 1 596звёзд репо codex-goal-progress Плагин codex-goal-progress показывает прогресс по цели Codex и расход токенов. Для каждой новой цели его нужно включать отдельно. CX Codex ★ 1 596звёзд репо generative-media-skills Плагин generative-media-skills даёт агенту 13 скиллов, через которые он делает картинки, видео и музыку на 100+ моделях — от FLUX до Suno. CX Codex ★ 1 596звёзд репо gcf-proxy Плагин gcf-proxy перехватывает ответы MCP-серверов в JSON и сжимает их в формат GCF, сокращая расход токенов контекста. CX Codex ★ 1 596звёзд репо figma-maxxing Плагин figma-maxxing для Claude Code и Codex включает восемь скиллов для правки файлов Figma: проверки до записи, чтение свойств после неё и разбор комментариев. CX Codex ★ 1 596звёзд репо falsegreen-skill Плагин falsegreen-skill находит ложнозелёные тесты в Python, TypeScript, JavaScript и Robot Framework, проверяя их по структуре и смыслу через LLM. CX Codex ★ 1 596звёзд репо espresso Плагин espresso для Claude Code и Codex задаёт краткий стиль ответов и добавляет Ponytail для сокращения лишнего кода. Используется для исследования проекта и небольших правок. CX Codex ★ 1 596звёзд репо emulo Плагин emulo извлекает привычки кодинга из сырых логов ваших сессий и превращает их в персональный профиль с цитатами ваших же сообщений. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой