How do I install the Frappecli skill?

Run npx skillmds@latest add dvcrn/frappecli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Frappecli safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Frappecli?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Frappecli free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Frappecli?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Frappecli by dvcrn — Agent Skill

Name: Frappecli
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

frappecli

CLI for managing Frappe Framework instances via REST API.

Installation

brew tap pasogott/tap
brew install frappecli

Or from source:

git clone https://github.com/pasogott/frappecli.git
cd frappecli && uv sync && uv pip install -e .

Configuration

Create ~/.config/frappecli/config.yaml:

sites:
  production:
    url: https://erp.company.com
    api_key: your_api_key
    api_secret: your_api_secret
  staging:
    url: https://staging.company.com
    api_key: your_staging_key
    api_secret: your_staging_secret

default_site: production

Commands

Site Management

frappecli site doctypes                    # List all doctypes
frappecli site doctypes --module "Core"    # Filter by module
frappecli site info "User"                 # Get doctype details

Document CRUD

# List documents
frappecli doc list Customer
frappecli doc list Customer --filters '{"status":"Active"}' --limit 10

# Get single document
frappecli doc get Customer CUST-001
frappecli doc get Customer CUST-001 --fields name,customer_name,status

# Create document
frappecli doc create Customer --data '{"customer_name":"Acme","customer_type":"Company"}'

# Update document
frappecli doc update Customer CUST-001 --data '{"status":"Inactive"}'

# Delete document
frappecli doc delete Customer CUST-001

File Management

# Upload file (private by default)
frappecli file upload invoice.pdf --doctype "Sales Invoice" --docname "INV-001"

# Upload public file
frappecli file upload logo.png --public

# Download file
frappecli file download /private/files/invoice.pdf -o ./downloads/

# List files for document
frappecli file list --doctype "Sales Invoice" --docname "INV-001"

Reports

# Run report (JSON output)
frappecli report run "General Ledger" --filters '{"company":"My Company"}'

# Export to CSV
frappecli report run "Accounts Receivable" --format csv -o report.csv

RPC Methods

# Call custom method
frappecli rpc frappe.ping

# With arguments
frappecli rpc myapp.api.process_data --args '{"doc_id":"DOC-001"}'

Multi-Site

# Use specific site
frappecli --site staging doc list Customer

# Switch default site
frappecli config set default_site staging

Output Formats

frappecli doc list Customer --format table   # Pretty table (default)
frappecli doc list Customer --format json    # JSON
frappecli doc list Customer --format csv     # CSV

Examples

Bulk Operations

# Export all active customers
frappecli doc list Customer --filters '{"status":"Active"}' --format csv > customers.csv

# Get document with child tables
frappecli doc get "Sales Invoice" INV-001 --fields '*'

Integration with jq

# Get customer names only
frappecli doc list Customer --format json | jq -r '.[].customer_name'

# Count by status
frappecli doc list Customer --format json | jq 'group_by(.status) | map({status: .[0].status, count: length})'

Links

Repository: https://github.com/pasogott/frappecli
Homebrew: brew install pasogott/tap/frappecli

---name: frappeclidescription: CLI for Frappe Framework / ERPNext instances. Use when user asks about "Frappe", "ERPNext", "doctypes", "Frappe API", or needs to manage documents, files, reports, or call RPC methods on a Frappe site.---# frappecliCLI for managing Frappe Framework instances via REST API.## Installation```bashbrew tap pasogott/tapbrew install frappecli```Or from source:```bashgit clone https://github.com/pasogott/frappecli.gitcd frappecli && uv sync && uv pip install -e .```## ConfigurationCreate `~/.config/frappecli/config.yaml`:```yamlsites: production: url: https://erp.company.com api_key: your_api_key api_secret: your_api_secret staging: url: https://staging.company.com api_key: your_staging_key api_secret: your_staging_secretdefault_site: production```## Commands### Site Management```bashfrappecli site doctypes # List all doctypesfrappecli site doctypes --module "Core" # Filter by modulefrappecli site info "User" # Get doctype details```### Document CRUD```bash# List documentsfrappecli doc list Customerfrappecli doc list Customer --filters '{"status":"Active"}' --limit 10# Get single documentfrappecli doc get Customer CUST-001frappecli doc get Customer CUST-001 --fields name,customer_name,status# Create documentfrappecli doc create Customer --data '{"customer_name":"Acme","customer_type":"Company"}'# Update documentfrappecli doc update Customer CUST-001 --data '{"status":"Inactive"}'# Delete documentfrappecli doc delete Customer CUST-001```### File Management```bash# Upload file (private by default)frappecli file upload invoice.pdf --doctype "Sales Invoice" --docname "INV-001"# Upload public filefrappecli file upload logo.png --public# Download filefrappecli file download /private/files/invoice.pdf -o ./downloads/# List files for documentfrappecli file list --doctype "Sales Invoice" --docname "INV-001"```### Reports```bash# Run report (JSON output)frappecli report run "General Ledger" --filters '{"company":"My Company"}'# Export to CSVfrappecli report run "Accounts Receivable" --format csv -o report.csv```### RPC Methods```bash# Call custom methodfrappecli rpc frappe.ping# With argumentsfrappecli rpc myapp.api.process_data --args '{"doc_id":"DOC-001"}'```### Multi-Site```bash# Use specific sitefrappecli --site staging doc list Customer# Switch default sitefrappecli config set default_site staging```## Output Formats```bashfrappecli doc list Customer --format table # Pretty table (default)frappecli doc list Customer --format json # JSONfrappecli doc list Customer --format csv # CSV```## Examples### Bulk Operations```bash# Export all active customersfrappecli doc list Customer --filters '{"status":"Active"}' --format csv > customers.csv# Get document with child tablesfrappecli doc get "Sales Invoice" INV-001 --fields '*'```### Integration with jq```bash# Get customer names onlyfrappecli doc list Customer --format json | jq -r '.[].customer_name'# Count by statusfrappecli doc list Customer --format json | jq 'group_by(.status) | map({status: .[0].status, count: length})'```## Links- **Repository:** https://github.com/pasogott/frappecli- **Homebrew:** `brew install pasogott/tap/frappecli`

Frequently asked questions

Frappecli