codex-copilot-dx 0.1.6 → 0.4.1

package/README.md

@@ -1,21 +1,21 @@
 # codex-copilot-dx
 
-Use [Codex Desktop](https://openai.com/codex) app with your **GitHub Copilot** subscription.
+Use [Codex Desktop](https://openai.com/codex) **and** [Claude Code](https://claude.com/claude-code) with your **GitHub Copilot** subscription.
 
 ## How it works
 
-Codex Desktop uses OpenAI's Responses API (`/v1/responses`), which isn't directly exposed by the GitHub Copilot API proxy. This tool bridges the gap:
+A single in-process adapter (port `2026`) exposes both APIs over your Copilot subscription:
 
-- **GPT-5.5, GPT-5.4** and other Responses-only models → proxied directly to `api.githubcopilot.com/v1/responses`
-- **GPT-4o, GPT-4.1** and other chat models → converted from Responses API to Chat Completions format via `copilot-api`
+- **Codex** -> OpenAI Responses API (`/v1/responses`, `/v1/responses/compact`); Responses-only models and compaction proxy directly, chat models convert to Chat Completions.
+- **Claude Code** -> Anthropic Messages API (`/v1/messages`, `/v1/messages/count_tokens`), translated to/from Chat Completions.
 
-Supports both HTTP SSE streaming and WebSocket connections.
+Supports both HTTP SSE streaming and non-streaming.
 
 ## Prerequisites
 
-- [Codex Desktop](https://openai.com/codex) app installed
 - GitHub Copilot subscription (Individual, Business, or Enterprise)
 - Node.js 18+
+- [Codex Desktop](https://openai.com/codex) and/or [Claude Code](https://claude.com/claude-code) installed
 
 ## Usage
 
@@ -27,30 +27,42 @@ npx codex-copilot-dx@latest
 
 On first run, it will:
 1. Authenticate with GitHub via device flow (if needed)
-2. Start `copilot-api` proxy (port 4141)
-3. Start the Responses API adapter (port 4142)
-4. Configure Codex to use the adapter
+2. Start the adapter (port `2026`)
+3. Configure Codex (`~/.codex/config.toml`) to use the adapter, including stale shell env base URLs if present
+4. Configure Claude Code (`~/.claude/settings.json`) to use the adapter; it creates the file when missing, otherwise backs up `settings.json.bak` before updating the local API env keys
 5. Launch Codex Desktop
 
+Claude Code picks up the new `ANTHROPIC_BASE_URL` on its next launch.
+
+Do not set Claude Code by manually exporting `ANTHROPIC_BASE_URL` or `ANTHROPIC_AUTH_TOKEN` in your shell. Let `codex-copilot-dx` write the local config files instead. If you previously exported those variables, remove them from shell startup files and restart the terminal before launching Claude Code.
+
 ## Configuration
 
 Environment variables:
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `COPILOT_API_PORT` | `4141` | Port for copilot-api |
-| `ADAPTER_PORT` | `4142` | Port for the adapter |
-| `CCDX_IMG_MAX_DIM` | `2048` | Max long-edge (px) for image downscaling |
+| `ADAPTER_PORT` | `2026` | Port for the adapter |
+| `CCDX_IMG_MAX_DIM` | `2048` | Max long edge in pixels for image downscaling |
 | `CCDX_IMG_QUALITY` | `85` | WebP quality used when re-encoding images |
 | `CCDX_IMG_MIN_BYTES` | `100000` | Images smaller than this are left untouched |
 | `CCDX_DISABLE_IMG_OPT` | unset | Set to `1` to disable image optimization |
-| `CCDX_DEBUG` | unset | Set to `1` for verbose request diagnostics |
+| `CCDX_USAGE_PATH` | `~/.local/share/codex-copilot-dx/usage.jsonl` | Local JSONL token usage log |
+| `CCDX_DISABLE_USAGE` | unset | Set to `1` to disable usage logging |
+
+### Usage logging
+
+The adapter records token usage metadata to `~/.local/share/codex-copilot-dx/usage.jsonl` when upstream responses include usage fields. It logs counts, model names, API surface, and response IDs only; it does not log prompts, completions, tool arguments, or image content.
+
+```bash
+codex-copilot-dx usage
+```
 
 ### Image optimization
 
-Long computer-use sessions can accumulate dozens of screenshots inside the conversation history. Each screenshot is shipped on every subsequent turn, and GitHub Copilot's `/v1/responses` endpoint rejects requests larger than ~5 MB with `413 Payload Too Large`.
+Long computer-use sessions can accumulate screenshots inside the conversation history. Each screenshot is shipped on later turns, and GitHub Copilot's `/responses` endpoint can reject oversized requests with `413 Payload Too Large`.
 
-To avoid that, the adapter automatically downsamples embedded screenshots to long-edge ≤ 2048 px and re-encodes them as WebP before forwarding the request. Typical UI screenshots shrink to 10–15% of their original size with minimal perceptual loss. Disable with `CCDX_DISABLE_IMG_OPT=1` if you need pixel-perfect originals.
+The adapter automatically downsamples embedded screenshots to long-edge <= 2048 px and re-encodes them as WebP before forwarding `/v1/responses`.
 
 ## License
 

package/bin/cli.mjs

@@ -1,11 +1,19 @@
 #!/usr/bin/env node
 
-import { ensureAuth, startCopilotApi, openCodex } from "../src/launcher.mjs";
+import { ensureAuth, openCodex } from "../src/launcher.mjs";
 import { ensureCodexConfig } from "../src/config.mjs";
+import { ensureClaudeConfig } from "../src/claude-config.mjs";
 import { startAdapter } from "../src/adapter.mjs";
+import { refreshVSCodeVersion } from "../src/copilot.mjs";
+import { status } from "../src/status.mjs";
+import { printUsageSummary } from "../src/usage.mjs";
 
-const COPILOT_PORT = parseInt(process.env.COPILOT_API_PORT || "4141");
-const ADAPTER_PORT = parseInt(process.env.ADAPTER_PORT || "4142");
+const ADAPTER_PORT = parseInt(process.env.ADAPTER_PORT || "2026");
+
+if (process.argv[2] === "usage") {
+  await printUsageSummary();
+  process.exit(0);
+}
 
 console.log(`
   codex-copilot-dx
@@ -13,37 +21,35 @@ console.log(`
 `);
 
 try {
-  // 1. Ensure GitHub auth
+  // Ensure GitHub login, using device flow if no token exists.
   await ensureAuth();
 
-  // 2. Start copilot-api (for legacy models)
-  const copilotProc = await startCopilotApi(COPILOT_PORT);
+  // Refresh the VS Code version in the background; fallback is non-blocking.
+  refreshVSCodeVersion();
 
-  // 3. Start adapter
+  // Start the in-process adapter.
   await startAdapter(ADAPTER_PORT);
 
-  // 4. Configure Codex
+  // Point Codex and Claude Code at the adapter.
   ensureCodexConfig(ADAPTER_PORT);
+  ensureClaudeConfig(ADAPTER_PORT);
 
-  // 5. Launch Codex
+  // Launch Codex when available.
   openCodex();
 
   console.log(`
-  Ready! Codex is using your GitHub Copilot subscription.
+  ${status("ok", "Ready. Codex and Claude Code are using your GitHub Copilot subscription.")}
 
-  Adapter:     http://localhost:${ADAPTER_PORT}
-  copilot-api: http://localhost:${COPILOT_PORT}
+  Adapter: http://localhost:${ADAPTER_PORT}
 
   Press Ctrl+C to stop.
 `);
 
-  // Keep alive
   process.on("SIGINT", () => {
-    console.log("\nShutting down...");
-    copilotProc?.kill();
+    console.log(`\n${status("wait", "Shutting down...")}`);
     process.exit(0);
   });
 } catch (e) {
-  console.error(`Error: ${e.message}`);
+  console.error(status("err", e.message));
   process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-copilot-dx",
-  "version": "0.1.6",
+  "version": "0.4.1",
   "description": "Use Codex Desktop app with your GitHub Copilot subscription",
   "type": "module",
   "bin": {
@@ -9,8 +9,7 @@
   "files": [
     "bin/",
     "src/",
-    "README.md",
-    "CHANGELOG.md"
+    "README.md"
   ],
   "keywords": [
     "codex",
@@ -21,8 +20,11 @@
     "responses-api"
   ],
   "license": "MIT",
+  "scripts": {
+    "test": "node --test"
+  },
   "dependencies": {
-    "copilot-api": "^0.7.0",
-    "sharp": "^0.33.5"
+    "gpt-tokenizer": "^3.4.0",
+    "sharp": "^0.34.5"
   }
 }