Local data and environment
Control where Praxis reads configuration, stores state, and runs local tools.
Data directory
Praxis stores runtime data in .praxis/ under the current working directory by default.
| Path | Contents |
|---|---|
.praxis/state.json | Current validated simulation snapshot |
.praxis/events.jsonl | Append-only simulation event history |
.praxis/connectors/<id>.json | Per-connector remote mappings and observation state |
Set PRAXIS_DATA_DIR to put all three somewhere else.
Workspace directory
The workspace directory is the base for local runtime context and the Claude CLI. The config directory defaults to <workspace>/config and contains connectors.json.
Set PRAXIS_WORKSPACE_DIR to change the working context, or PRAXIS_CONFIG_DIR to move configuration without moving the rest of the workspace.
Environment reference
| Variable | Default | Purpose |
|---|---|---|
PRAXIS_DATA_DIR | <cwd>/.praxis | Simulation state, events, and ledgers |
PRAXIS_WORKSPACE_DIR | process.cwd() | Connector config and Claude working directory |
PRAXIS_CONFIG_DIR | <workspace>/config | Directory containing writable configuration |
PRAXIS_CONNECTORS_PATH | <config>/connectors.json | Most specific connector file override |
PRAXIS_CLAUDE_COMMAND | claude | Claude CLI executable |
PRAXIS_CLAUDE_MODEL | haiku | Model passed to Claude |
PRAXIS_CLAUDE_MAX_BUDGET_USD | 0.05 | Default per-call budget outside the tick adapter |
PRAXIS_CLAUDE_TIMEOUT_MS | 30000 | Claude process timeout |
Resetting data
Prefer POST /api/simulation or the panel reset action. It creates a valid fresh state and records a new seed event.
Deleting local files is useful only when diagnosing corrupt or obsolete development data. The loader also self-recovers from a missing state file or a state file that no longer validates.