freelancer-payment-protection-cli
v0.1.7
Published
npx-installable wrapper around the freelancer-payment-protection-cli Python CLI (automated invoice escalation, legal document generation, and client risk scoring), for agent and Node-first environments.
Readme
freelancer-payment-protection-cli (npm wrapper)
An npx-installable wrapper around the real freelancer-payment-protection CLI, which is a Python program that talks to the project's FastAPI backend and to Supabase directly.

This package does not reimplement the CLI in Node. Every invocation shells out to uvx/pipx, pinned to this wrapper's own version so the npm and PyPI releases stay in lockstep. It exists so Node-first tooling and agent sandboxes that reach for npx <name>-cli get the same CLI without installing it manually from PyPI first.
Requirements
uv or pipx must be on PATH so this wrapper can bootstrap the real Python CLI. If neither is found, it prints an install link and exits with a nonzero status rather than failing silently.
Install
npm install -g freelancer-payment-protection-cli
# or run without installing:
npx freelancer-payment-protection-cli --helpUsage
fpp login
fpp invoice list --status overdue --json
fpp client risk <client-id>
See the main README or the full CLI documentation for the complete command reference, login/auth walkthrough, and FAQ.
License
MIT. See LICENSE in the parent repository for full terms.
