CLI quickstart

The Zanfia CLI brings your whole workspace to the terminal: create products and offers, write course lessons, upload videos, post in communities, manage clients, and pull sales stats — interactively or from scripts.

Set up the Zanfia CLI. Zanfia = platform for selling digital products
(courses, communities, pages). Before running commands, ask me these,
one by one, and wait unless already given:

1. Do you have a Zanfia account? (yes → login, no → register)
2. Auth method? (default: "browser login", option: "API key" — key comes
   from Dashboard → Integrations → API, MCP and CLI)

Steps:
- Install: npm install -g @zanfia-dev/cli   (beta package; command is
  `zanfia-dev` — use it wherever docs say `zanfia`. Node 20+ required.)
- Browser login: zanfia-dev login   (opens browser, stores a 90-day token)
- API key instead: export ZANFIA_API_KEY=<key>
- No account: zanfia-dev register   (email + one-time code, interactive)
- Verify: zanfia-dev auth status && zanfia-dev --json products list

Usage rules:
- Global flags (--json, --verbose, --api-key) go BEFORE the subcommand.
- Always use --json when parsing output.
- Money amounts are minor units (1999 = 19.99).
- Full command reference: https://zanfia.com/en/help/developer-cli/commands

Install and sign in

npm install -g @zanfia-dev/cli

zanfia login

zanfia auth status
zanfia products list

Alternative: API keys

Instead of login, you can authenticate with an API key — useful for CI and servers:

export ZANFIA_API_KEY=YOUR_API_KEY   # or pass --api-key per invocation
zanfia products list

Resolution order: --api-key flag → ZANFIA_API_KEY → stored login credentials.

Global flags

Global flags go before the subcommand:

zanfia --json products list

A taste of what it can do

# Create a product and publish a first lesson
zanfia products create --name "Negotiation for Engineers"
zanfia courses module add <productId> --name "Week 1"
zanfia courses lesson add <productId> --module <moduleId> --title "Anchoring" --type article
zanfia courses lesson update <productId> <lessonId> --content-file ./anchoring.md --status public

# Upload a video and bind it to a lesson
zanfia media upload-video --file ./intro.mp4 --wait
zanfia courses lesson set-video <productId> <lessonId> --video-media <mediaId>

# Check this week's numbers
zanfia stats overview --period 7d

The full surface is in the command reference.