Install

Start

Configuration

Layered, schema-validated Pax configuration with environment variables and repository-local overrides.

1 min readUpdated

Pax configuration is layered, schema-validated, and migration-ready.

Precedence

  1. Built-in defaults
  2. User config: ~/.config/pax/config.json
  3. Repository config: .pax/pax.config.json
  4. Environment variables
  5. CLI flags

Environment variables

VariableEffect
PAX_JSONForce JSON output
PAX_VERBOSEVerbose mode
PAX_QUIETQuiet mode
PAX_CACHE_DIROverride cache directory
PAX_INFERENCE_MODEdisabled, agent-native, byok, openai-compatible, local
PAX_INFERENCE_ENDPOINTUser-owned endpoint
PAX_INFERENCE_MODELOptional model id
CIEnables CI mode
NO_COLOR / FORCE_COLORColor control

Project layout

.pax/
  pax.config.json
  brand.json
  motion.json
  rules.md
  references/
  approved/
  snapshots/
  cache/

Commit portable files only. Ignore .pax/cache/, .pax/snapshots/, and *.local.json.

Inference modes

Pax never hosts inference. Deterministic recipes and diagnostics work with inference.mode = "disabled".

Commands

pnpm paxfx config list
pnpm paxfx config get inference.mode
pnpm paxfx config set inference.mode disabled

Was this page helpful?

Edit this page

Answers are not recorded or transmitted. Pax has no telemetry.