Pier
Docs

Documentation

Configuration

Understand Pier config files, local state, and bridge environment variables.

State Directory

Pier stores local state in:

  • ~/.pier/config.json
  • ~/.pier/bridge.pid
  • ~/.pier/bridge.log
  • ~/.pier/workspace-routes.json (default mapping registry)

Config File (~/.pier/config.json)

Pier normalizes and maintains this file automatically.

High-level shape includes:

  • version
  • createdAt
  • updatedAt
  • bridge.host
  • bridge.port
  • bridge.token
  • bridge.defaultCwd
  • bridge.shell
  • bridge.workspaceRouteMapPath

Environment Variables (Bridge)

Bridge runtime consumes:

  • PIER_HOST
  • PIER_PORT
  • PIER_TOKEN
  • PIER_CWD
  • PIER_SHELL
  • PIER_WORKSPACE_ROUTE_MAP
  • PIER_SESSION_DETACH_TIMEOUT_MS

Extension Settings

Pier stores terminal rendering and connection settings in extension storage keys.

Compatibility note: older storage keys are migrated automatically on load.