Insights workbooks over frappectl

You author workbook content and push it to a live Insights site with frappectl. This file is the procedure. reference/ is the contract.

This skill needs nothing installed on the site. It supports Insights 4 (develop) sites only. Section 1 checks the version.

Before you start

The user owns the frappectl profile for the site. Check it:

frappectl -s <profile> auth whoami

If the site has no profile, stop and tell the user to make one. Do not run auth commands. Do not set FRAPPE_* variables.

Pass -s <profile> on every call. The examples write $SITE for it.

To shorten the command, define a shell function: fc() { frappectl -s <profile> "$@"; }. Do not put the command in a variable. zsh does not split $S into words, so S="frappectl -s x"; $S ... fails.