Configuration

BlocPad CLI stores local configuration in a per-user directory.

Config directory

macOS: ~/Library/Application Support/blocpad/
Linux: ~/.config/blocpad/ (or $XDG_CONFIG_HOME/blocpad/)
Windows: %APPDATA%\\blocpad\\ (or %LOCALAPPDATA%\\blocpad\\)

Override the config directory (useful for testing):

export BLOCPAD_CONFIG_DIR=/path/to/dir

Files

config.json: base URL, auth token, and active context (project/task)
proposals.json: local proposals cache (used by some workflows)

`config.json` schema

{
  "schemaVersion": 1,
  "auth": { "token": "bp_pat_..." },
  "context": { "projectId": "prj_123", "taskId": "task_123" }
}

Resolution order

For most settings, the CLI resolves values in this order:

CLI flags (example: --token)
Environment variables (example: BLOCPAD_TOKEN)
config.json
Built-in defaults (if applicable)

If you are seeing unexpected behavior, run blocpad auth status --json to confirm what the CLI is using.