Foxmayn Frappe CLI

ffc — Foxmayn Frappe CLI

Frappe と ERPNext のサイト向けのコマンドラインツール、MCP サーバー、デスクトップアプリです。

公式の Frappe プロジェクトではありません。 ffc と Foxmayn Frappe Desktop は Foxmayn が独自に開発したもので、Frappe Technologies との提携や推奨を受けていません。

• ffc は REST API 経由でドキュメント、レポート、ワークフロー、ファイル、権限を扱い、スクリプト向けの出力（JSON、NDJSON、CSV、--jq）を提供します。
• ffc mcp を使うと、AI アシスタント（Claude Desktop、Claude Code、Cursor、VS Code、Codex）からサイトを利用できます。サイトごとの制限、確認、監査ログに対応しています。
• Foxmayn Frappe Desktop（Windows および macOS）では、サイトを追加し、アシスタントを通じてサイトとチャットし、ターミナルを使わずに AI アプリを接続できます。

_{デモ用ERPNextサイトでのDesktop Assistant（Claude Opus 5.5）の実際の実行例です。待機時間は4倍速で表示しています。「変更前に確認」がオンの場合、カードを承認するまで何も書き込まれません。}

安全性

ERPに接続したAIアシスタントが、予期しない操作を行うべきではありません。ffc とデスクトップアプリは、Frappe のユーザー権限で動作し、その権限を狭めることだけを行います。

• デフォルトは読み取り専用：デスクトップアプリではデフォルトで読み取り専用です。AI クライアントでは、1つのフラグ（--read-only）または1つの設定キーで読み取り専用にできます。
• サイトごとのポリシー： ツール、DocType、サーバーメソッドを許可または拒否できます。ユーザー、権限、スクリプト、設定は、一覧に指定しない限り読み取り専用のままです。
• 承認： ffc は、削除、キャンセル、ワークフロー操作、共有の前に、確認を行える AI クライアントを通じて承認を求めます（confirm: always の場合、確認できないクライアントでは拒否されます）。デスクトップアプリの「変更前に確認」モードでは、変更ごとに変更前後のフィールドを表示するカードで承認を待ちます。また、確認してからサイト上のドキュメントが変更されている場合、更新は拒否されます。
• 監査ログ： 許可されたものも拒否されたものも、すべてのツール呼び出しが、お使いのマシン上にJSONの1行として記録されます。
• ドライラン： 書き込みを行う CLI コマンドでは --dry-run を指定でき、送信される内容を表示します。

詳細と制限：MCP の安全性 · デスクトップアプリの承認。

インストール

Linux および macOS

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

Windows（PowerShell または cmd.exe）

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

または、パッケージマネージャーを使用します：brew install nasroykh/tap/ffc（macOS、Linux）、または scoop bucket add foxmayn https://github.com/nasroykh/scoop-bucket を実行してから scoop install ffc（Windows）。

どちらのスクリプトも、お使いのプラットフォーム向けの最新リリースをダウンロードし、SHA-256 チェックサムを確認します。手動でのダウンロード、ソースからのビルド、署名の確認、更新（ffc update）、アンインストールについては、インストールをご覧ください。

デスクトップアプリ（ベータ版）： 現在、ビルドにはコード署名がありません（署名への支援）。そのため、ブラウザーからダウンロードすると、Windows SmartScreen または macOS Gatekeeper の警告が表示されます。インストールスクリプトはリリースを直接ダウンロードし、SHA-256 チェックサム（macOS ではリリース署名も）を確認してからインストールします。

# 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"

または、リリースページから desktop-v… リリースをダウンロードしてください。初回起動の手順については、デスクトップアプリのインストールをご覧ください。

クイックスタート

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

AI アシスタントをサイトに接続します。

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

詳しくはクイックスタートをご覧ください。

ドキュメント

トピック	場所
インストール、最初のサイト、サインイン方法、設定ファイル、環境変数	インストール · 認証 · 設定
すべてのコマンド、グローバルフラグ、出力形式、終了コード、ドライラン	CLI リファレンス
MCP サーバー：クライアントごとのセットアップ、実行方法、ツール、安全性、ポリシー	MCP
デスクトップアプリ：インストール、サイト、アシスタント、アプリの接続、アップデート	デスクトップ
リリースの署名、認証情報の保存場所	セキュリティ
問題と質問	トラブルシューティング · よくある質問
ビルド、テスト、リリース、デスクトップの開発サイクル	開発

全体の目次は docs/README.md をご覧ください。

AI エージェント向け

skills/ には、ffc を使用するためのエージェントスキル（まずは ffc-core、次に ffc-setup、ffc-mcp、ffc-bulk-lifecycle、ffc-reports-api、ffc-files-collab）と、このリポジトリで作業するためのスキル（ffc-dev と ffc-dev-* スキル）が含まれています。make skills-init を実行すると、これらが .claude/、.cursor/、.agent/ にリンクされます。

サポート

ffc は無料で、今後も無料です。時間の節約に役立った場合は、Ko-fi で開発を支援できます。最初の目標はコード署名です。これにより、デスクトップアプリをセキュリティ警告なしで Windows と macOS にインストールできるようになります。その後はテストサーバーと開発ツールを目指します。すでに Wise をお使いの場合は、Wise から送金することもできます。

貢献

課題の報告やプルリクエストを歓迎します。開発から始めてください：make build、make test、make lint。新しいコマンドや MCP ツールにはすべて、internal/frappetest にあるフェイクの Frappe サイトを使ったテストが付属します。

クレジット

ffc は以下のオープンソースプロジェクトを基盤として構築されています。作者の皆様に感謝します。

• CLI と MCP サーバー： Cobra と pflag、Charm（Lip Gloss、Huh、Bubbles、colorprofile）、Resty、gojq、mcp-go、hujson、go-yaml、go-isatty、および Go の x/sys パッケージ。
• デスクトップアプリ： Wails、React、Base UI、shadcn/ui、Tailwind CSS、Tabler Icons、Nunito Sans（Fontsource 経由）、cmdk、Embla Carousel、Vite、および desktop/frontend/package.json にあるその他のパッケージ。
• リリースツール： GoReleaser と NSIS。
• Frappe Framework と ERPNext。このプロジェクトが連携するオープンソースプラットフォームです。Frappe と ERPNext はそれぞれの所有者の商標であり、ここでは互換性を説明する目的に限って使用しています。

ライセンス

MIT © 2026 Nas (Foxmayn)