reference configuration

Configuration

Active contributors: Zachary BENSALEM

This page collects the configuration that affects the local Fleet web interface, the pinned runtime, and the user's persisted Prime Agent state. Defaults come from the current source and package manifests.

Environment variables

Name	Consumer	Purpose	Default
PRIME_AGENT_WORKSPACE_ROOT	web/server/src/workspace-root.ts	Select the root used by the file tree, file reads, and new sessions.	Nearest ancestor containing .git, starting from the process cwd
PRIME_AGENT_SESSION_DIR	web/server/src/daemon-runtime.ts	Override the shared persisted session directory.	Settings value, then <agent dir>/sessions
PRIME_AGENT_CODING_AGENT_SESSION_DIR	web/server/src/daemon-runtime.ts	Alternate name for the session-directory override.	Same as above
PRIME_RUNTIME_VERIFY_TARBALL	scripts/check-prime-agent-runtime.mjs	When =1, download and hash-check the pinned runtime archive.	Manifest and lockfile checks only
PRIME_BRIDGE_DEBUG	web/server/src/prime-bridge.ts, web/server/src/handlers/chat.ts	Write bridge and chat diagnostics to stderr when =1.	Unset
VITE_FLEET_PI_CHAT_RUNTIME_URL	web/app/src/lib/pi/chat-runtime-url.ts	Use a separate base URL for selected runtime API paths.	Same-origin

web/server/src/prime-provider-env-map.ts contains the built-in provider to credential-environment mapping. PRIME_PROVIDER_ENV_MAP is a TypeScript constant, not a user environment variable.

Repository configuration

Path	Controls
PRIME_AGENT_RUNTIME.json	The pinned prime-agent package, version 0.9.1, release tarball URL, and SHA-256.
pnpm-workspace.yaml	Workspace members, seven-day release age, trust policy, allowed install scripts, exotic dependency handling, and security/build overrides.
package.json	Root package manager version (pnpm@11.15.1), Node floor, build/check/test/release scripts, and toolchain dependencies.
packages/fleet-web/package.json	Published package metadata, binaries, OS allowlist, package file allowlist, and runtime dependencies.
biome.json	Repository formatting and lint rules.
web/doctor.config.jsonc	React Doctor scope and documented diagnostic waivers for the web packages.
.circleci/config.yml	Validation jobs, package verification, Changesets release preparation, and publication jobs.

User state

Prime Agent resolves the agent directory under the user's home directory. Fleet writes its product-owned state next to upstream state:

Path	Owner and contents
~/.prime/agent/fleet-projects.json	web/server/src/project-registry.ts; registered projects and session assignments
~/.prime/agent/models.json	web/server/src/custom-provider-store.ts; custom and OpenAI-compatible provider registrations
~/.prime/agent/settings.json	Prime Agent settings read through getPrimeConfig()
~/.prime/agent/auth.json	Prime Agent provider credentials managed by its AuthStorage
~/.prime/agent/sessions/<sessionId>.jsonl	Upstream session transcripts; Fleet does not append directly
~/.prime/agent/session-artifacts/<sessionId>/presentation.json	Fleet session presentation sidecar
~/.prime/agent/session-plan-presentations/<sessionId>/presentations.json	Fleet Plan-mode presentation sidecar
~/.prime/agent/session-attachments/<sessionId>/	Managed upload metadata and file data
$TMPDIR/prime-agent-<UID>/daemon.sock	Local Prime Agent daemon socket

Sidecars are validated and written by web/server/src/prime-agent-presentation.ts and web/server/src/managed-plan-presentations.ts. They are separate from the upstream transcript.

Runtime toggles

• The packaged launcher accepts --host, --port, and --help. --host is loopback-only and defaults to 127.0.0.1; --port defaults to 3000 and accepts 0 for an ephemeral port.
• web/app/src/lib/pi/panel-keybindings.ts defines configurable actions for panel and chat focus. Browser overrides are stored under fleet-prime:v1:panel-keybindings.
• web/design/src/lib/ui-preferences.ts stores density and reduced-motion preferences under fleet-prime:v1:ui-preferences.
• Chat requests can select agent, plan, or harness mode and can toggle OpenUI prompting. The daemon fixes its system prompt at worker creation, so web/server/src/daemon-runtime.ts can reopen a worker at an idle boundary when the prompt configuration changes.

See data models for the configuration types exposed through the web API and security for the boundaries around workspace and credential state.