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] [--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 [--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]` — build wait (fail-closed), not publish
`publish`	`frontpage publish [--site <slug>] [--json]` — promote staging → production
`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\|set --path / […]`
`articles`	`frontpage articles list\|content\|create-section\|…`
`media`	`frontpage media list\|upload <file>`
`inbox`	`frontpage inbox [leads\|subscribers\|orders\|…] [--mark-read] [--csv]`
`modules`	`frontpage modules [list\|docs\|request-setup\|enable\|disable\|archive\|config] <key>`
`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.