Concept reference

CLI & Environment

The simpilot CLI surface and the environment variables the platform reads.

1 min read

CLI

packages/cli exposes user-facing commands for case authoring, run launching, log inspection, and report export. Skip the CLI for browser-first workflows; reach for it when scripting batch studies or wiring CI.

Environment management

Production environment variables are managed via the Vercel project. Local development uses vercel env pull .env.local. Tenant-scoped secrets never live in environment variables — they go through the secrets service.

Core variables

  • DATABASE_URL — primary Postgres URL.
  • AI_GATEWAY_API_KEY — Vercel AI Gateway entry token.
  • LANGFUSE_* — observability provider keys.
  • SENTRY_DSN — error monitoring.
  • EGRESS_PROXY_URL — outbound proxy endpoint.
  • WORKLOAD_IDENTITY_* — AWS workload identity for the compute plane.

The canonical list lives in apps/web/lib/env.ts and is Zod-validated at boot.

Was this page helpful?

Edit this page on GitHub

Search docs

Find pages across the SimPilot docs.