frappecliCLI 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.
Install via ClawdBot CLI:
clawdbot install pasogott/frappecliCLI for managing Frappe Framework instances via REST API.
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 .
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
frappecli site doctypes # List all doctypes
frappecli site doctypes --module "Core" # Filter by module
frappecli site info "User" # Get doctype details
# 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
# 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"
# 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
# Call custom method
frappecli rpc frappe.ping
# With arguments
frappecli rpc myapp.api.process_data --args '{"doc_id":"DOC-001"}'
# Use specific site
frappecli --site staging doc list Customer
# Switch default site
frappecli config set default_site staging
frappecli doc list Customer --format table # Pretty table (default)
frappecli doc list Customer --format json # JSON
frappecli doc list Customer --format csv # CSV
# 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 '*'
# 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})'
brew install pasogott/tap/frappecliGenerated Mar 1, 2026
An e-commerce business uses Frappecli to manage customer records, updating statuses for loyalty programs and exporting active customers for marketing campaigns. This automates customer segmentation and reduces manual data entry errors.
A small accounting firm runs reports like General Ledger via Frappecli to generate CSV exports for clients, integrating with spreadsheet tools for analysis. This streamlines monthly financial reviews and improves data accuracy.
A manufacturing company uploads invoices and technical documents to Frappe, linking files to sales orders for traceability. This centralizes document storage and enhances compliance with audit trails.
A SaaS provider uses Frappecli to manage customer instances across staging and production sites, performing bulk updates and monitoring doctypes. This ensures consistent configurations and efficient support operations.
A logistics firm calls custom RPC methods via Frappecli to process shipment data, automating order tracking and inventory updates. This reduces manual API calls and improves real-time data synchronization.
Offer managed services where businesses pay a monthly fee for automated data backups, report generation, and system monitoring using Frappecli. This provides recurring revenue and reduces client IT overhead.
Provide consulting to customize Frappecli scripts for specific workflows, such as bulk document imports or integration with external tools. Charge per project or hourly for implementation and training.
Develop training courses and certifications on using Frappecli for ERPNext administration, targeting IT professionals and business users. Generate revenue through course sales and certification exams.
💬 Integration Tip
Use jq with JSON output for advanced data filtering, and automate tasks by scripting Frappecli commands in cron jobs or CI/CD pipelines.
Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
Command-line tool to manage Google Workspace services including Gmail, Calendar, Drive, Sheets, Docs, Slides, Contacts, Tasks, People, Groups, and Keep.
Runs shell commands inside a dedicated tmux session named claw, captures, and returns the output, with safety checks for destructive commands.
A modern text-based browser. Renders web pages in the terminal using headless Firefox.
Write robust, portable shell scripts. Use when parsing arguments, handling errors properly, writing POSIX-compatible scripts, managing temp files, running commands in parallel, managing background processes, or adding --help to scripts.
NotebookLM CLI wrapper via `node {baseDir}/scripts/notebooklm.mjs`. Use for auth, notebooks, chat, sources, notes, sharing, research, and artifact generation/download.