Skip to main content

Useful Commands

pnpm local                   # Start full local stack from local source and refresh Docker service/base images when available
pnpm auth                    # Capture provider sessions locally; prompts to upload to VPS at the end
pnpm upload:vps              # Re-upload existing local sessions to VPS without re-running the auth flow
pnpm self-host               # Pull latest published images and start the self-hosted stack; auto-builds locally if your architecture is not published yet
pnpm self-host:build         # Build from source and start the self-hosted stack
pnpm typecheck               # Typecheck the monorepo
pnpm build                   # Build all packages

Key Routes

RouteDescription
/dashboardVisibility metrics and GEO scores
/promptsManage and run prompts
/sourcesSource and citation attribution
/providersConnect and manage provider auth sessions
/scheduleManual run trigger (local) or recurring schedule editor (self-host)
/peopleTeam members

App Modes

CapabilityLocalSelf-Host
Interactive provider authYes
Manual prompt runsYesYes
Recurring schedulingYes
Full data ownershipYesYes

Auth Groups

Each auth group covers one or more runtime providers:
Auth GroupCovers
GoogleGemini, AI Overview
ChatGPTChatGPT
PerplexityPerplexity
ClaudeClaude

Storage Model

  • Portable auth bundles — one per auth group, transferable to VPS, source of truth
  • Persistent runtime profiles — one per provider, machine-local, seeded from the auth bundle
If a runtime profile is missing or the auth bundle has changed, the profile is reseeded automatically. Otherwise the existing profile is reused.