Developers

Command reference

Every shipped Frontpage CLI command: auth, sync, agent, content, history, and utilities.

Install

npm i -g frontpage-host
frontpage help
# or
npx frontpage-host help

Package name is frontpage-host. Binary is frontpage. Do not install the unrelated npm package named frontpage. Node.js ≥ 20.

Global flags

See Flags & machine I/O for --json, --quiet, --site, --yes, and the JSON envelope.

Auth & session

Command	Usage
`login`	`frontpage login [api-key]`
`logout`	`frontpage logout`
`whoami`	`frontpage whoami [--json]`
`doctor`	`frontpage doctor [--json]`
`sites`	`frontpage sites [--json]`
`use` / `link`	`frontpage use <subdomain>`
`completion`	`frontpage completion bash\|zsh\|fish`

File sync

Command	Usage
`pull`	`frontpage pull [--site <slug>] [--json]`
`push`	`frontpage push [--site <slug>] [--message …] [--wait] [--json]`
`diff`	`frontpage diff [--site <slug>] [--json]`. Local vs remote via git `blobSha`; JSON includes `dirty` + `tipDrift`
`ls`	`frontpage ls [prefix] [--site <slug>] [--json]`
`cat`	`frontpage cat <path> [--site <slug>]`
`search`	`frontpage search <pattern> [path\|--path <path>] [--regex] [--case-sensitive] [--whole-word] [--files-only] [--context-lines N] [--max-results N] [--site <slug>]`
`fonts`	`frontpage fonts [list\|search] [--slot …] [--query …] [--variable-only] [--limit N] [--json]`
`tokens`	`frontpage tokens set --group <…> --key <…> --value <…> [--site <slug>]`
`status`	`frontpage status [--site <slug>] [--json]`
`open`	`frontpage open [/path\|--path /path] [--site <slug>] [--prod]`

open --prod is currently a no-op stub and still opens the subdomain staging URL.

Agent, deploy, publish

Command	Usage
`prompt`	`frontpage prompt "…" [--path /] [--attach …] [--asset-url …] [--site <slug>] [--json]`
`runs`	`frontpage runs [list\|current\|wait\|cancel\|retry\|get] [runId] [--json]`
`deploy wait`	`frontpage deploy wait [--site <slug>] [--json]`. Agent idle + tip compile ready, not publish
`publish`	`frontpage publish [--site <slug>] [--wait] [--json]`. Promote the ready compile (409 if the tip is not built)
`unpublish`	`frontpage unpublish [--yes] [--site <slug>] [--json]`
`usage`	`frontpage usage [--site <slug>]`
`analytics`	`frontpage analytics [dashboard\|summary\|query\|funnel\|timeseries\|compare\|sql] … [--site <slug>]`
`pages`	`frontpage pages [--site <slug>] [--json]`

Content & config

Command	Usage
`seo`	`frontpage seo get [/path\|--path /path] \| seo set --path / […]`
`redirects`	`frontpage redirects list \| set --from /old --to /new [--status 301\|308] \| rm --from /old`. Instant HTTP 301/308; not a file; `revert` does not undo
`articles`	`frontpage articles list\|content\|create-section\|…`
`media`	`frontpage media list\|upload <file>`
`inbox`	`frontpage inbox [leads\|subscribers\|orders\|google_reviews\|…] [--mark-read] [--csv]`
`people`	`frontpage people list\|get\|add\|set\|note\|rm-note\|follow-up\|hide\|unhide`. Site-scoped person graph. `--site` is the subdomain slug. Identity is email or phone (see phone/email formats on the People page). Viewer list/get; editor mutate. Full flag tables: People CRM
`shop`	`frontpage store items\|variants\|categories\|settings\|orders\|payments\|connect\|status\|disconnect`. Frontpage Store for pay buttons and the Stripe cart. Integer cents (`$49.99` is `4999`). Stock `--add` / `--remove` are signed delta. Viewer list/get/status; editor mutate; admin connect/disconnect. Not Square. Full guide: Store
`modules`	`frontpage modules [list\|docs\|request-setup\|enable\|disable\|archive\|config] <key>` or `frontpage modules <key> [action]`. Modules, Google reviews, payments, ordering
`extensions`	`frontpage extensions [list\|docs\|enable\|disable\|config] <key>`
`settings`	`frontpage settings get\|set […]`
`edit`	`frontpage edit --path / --old "…" --new "…"`

Observe

Full examples: Analytics & usage. Rate classes: Rate limits.

Command	Usage
`analytics`	`frontpage analytics …`. Dashboard or summary/query/funnel/timeseries/compare/sql
`usage`	`frontpage usage [--site <slug>]`. Plan + AI/bandwidth/storage meters
`pages`	`frontpage pages [--site <slug>] [--json]`. Path + title list

History

Command	Usage
`history`	`frontpage history [--limit N] [--page N] [--site <slug>] [--json]`
`revert`	`frontpage revert <40-char-sha> [--yes] [--site <slug>] [--json]`

Shell completion

frontpage completion bash
frontpage completion zsh
frontpage completion fish

# zsh example:
frontpage completion zsh > ~/.zsh/completions/_frontpage
# then ensure fpath includes that directory and run compinit

Completions cover subcommands and help topics. Re-run after upgrading frontpage-host.

Help topics

frontpage help
frontpage help --json
frontpage help quickstart
frontpage help auth
frontpage help sync
frontpage help agent
frontpage help content
frontpage help history
frontpage help isolation
frontpage help exit-codes
frontpage help push

Package docs: AGENTS.md, llms.txt, and README.md inside frontpage-host.