ffc — Foxmayn Frappe CLI

Name: foxmayn_frappe_cli
Author: nasroykh

A command line, an MCP server and a desktop app for Frappe and ERPNext sites.

Not an official Frappe project. ffc and Foxmayn Frappe Desktop are made independently by Foxmayn and are not affiliated with or endorsed by Frappe Technologies.

ffc works with documents, reports, workflows, files and permissions over the REST API, with output made for scripts (JSON, NDJSON, CSV, --jq).
ffc mcp lets AI assistants (Claude Desktop, Claude Code, Cursor, VS Code, Codex) use your sites, with per-site limits, confirmations and an audit log.
Foxmayn Frappe Desktop (Windows and macOS) adds sites, chats with them through its Assistant and connects AI apps, without the terminal.

Install

Linux and macOS

curl -fsSL https://raw.githubusercontent.com/nasroykh/foxmayn_frappe_cli/main/install.sh | sh

Windows (PowerShell or cmd.exe)

powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/nasroykh/foxmayn_frappe_cli/main/install.ps1 | iex"

Or with a package manager: brew install nasroykh/tap/ffc (macOS, Linux), or scoop bucket add foxmayn https://github.com/nasroykh/scoop-bucket then scoop install ffc (Windows).

Both scripts download the latest release for your platform and check its SHA-256 checksum. Manual downloads, building from source, signature checks, updating (ffc update) and uninstalling: Installation.

Desktop app: beta builds are not signed yet, so install them from a terminal to skip the macOS and Windows warnings (the scripts check the download):

# macOS
curl -fsSL https://raw.githubusercontent.com/nasroykh/foxmayn_frappe_cli/main/install-desktop.sh | sh

# Windows (PowerShell or cmd.exe)
powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/nasroykh/foxmayn_frappe_cli/main/install-desktop.ps1 | iex"

Or download the desktop-v… release from the Releases page; see Install the desktop app for the first-launch steps.

Quickstart

ffc init                                   # add your first site (browser sign-in, API key or password)
ffc whoami                                 # who you are on the site, roles, Frappe version
ffc list-docs -d Customer -f name,customer_name -l 5
ffc get-doc -d "Sales Invoice" -n ACC-SINV-2026-00001 --json
ffc list-docs -d ToDo --filters '{"status":"Open"}' --output csv > todos.csv

Connect an AI assistant to your sites:

ffc mcp install --client claude-desktop    # or claude-code, cursor, vscode, codex; --read-only allows reads only

Documentation

Topic	Where
Install, first site, sign-in methods, config file and env vars	Installation · Authentication · Configuration
Every command, global flags, output formats, exit codes, dry runs	CLI reference
MCP server: setup per client, running it, tools, safety and policy	MCP
Desktop app: install, sites, the Assistant, connecting apps, updates	Desktop
Release signing, where credentials live	Security
Problems and questions	Troubleshooting · FAQ
Building, testing, releasing, the desktop dev loop	Development

The full index is docs/README.md.

For AI agents

skills/ holds agent skills for using ffc (start with ffc-core; then ffc-setup, ffc-mcp, ffc-bulk-lifecycle, ffc-reports-api, ffc-files-collab) and for working on this repository (ffc-dev and the ffc-dev-* skills). make skills-init links them into .claude/, .cursor/ and .agent/.

Support

ffc is free and stays free. If it saves you time, you can support its development on Ko-fi. The first goal is code signing, so the desktop app installs on Windows and macOS without security warnings; then test servers and development tools. Already use Wise? You can also send through Wise.

Contributing

Issues and pull requests are welcome. Start with Development: make build, make test, make lint. Every new command or MCP tool ships with tests against the fake Frappe site in internal/frappetest.

Credits

ffc builds on these open-source projects, with thanks to their authors:

CLI and MCP server: Cobra and pflag, Charm (Lip Gloss, Huh, Bubbles, colorprofile), Resty, gojq, mcp-go, hujson, go-yaml, go-isatty and the Go x/sys packages.
Desktop app: Wails, React, Base UI, shadcn/ui, Tailwind CSS, Tabler Icons, Nunito Sans (via Fontsource), cmdk, Embla Carousel, Vite and the other packages in desktop/frontend/package.json.
Release tooling: GoReleaser and NSIS.
Frappe Framework and ERPNext, the open-source platforms this project talks to. Frappe and ERPNext are trademarks of their respective owners, used here only to describe compatibility.

foxmayn_frappe_cli