Configuration

The beta config surface is intentionally small. The worker reads ~/.contextpilot/config.json plus a few environment variables when it starts.

Default config

~/.contextpilot/config.jsonjson

{
  "dbPath": "~/.contextpilot/contextpilot.db",
  "workerPort": 3848,
  "defaultModel": "claude-3-5-sonnet-latest",
  "enableAiSummary": false
}

dbPath·string

SQLite database path. Env override: CONTEXTPILOT_DB.

workerPort·number

Local worker port. Env override: CONTEXTPILOT_PORT.

defaultModel·string

Model label used for estimates when no session model is known. Env override: CONTEXTPILOT_MODEL.

enableAiSummary·boolean

Reserved for future summarization behavior. Defaults to false.

CONTEXTPILOT_DB: override the SQLite path.
CONTEXTPILOT_PORT: worker port used by the engine process.
CONTEXTPILOT_WORKER_URL: URL the CLI and MCP server use to reach the worker.
CONTEXTPILOT_MODEL: model label for estimates.
CONTEXTPILOT_LICENSE_API: license verification endpoint for staging or production.

contextpilot init creates a conservative .contextpilotignore in the current project if one does not exist.

.contextpilotignore

.env*
.git/**
node_modules/**
dist/**
coverage/**
*.key
*.pem