Skip to content

Commit 56c5416

Browse files
Dkm0315Dkm0315
committed
Add Frappe Agent listing
1 parent d7d0eae commit 56c5416

14 files changed

Lines changed: 466 additions & 2 deletions

File tree

‎.agents/plugins/marketplace.json‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -136,6 +136,18 @@
136136
},
137137
"category": "Development & Workflow"
138138
},
139+
{
140+
"name": "frappe-agent",
141+
"source": {
142+
"source": "local",
143+
"path": "./plugins/Dkm0315/frappe-agent"
144+
},
145+
"policy": {
146+
"installation": "AVAILABLE",
147+
"authentication": "ON_INSTALL"
148+
},
149+
"category": "Development & Workflow"
150+
},
139151
{
140152
"name": "hotl",
141153
"source": {

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -112,6 +112,7 @@ Third-party plugins built by the community. [PRs welcome](#contributing)!
112112
- [Codex Agenteam](https://github.com/yimwoo/codex-agenteam) - Specialist AI agents (researcher, PM, architect, developer, QA, reviewer) orchestrated as a configurable team pipeline.
113113
- [Codex Multi Auth](https://github.com/ndycode/codex-multi-auth) - Multi-account OAuth manager for the official Codex CLI with switching, health checks, and recovery tools.
114114
- [Codex Reviewer](https://github.com/schuettc/codex-reviewer) - Second-pass review of Claude-driven plans and implementations.
115+
- [Frappe Agent](https://github.com/Dkm0315/frappe-agent) - Frappe and ERPNext coding, customization, bench, and review intelligence for Codex.
115116
- [HOTL Plugin](https://github.com/yimwoo/hotl-plugin) - Human-on-the-Loop AI coding workflow plugin for Codex, Claude Code, and Cline with structured planning, review, and verification guardrails.
116117
- [Project Autopilot](https://github.com/AlexMi64/codex-project-autopilot) - Turn an idea into a structured project workflow with planning, execution, verification, and handoff.
117118
- [Session Orchestrator](https://github.com/Kanevry/session-orchestrator) - Session orchestration for Claude Code, Codex, and Cursor IDE — structured planning, wave-based execution, VCS integration (GitLab + GitHub), quality gates, and clean session close-out with issue tracking.

‎plugins.json‎

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22
"$schema": "https://json-schema.org/draft/2020-12/schema",
33
"name": "awesome-codex-plugins",
44
"version": "1.0.0",
5-
"last_updated": "2026-05-04",
6-
"total": 55,
5+
"last_updated": "2026-05-06",
6+
"total": 56,
77
"categories": [
88
"Development & Workflow",
99
"Tools & Integrations"
@@ -119,6 +119,16 @@
119119
"source": "awesome-codex-plugins",
120120
"install_url": "https://raw.githubusercontent.com/schuettc/codex-reviewer/HEAD/.codex-plugin/plugin.json"
121121
},
122+
{
123+
"name": "Frappe Agent",
124+
"url": "https://github.com/Dkm0315/frappe-agent",
125+
"owner": "Dkm0315",
126+
"repo": "frappe-agent",
127+
"description": "Frappe and ERPNext coding, customization, bench, and review intelligence for Codex.",
128+
"category": "Development & Workflow",
129+
"source": "awesome-codex-plugins",
130+
"install_url": "https://raw.githubusercontent.com/Dkm0315/frappe-agent/HEAD/.codex-plugin/plugin.json"
131+
},
122132
{
123133
"name": "HOTL Plugin",
124134
"url": "https://github.com/yimwoo/hotl-plugin",

‎plugins/Dkm0315/frappe-agent/.codex-plugin/plugin.json‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
{
2+
"name": "frappe-agent",
3+
"version": "0.1.0",
4+
"description": "Frappe and ERPNext coding, customization, bench, and review intelligence for Codex.",
5+
"author": {
6+
"name": "Dhairya Marwaha",
7+
"email": "dhairya15marwaha@gmail.com",
8+
"url": "https://github.com/Dkm0315"
9+
},
10+
"homepage": "https://github.com/Dkm0315/frappe-agent",
11+
"repository": "https://github.com/Dkm0315/frappe-agent",
12+
"license": "MIT",
13+
"keywords": [
14+
"frappe",
15+
"erpnext",
16+
"bench",
17+
"python",
18+
"javascript",
19+
"react",
20+
"vue"
21+
],
22+
"skills": "./skills/",
23+
"interface": {
24+
"displayName": "Frappe Agent",
25+
"shortDescription": "Frappe-aware coding, bench, SQL, and customization help.",
26+
"longDescription": "Adds Frappe and ERPNext-specific skills for full-stack work, bench operations, SQL and ORM decisions, admin customizations, and workflow-aware code review.",
27+
"developerName": "Dhairya Marwaha",
28+
"category": "Developer Tools",
29+
"capabilities": [
30+
"Read",
31+
"Write",
32+
"Interactive"
33+
],
34+
"websiteURL": "https://github.com/Dkm0315/frappe-agent",
35+
"privacyPolicyURL": "https://github.com/Dkm0315/frappe-agent",
36+
"termsOfServiceURL": "https://github.com/Dkm0315/frappe-agent",
37+
"defaultPrompt": [
38+
"Use Frappe Agent to inspect this bench before changing anything.",
39+
"Use Frappe Agent to choose the right Frappe customization layer.",
40+
"Use Frappe Agent to review this Frappe SQL or ORM code."
41+
],
42+
"brandColor": "#1F7A5A"
43+
}
44+
}

‎plugins/Dkm0315/frappe-agent/LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 Dhairya Marwaha
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎plugins/Dkm0315/frappe-agent/README.md‎

Lines changed: 130 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,130 @@
1+
# Frappe Agent for Codex
2+
3+
`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.
4+
5+
## What It Covers
6+
7+
- Frappe full-stack reasoning across backend, frontend, customization, and bench work
8+
- Bench-aware inspection before app installs, migrations, or environment changes
9+
- Frappe-native SQL and ORM guidance
10+
- Customization-layer routing for `Custom Field`, `Property Setter`, `Client Script`, `Server Script`, `Workspace`, `Web Page`, `Report`, `Dashboard`, and related surfaces
11+
- ERPNext-aware guidance for deciding between configuration, metadata, workflow, and code changes
12+
- Frontend guidance for Vue, React, `frappe-ui`, desk pages, `www`, and external SPA patterns
13+
14+
## Included Skills
15+
16+
- `frappe-fullstack`
17+
- `frappe-backend`
18+
- `frappe-frontend`
19+
- `frappe-bench`
20+
- `frappe-sql`
21+
- `frappe-customization`
22+
- `frappe-search`
23+
- `frappe-erpnext`
24+
25+
## Installation
26+
27+
This mirrored bundle ships the Codex plugin files used by the curated `awesome-codex-plugins` marketplace.
28+
29+
For the full upstream repository, including cross-agent packaging and development docs, see:
30+
31+
```text
32+
https://github.com/Dkm0315/frappe-agent
33+
```
34+
35+
### Codex
36+
37+
Codex supports repo marketplaces and local plugin installation.
38+
39+
If you cloned this repository locally, add it as a local marketplace:
40+
41+
```bash
42+
codex marketplace add /path/to/frappe-agent
43+
```
44+
45+
Then enable `frappe-agent` from the added marketplace in Codex and restart Codex in a fresh session.
46+
47+
Local repo flow:
48+
49+
1. Clone this repository somewhere on disk.
50+
2. Run:
51+
52+
```bash
53+
codex marketplace add /path/to/frappe-agent
54+
```
55+
56+
3. Enable `frappe-agent` from that marketplace in Codex.
57+
4. Restart Codex.
58+
59+
GitHub repo flow:
60+
61+
1. Clone this repository or open the repo locally.
62+
2. Run:
63+
64+
```bash
65+
codex marketplace add /path/to/local/clone/of/frappe-agent
66+
```
67+
68+
3. Enable `frappe-agent` and restart Codex.
69+
70+
This mirrored bundle includes `.codex-plugin/plugin.json` and `skills/` for Codex installation through the curated marketplace.
71+
72+
## Usage Examples
73+
74+
Ask Codex to use the plugin naturally in the prompt:
75+
76+
```text
77+
Use Frappe Agent to inspect this bench before changing anything.
78+
```
79+
80+
```text
81+
Use Frappe Agent to choose the right Frappe customization layer for adding fields to Sales Order.
82+
```
83+
84+
```text
85+
Use Frappe Agent to review whether this Frappe SQL should use frappe.db, frappe.qb, or raw SQL.
86+
```
87+
88+
```text
89+
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.
90+
```
91+
92+
## Repository Layout
93+
94+
```text
95+
frappe-agent/
96+
├── .codex-plugin/
97+
│ └── plugin.json
98+
├── skills/
99+
│ ├── frappe-backend/
100+
│ ├── frappe-bench/
101+
│ ├── frappe-customization/
102+
│ ├── frappe-erpnext/
103+
│ ├── frappe-frontend/
104+
│ ├── frappe-fullstack/
105+
│ ├── frappe-search/
106+
│ └── frappe-sql/
107+
└── README.md
108+
```
109+
110+
## Current Scope
111+
112+
This mirrored bundle is a Codex-native plugin package. The upstream repository may contain additional host adapters and docs.
113+
114+
## Design Goals
115+
116+
- Inspect first, mutate second
117+
- Prefer Frappe-native customization surfaces before invasive code changes
118+
- Separate ERPNext configuration work from framework-code work
119+
- Respect bench context, app provenance, and version boundaries
120+
- Help agents make fewer generic Python, JavaScript, SQL, and frontend mistakes in Frappe codebases
121+
122+
## Roadmap
123+
124+
- Add more first-class skills for custom fields, reports, workflows, dashboards, and upgrade planning
125+
- Add better source-backed command and flag coverage for Bench
126+
- Add richer repo examples and team onboarding docs
127+
128+
## License
129+
130+
MIT

‎plugins/Dkm0315/frappe-agent/skills/frappe-backend/SKILL.md‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
name: frappe-backend
3+
description: Frappe backend guidance for Python and backend-adjacent JavaScript surfaces such as client interaction patterns, hooks, APIs, patches, scheduler logic, reports, and server-side review. Use when implementing or reviewing Frappe backend behavior.
4+
---
5+
6+
Treat Frappe backend work as a Python-first system with important JavaScript touchpoints.
7+
8+
Cover:
9+
- controllers and document lifecycle methods
10+
- hooks
11+
- whitelisted methods
12+
- scheduler jobs and background work
13+
- patches and migrations
14+
- server scripts when they are the right layer
15+
- report backends
16+
- client-to-server API contracts
17+
18+
Principles:
19+
- prefer framework APIs over ad hoc patterns
20+
- keep imports clean and explicit
21+
- use permissions deliberately
22+
- separate document logic, service logic, and integration logic
23+
- avoid accidental public APIs
24+
25+
Before writing code, decide whether the request should instead be handled by:
26+
- `Custom Field`
27+
- `Property Setter`
28+
- `Client Script`
29+
- `Server Script`
30+
- `Workflow`
31+
- `Report`
32+
- `Workspace`
33+

‎plugins/Dkm0315/frappe-agent/skills/frappe-bench/SKILL.md‎

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
name: frappe-bench
3+
description: Bench-aware Frappe operations guidance for app installs, branch switching, updates, migrations, site inspection, ports, and process state. Use when a task involves bench commands or local environment operations.
4+
---
5+
6+
Operate as a careful bench assistant.
7+
8+
Always inspect before acting:
9+
- bench root
10+
- installed apps
11+
- sites
12+
- `sites/apps.txt`
13+
- `sites/common_site_config.json`
14+
- running ports and process state
15+
- app remotes and branches
16+
17+
Prefer read-only checks first.
18+
19+
Never assume:
20+
- the bench is stopped
21+
- the default site is the target site
22+
- the app remote is official
23+
- a version switch is safe
24+
25+
When proposing commands:
26+
- explain why that command is appropriate
27+
- call out risky flags
28+
- show what bench or site it targets
29+
- warn before actions that mutate apps, sites, DBs, or branches
30+

‎plugins/Dkm0315/frappe-agent/skills/frappe-customization/SKILL.md‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
name: frappe-customization
3+
description: Frappe customization-surface guidance covering Custom Field, Property Setter, Client Script, Server Script, Workspace, Web Page, Page, Print Format, Report, Dashboard, Workflow, Role, Notification, Webhook, and related builder/admin DocTypes. Use when choosing or changing Frappe customization layers.
4+
---
5+
6+
Choose the right Frappe customization surface before suggesting code.
7+
8+
Check these surfaces first when relevant:
9+
- `Custom Field`
10+
- `Property Setter`
11+
- `Client Script`
12+
- `Server Script`
13+
- `Workspace`
14+
- `Web Page`
15+
- `Page`
16+
- `Print Format`
17+
- `Report`
18+
- `Dashboard`
19+
- `Dashboard Chart`
20+
- `Number Card`
21+
- `Web Form`
22+
- `Workflow`
23+
- `Role`
24+
- `Notification`
25+
- `Assignment Rule`
26+
- `Webhook`
27+
- `Auto Repeat`
28+
- `Email Template`
29+
- `Letter Head`
30+
- `Print Style`
31+
32+
Preferred decision ladder:
33+
1. built-in configuration
34+
2. metadata/admin DocType customization
35+
3. page/workspace/report/dashboard/print/web surfaces
36+
4. hooks and custom app code
37+
5. changes inside a custom-derived app only when necessary
38+
39+
Explicitly call out when a request should use `Custom Field` rather than editing a DocType JSON file directly.
40+

‎plugins/Dkm0315/frappe-agent/skills/frappe-erpnext/SKILL.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
name: frappe-erpnext
3+
description: ERPNext-aware reasoning for module customization, workflows, reports, dashboards, workspaces, and choosing between configuration, metadata, and code changes. Use when a task affects ERPNext module behavior.
4+
---
5+
6+
Act as an ERPNext customization advisor for developers.
7+
8+
Help the user determine:
9+
- what the standard module already supports
10+
- whether the request is configuration, metadata, workflow, reporting, or code work
11+
- whether a change belongs in ERPNext settings, builder DocTypes, a custom app, or a custom-derived app
12+
13+
Cover common domains broadly:
14+
- manufacturing
15+
- buying
16+
- selling
17+
- CRM
18+
- HR
19+
- accounts and reporting
20+
- customer-facing website or portal flows
21+
22+
Prefer showing the safest customization layer before proposing invasive code changes.

0 commit comments

Comments
 (0)