Skip to main content

Reference

Useful Commands

pnpm local                   # Start full local stack (web + agent + docker services)
pnpm auth                    # Start local stack and open /providers for auth setup
pnpm upload:vps              # Upload local auth sessions to VPS
pnpm self-host               # Start full self-hosted stack
pnpm self-host:app           # Restart app stack only
pnpm self-host:public        # Restart public stack only
pnpm self-host:build         # Build and start both stacks from source
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/cloud)
/peopleTeam members

App Modes

CapabilityCloudLocalSelf-Host
Interactive provider authYes
Manual prompt runsYes
Recurring schedulingYesYes
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.