@guanghechen/kit-copilot

GitHub Copilot proxy server for Claude, Codex, and Gemini compatible endpoints.

Environment Model

kit-copilot follows a strict environment flow:

1. CLI entry passes process.env to @guanghechen/commander/node.
2. Commander merges user envs with preset envs into ctx.envs.
3. Runtime logic consumes ctx.envs only.

There is no runtime fallback from business logic to global process.env for critical keys such as:

• GH_PRIMARY_TOKEN
• COPILOT_MODEL_REFRESH_SEC

Preset File (preset.json)

Config root:

• $XDG_CONFIG_HOME/kit/copilot when XDG_CONFIG_HOME is set
• ~/.config/kit/copilot otherwise

Default preset file:

• <config-root>/preset.json

Commander loads preset data from preset.json (preset.file) and merges selected profile into ctx.envs. If <config-root>/preset.json does not exist, command runs without preset envs.

Example preset.json:

{
  "version": 1,
  "defaults": { "profile": "default" },
  "profiles": {
    "default": {
      "envFile": ".env.local"
    }
  }
}

Token Persistence

kit-copilot auth persists GH_PRIMARY_TOKEN to preset env storage.

• Persist target: <config-root>/.env.local
• GH_COPILOT_TOKEN is not persisted

Note: .env.local is not auto-loaded by commander unless preset.json profile points to it (for example via envFile).

Examples

kit-copilot auth
kit-copilot start --port=4141

With preset env file:

GH_PRIMARY_TOKEN=ghu_xxx
COPILOT_MODEL_REFRESH_SEC=300