context-lens 0.5.4 → 0.6.0

package/README.md

@@ -41,9 +41,10 @@ context-lens doctor                     # check ports, certs, background state
 context-lens background start           # start detached proxy + UI
 context-lens background status
 context-lens background stop
+context-lens stop                       # shorthand for background stop
 ```
 
-Aliases: `cc` → `claude`, `cx` → `codex`, `cpi` → `pi`, `gm` → `gemini`.
+Aliases: `cc` → `claude`, `cx` → `codex`, `gm` → `gemini`. For `pi`, add `alias cpi='context-lens pi'` to your shell rc.
 
 ## Docker
 
@@ -128,6 +129,7 @@ services:
 - **Context diff:** turn-to-turn delta showing what grew, shrank, or appeared
 - **Findings:** flags large tool results, unused tool definitions, context overflow risk, compaction events
 - **Auto-detection:** recognizes Claude Code, Codex, aider, Pi, and others by source tag or system prompt
+- **Session tagging:** label sessions with custom tags, filter the session list by tag
 - **LHAR export:** download session data as LHAR (LLM HTTP Archive) format ([doc](docs/LHAR.md))
 - **State persistence:** data survives restarts; delete individual sessions or reset all from the UI
 - **Streaming support:** passes through SSE chunks in real-time
@@ -175,14 +177,29 @@ If you prefer to configure it manually, set `baseUrl` in `~/.pi/agent/models.jso
 }
 ```
 
-### OpenAI-Compatible Endpoints
+### OpenCode
+
+OpenCode connects to multiple providers simultaneously over HTTPS. Use `context-lens opencode` — it routes all traffic through mitmproxy so every provider call is captured regardless of which model is active:
+
+```bash
+pipx install mitmproxy
+context-lens opencode
+```
 
-Many providers expose OpenAI-compatible APIs (OpenRouter, Together, Groq, Fireworks, Ollama, vLLM, OpenCode Zen, etc.). Override the upstream URL to point at your provider:
+If you only use OpenCode with a single OpenAI-compatible endpoint (e.g. OpenCode Zen), you can also use the base URL override approach instead:
 
 ```bash
 UPSTREAM_OPENAI_URL=https://opencode.ai/zen/v1 context-lens -- opencode "prompt"
 ```
 
+### OpenAI-Compatible Endpoints
+
+Many providers expose OpenAI-compatible APIs (OpenRouter, Together, Groq, Fireworks, Ollama, vLLM, etc.). Override the upstream URL to point at your provider:
+
+```bash
+UPSTREAM_OPENAI_URL=https://my-provider.com/v1 context-lens -- my-tool "prompt"
+```
+
 `UPSTREAM_OPENAI_URL` is global: all OpenAI-format requests go to that upstream. Use separate proxy instances if you need to hit multiple endpoints simultaneously.
 
 ### Codex Subscription Mode
@@ -196,6 +213,17 @@ context-lens codex
 
 If Codex fails with certificate trust errors, install/trust the mitmproxy CA certificate (`~/.mitmproxy/mitmproxy-ca-cert.pem`) for your environment.
 
+### Pi with ChatGPT Subscription Models
+
+Pi's `openai-codex` provider (e.g. `gpt-5.2-codex`) connects directly to `chatgpt.com` and cannot be redirected via base URL overrides. Use the `--mitm` flag to route through mitmproxy instead:
+
+```bash
+pipx install mitmproxy
+context-lens pi --mitm
+```
+
+Standard OpenAI API models in Pi work fine without `--mitm`.
+
 ## How It Works
 
 Context Lens sits between your coding tool and the LLM API, capturing requests in transit. It has two parts: a **proxy** and an **analysis server**.
@@ -208,7 +236,7 @@ Tool  ─HTTP─▶  Proxy (:4040)  ─HTTPS─▶  api.anthropic.com / api.open
             Analysis Server (:4041)  →  Web UI
 ```
 
-The **proxy** forwards requests to the LLM API and writes each request/response pair to disk. It has **zero external dependencies** (only Node.js built-ins), so you can read the entire proxy source and verify it does nothing unexpected with your API keys.
+The **proxy** forwards requests to the LLM API and writes each request/response pair to disk. It is built on [`@contextio/proxy`](https://github.com/larsderidder/contextio), a minimal package with no external dependencies, so you can read the entire proxy source and verify it does nothing unexpected with your API keys.
 
 The **analysis server** picks up those captures, parses request bodies, estimates tokens, groups requests into conversations, computes composition breakdowns, calculates costs, and scores context health. It serves the web UI and API.
 

package/dist/analysis/ingest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/analysis/ingest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAuEtE"}
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/analysis/ingest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CA+EtE"}

package/dist/analysis/ingest.js

@@ -12,7 +12,9 @@ export function ingestCapture(store, capture) {
     const { provider, apiFormat, requestBody, responseBody } = capture;
     // Build contextInfo from the request body
     let contextInfo;
-    if (requestBody) {
+    if (requestBody &&
+        typeof requestBody === "object" &&
+        !Array.isArray(requestBody)) {
         const body = { ...requestBody };
         // Gemini: model is in the URL path, not in the body
         if (apiFormat === "gemini" && !body.model) {
@@ -70,6 +72,10 @@ export function ingestCapture(store, capture) {
         responseHeaders: capture.responseHeaders,
     };
     // Feed into the store (which handles fingerprinting, scoring, etc.)
-    store.storeRequest(contextInfo, responseData, capture.source, requestBody ?? undefined, meta, capture.requestHeaders, capture.sessionId ?? null);
+    store.storeRequest(contextInfo, responseData, capture.source, requestBody &&
+        typeof requestBody === "object" &&
+        !Array.isArray(requestBody)
+        ? requestBody
+        : undefined, meta, capture.requestHeaders, capture.sessionId ?? null);
 }
 //# sourceMappingURL=ingest.js.map

package/dist/analysis/ingest.js.map

@@ -1 +1 @@
-{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../src/analysis/ingest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK9D;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,OAAoB;IAC9D,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAEnE,0CAA0C;IAC1C,IAAI,WAAwB,CAAC;IAC7B,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;QAChC,oDAAoD;QACpD,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC5D,IAAI,UAAU;gBAAE,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;QACD,WAAW,GAAG,gBAAgB,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,6CAA6C;QAC7C,WAAW,GAAG;YACZ,QAAQ;YACR,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,SAAS;YAChB,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,CAAC;YACd,cAAc,EAAE,cAAc,CAAC,YAAY,CAAC;YAC5C,WAAW,EAAE,cAAc,CAAC,YAAY,CAAC;YACzC,aAAa,EAAE,EAAE;YACjB,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC;oBACxC,MAAM,EAAE,cAAc,CAAC,YAAY,CAAC;iBACrC;aACF;SACF,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,IAAI,YAA0B,CAAC;IAC/B,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;QAChC,YAAY,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAC3D,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,YAAY,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,MAAM,IAAI,GAAgB;QACxB,UAAU,EAAE,OAAO,CAAC,cAAc;QAClC,OAAO,EAAE;YACP,GAAG,OAAO,CAAC,OAAO;YAClB,iBAAiB,EAAE,IAAI;SACxB;QACD,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,eAAe,EAAE,OAAO,CAAC,eAAe;KACzC,CAAC;IAEF,oEAAoE;IACpE,KAAK,CAAC,YAAY,CAChB,WAAW,EACX,YAAY,EACZ,OAAO,CAAC,MAAM,EACd,WAAW,IAAI,SAAS,EACxB,IAAI,EACJ,OAAO,CAAC,cAAc,EACtB,OAAO,CAAC,SAAS,IAAI,IAAI,CAC1B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../src/analysis/ingest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK9D;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,OAAoB;IAC9D,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAEnE,0CAA0C;IAC1C,IAAI,WAAwB,CAAC;IAC7B,IACE,WAAW;QACX,OAAO,WAAW,KAAK,QAAQ;QAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAC3B,CAAC;QACD,MAAM,IAAI,GAAG,EAAE,GAAI,WAAuC,EAAE,CAAC;QAC7D,oDAAoD;QACpD,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC5D,IAAI,UAAU;gBAAE,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;QACD,WAAW,GAAG,gBAAgB,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,6CAA6C;QAC7C,WAAW,GAAG;YACZ,QAAQ;YACR,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,SAAS;YAChB,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,CAAC;YACd,cAAc,EAAE,cAAc,CAAC,YAAY,CAAC;YAC5C,WAAW,EAAE,cAAc,CAAC,YAAY,CAAC;YACzC,aAAa,EAAE,EAAE;YACjB,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC;oBACxC,MAAM,EAAE,cAAc,CAAC,YAAY,CAAC;iBACrC;aACF;SACF,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,IAAI,YAA0B,CAAC;IAC/B,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;QAChC,YAAY,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAC3D,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,YAAY,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,MAAM,IAAI,GAAgB;QACxB,UAAU,EAAE,OAAO,CAAC,cAAc;QAClC,OAAO,EAAE;YACP,GAAG,OAAO,CAAC,OAAO;YAClB,iBAAiB,EAAE,IAAI;SACxB;QACD,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,eAAe,EAAE,OAAO,CAAC,eAAe;KACzC,CAAC;IAEF,oEAAoE;IACpE,KAAK,CAAC,YAAY,CAChB,WAAW,EACX,YAAY,EACZ,OAAO,CAAC,MAAM,EACd,WAAW;QACT,OAAO,WAAW,KAAK,QAAQ;QAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;QAC3B,CAAC,CAAE,WAAmC;QACtC,CAAC,CAAC,SAAS,EACb,IAAI,EACJ,OAAO,CAAC,cAAc,EACtB,OAAO,CAAC,SAAS,IAAI,IAAI,CAC1B,CAAC;AACJ,CAAC"}

package/dist/cli-utils.d.ts

@@ -5,6 +5,7 @@ export interface ParsedCliArgs {
     noOpen: boolean;
     noUi: boolean;
     noUpdateCheck: boolean;
+    useMitm: boolean;
     privacyLevel?: string;
     commandName?: string;
     commandArguments: string[];
@@ -19,6 +20,7 @@ export declare const CLI_CONSTANTS: {
     readonly MITM_PORT: 8080;
     readonly MITM_PROXY_URL: "http://localhost:8080";
     readonly PI_AGENT_DIR_PREFIX: "/tmp/context-lens-pi-agent-";
+    readonly BRYTI_DATA_DIR_PREFIX: "/tmp/context-lens-bryti-";
     readonly COMMAND_ALIASES: Record<string, string>;
     readonly KNOWN_PRIVACY_LEVELS: readonly ["minimal", "standard", "full"];
     readonly MITM_ADDON_PATH: string;

package/dist/cli-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-utils.d.ts","sourceRoot":"","sources":["../src/cli-utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAmB7C,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4DD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAY1D;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAiH1D;AAED,wBAAgB,cAAc,IAAI,MAAM,CA4DvC;AAGD,eAAO,MAAM,aAAa;;;;;;;;CAShB,CAAC"}
+{"version":3,"file":"cli-utils.d.ts","sourceRoot":"","sources":["../src/cli-utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAqB7C,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAsFD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAY1D;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CA2H1D;AAED,wBAAgB,cAAc,IAAI,MAAM,CAmEvC;AAGD,eAAO,MAAM,aAAa;;;;;;;;;CAUhB,CAAC"}

package/dist/cli-utils.js

@@ -8,10 +8,12 @@ const PROXY_URL = "http://localhost:4040";
 const MITM_PORT = 8080;
 const MITM_PROXY_URL = `http://localhost:${MITM_PORT}`;
 const PI_AGENT_DIR_PREFIX = "/tmp/context-lens-pi-agent-";
+const BRYTI_DATA_DIR_PREFIX = "/tmp/context-lens-bryti-";
 const COMMAND_ALIASES = {
     cc: "claude",
     cx: "codex",
     gm: "gemini",
+    oc: "opencode",
 };
 const KNOWN_PRIVACY_LEVELS = ["minimal", "standard", "full"];
 function isPrivacyLevel(value) {
@@ -49,6 +51,19 @@ const TOOL_CONFIG = {
         serverEnv: {},
         needsMitm: false,
     },
+    opencode: {
+        // OpenCode connects directly to each provider's official API over HTTPS
+        // and cannot be redirected via base URL env vars alone when using multiple
+        // providers simultaneously. We use mitmproxy as a forward HTTPS proxy so
+        // all provider traffic is captured regardless of which model is active.
+        childEnv: {
+            https_proxy: MITM_PROXY_URL,
+            SSL_CERT_FILE: "", // filled in by cli.ts with mitmproxy CA cert path
+        },
+        extraArgs: [],
+        serverEnv: {},
+        needsMitm: true,
+    },
     gemini: {
         childEnv: {
             GOOGLE_GEMINI_BASE_URL: `${PROXY_URL}/gemini/`, // API-key auth path
@@ -69,6 +84,19 @@ const TOOL_CONFIG = {
         serverEnv: {},
         needsMitm: false,
     },
+    bryti: {
+        // Bryti reads base_url from its config.yml, not env vars. We point it at
+        // a temporary data dir where cli.ts writes a proxy-aware config.yml copy.
+        // run.sh handles dev mode (tsx) vs prod (node dist/cli.js) automatically
+        // and restarts on crash, matching normal bryti dev workflow.
+        childEnv: {
+            BRYTI_DATA_DIR: BRYTI_DATA_DIR_PREFIX,
+        },
+        extraArgs: [],
+        serverEnv: {},
+        needsMitm: false,
+        executable: "./run.sh",
+    },
 };
 export function getToolConfig(toolName) {
     return (TOOL_CONFIG[toolName] || {
@@ -90,6 +118,7 @@ export function parseCliArgs(args) {
     let noOpen = false;
     let noUi = false;
     let noUpdateCheck = false;
+    let useMitm = false;
     let privacyLevel;
     let explicitSeparator = false;
     let commandStartIndex = -1;
@@ -124,6 +153,10 @@ export function parseCliArgs(args) {
             noUpdateCheck = true;
             continue;
         }
+        if (arg === "--mitm") {
+            useMitm = true;
+            continue;
+        }
         if (arg === "--privacy") {
             if (i + 1 >= args.length) {
                 return {
@@ -132,6 +165,7 @@ export function parseCliArgs(args) {
                     noOpen,
                     noUi,
                     noUpdateCheck,
+                    useMitm,
                     commandArguments: [],
                     error: "Error: Missing value for --privacy. Expected one of: minimal, standard, full",
                 };
@@ -150,6 +184,7 @@ export function parseCliArgs(args) {
             noOpen,
             noUi,
             noUpdateCheck,
+            useMitm,
             commandArguments: [],
             error: `Error: Unknown option '${arg}'. Run 'context-lens --help' for usage.`,
         };
@@ -161,6 +196,7 @@ export function parseCliArgs(args) {
             noOpen,
             noUi,
             noUpdateCheck,
+            useMitm,
             commandArguments: [],
             error: `Error: Invalid privacy level '${privacyLevel}'. Must be one of: ${KNOWN_PRIVACY_LEVELS.join(", ")}`,
         };
@@ -175,6 +211,7 @@ export function parseCliArgs(args) {
             noOpen,
             noUi,
             noUpdateCheck,
+            useMitm,
             privacyLevel,
             commandArguments: [],
             error: "Error: No command specified after --",
@@ -186,6 +223,7 @@ export function parseCliArgs(args) {
         noOpen,
         noUi,
         noUpdateCheck,
+        useMitm,
         privacyLevel,
         commandName,
         commandArguments,
@@ -200,16 +238,20 @@ export function formatHelpText() {
         "  context-lens [global-options] -- [command] [args...]",
         "  context-lens [global-options]   (no command = standalone mode)",
         "  context-lens doctor",
+        "  context-lens stop",
         "  context-lens background <start|stop|status> [--no-ui]",
         "  context-lens analyze <session.lhar> [options]",
         "",
         "Examples:",
         "  context-lens claude",
         "  context-lens codex",
+        "  context-lens opencode",
         "  context-lens gm",
+        "  context-lens bryti",
         "  context-lens --privacy=minimal aider --model claude-sonnet-4",
         "  context-lens -- python my_agent.py",
         "  context-lens doctor",
+        "  context-lens stop",
         "  context-lens background start --no-ui",
         "  context-lens analyze ~/.context-lens/data/claude-abc123.lhar",
         "  context-lens analyze session.lhar --json --main-only",
@@ -222,14 +264,16 @@ export function formatHelpText() {
         "  --no-open              Don't auto-open http://localhost:4041",
         "  --no-ui                Run proxy only (no analysis/web UI server)",
         "  --no-update-check      Skip npm update check for this run",
+        "  --mitm                 Use mitmproxy for interception instead of base URL override (pi only)",
         "",
         "Command aliases:",
         "  cc -> claude",
         "  cx -> codex",
         "  gm -> gemini",
+        "  oc -> opencode",
         "",
-        "Binary aliases:",
-        "  picl  Equivalent to 'context-lens pi'",
+        "Shell alias (add to ~/.zshrc or ~/.bashrc):",
+        "  alias cpi='context-lens pi'",
         "",
         "Environment variables:",
         "  UPSTREAM_OPENAI_URL        Override OpenAI upstream (for OpenAI-compatible APIs)",
@@ -238,7 +282,8 @@ export function formatHelpText() {
         "",
         "Notes:",
         "  - No command starts standalone mode (proxy + analysis/web UI by default).",
-        "  - 'codex' uses mitmproxy for HTTPS interception (requires mitmproxy; install: pipx install mitmproxy).",
+        "  - 'codex' and 'opencode' use mitmproxy for HTTPS interception (requires mitmproxy; install: pipx install mitmproxy).",
+        "  - 'pi --mitm' uses mitmproxy for full interception, useful for subscription-based models (openai-codex provider).",
         "  - 'doctor' is a local diagnostics command.",
         "  - 'background' manages detached proxy/web-ui processes.",
         "  - 'analyze' reads an .lhar file and prints session statistics.",
@@ -258,6 +303,7 @@ export const CLI_CONSTANTS = {
     MITM_PORT,
     MITM_PROXY_URL,
     PI_AGENT_DIR_PREFIX,
+    BRYTI_DATA_DIR_PREFIX,
     COMMAND_ALIASES,
     KNOWN_PRIVACY_LEVELS,
     // Resolved relative to compiled output (dist/ or dist-test/), matching cli.ts behavior.

package/dist/cli-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-utils.js","sourceRoot":"","sources":["../src/cli-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-utils.js","sourceRoot":"","sources":["../src/cli-utils.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { spawn } from "node:child_process";
+import { randomBytes } from "node:crypto";
 import fs from "node:fs";
 import http from "node:http";
 import https from "node:https";
@@ -14,13 +15,8 @@ const __dirname = dirname(__filename);
 // Known tool config: env vars for the child process, extra CLI args, server env vars, and whether mitmproxy is needed
 // Note: actual tool config lives in cli-utils.ts so it can be unit-tested without importing this entrypoint.
 const LOCKFILE = "/tmp/context-lens.lock";
-// When invoked as `picl`, default to the `pi` tool if no command is given.
-const binaryName = process.argv[1] ? process.argv[1].split("/").pop() : "";
 const rawArgs = process.argv.slice(2);
-const isPiclInvocation = binaryName === "picl" &&
-    !rawArgs.some((a) => !a.startsWith("-")) &&
-    !rawArgs.includes("--");
-const parsedArgs = parseCliArgs(isPiclInvocation ? ["pi", ...rawArgs] : rawArgs);
+const parsedArgs = parseCliArgs(rawArgs);
 if (parsedArgs.error) {
     console.error(parsedArgs.error);
     process.exit(1);
@@ -46,6 +42,9 @@ if (parsedArgs.commandName === "analyze") {
 else if (parsedArgs.commandName === "doctor") {
     void runDoctor().then((exitCode) => process.exit(exitCode));
 }
+else if (parsedArgs.commandName === "stop") {
+    process.exit(backgroundStop());
+}
 else if (parsedArgs.commandName === "background") {
     void runBackgroundCommand(parsedArgs.commandArguments, parsedArgs.noUi).then((exitCode) => process.exit(exitCode));
 }
@@ -99,8 +98,19 @@ else {
     const commandArguments = parsedArgs.commandArguments;
     const noOpen = parsedArgs.noOpen;
     const noUi = parsedArgs.noUi;
-    // Get tool-specific config
-    const toolConfig = getToolConfig(commandName);
+    const useMitm = parsedArgs.useMitm;
+    // Get tool-specific config, with optional mitmproxy override for pi
+    let toolConfig = getToolConfig(commandName);
+    if (useMitm && commandName === "pi") {
+        toolConfig = {
+            ...toolConfig,
+            childEnv: {
+                https_proxy: `http://localhost:${CLI_CONSTANTS.MITM_PORT}`,
+                SSL_CERT_FILE: "", // filled in below with mitmproxy CA cert path
+            },
+            needsMitm: true,
+        };
+    }
     if (noUi && toolConfig.needsMitm) {
         console.error("Error: --no-ui is not supported for this command because mitm capture requires the analysis ingest API on :4041.");
         process.exit(1);
@@ -173,6 +183,7 @@ else {
     let mitmReady = false;
     let childProcess = null;
     let piAgentDirToCleanup = null;
+    let brytiDataDirToCleanup = null;
     let shouldShutdownServers = false;
     let cleanupDidRun = false;
     const requiresAnalysis = !noUi;
@@ -357,11 +368,45 @@ else {
     function startChild() {
         // Inject extra args (e.g. codex -c chatgpt_base_url=...) before user args
         const allArgs = [...toolConfig.extraArgs, ...commandArguments];
-        console.log(`\n🚀 Launching: ${commandName} ${allArgs.join(" ")}\n`);
+        const displayTarget = toolConfig.executable
+            ? `${commandName} (${toolConfig.executable})`
+            : commandName;
+        console.log(`\n🚀 Launching: ${displayTarget} ${allArgs.join(" ")}\n`);
         const childEnv = {
             ...process.env,
             ...toolConfig.childEnv,
         };
+        // Embed a per-invocation session ID into proxy base URLs so that separate
+        // CLI runs are always grouped into distinct conversations, even when they
+        // start with identical prompts. The session ID is injected as a path
+        // segment after the source tag, which extractSource() picks up as a
+        // stable conversation key for the lifetime of this process.
+        //
+        // Format: http://localhost:4040/<source>/<session-id>/
+        // Example: http://localhost:4040/gemini/a1b2c3d4/
+        //
+        // Codex uses mitmproxy and has its own chaining via previous_response_id.
+        // Claude Code and Pi embed their own session IDs in request metadata.
+        // Tools without built-in session IDs (Gemini, Aider, custom) rely on this.
+        if (!toolConfig.needsMitm) {
+            const sessionTag = randomBytes(4).toString("hex"); // 8 hex chars
+            for (const key of Object.keys(childEnv)) {
+                const val = childEnv[key];
+                if (typeof val !== "string")
+                    continue;
+                // Match any value that points at our proxy and ends with /<source> or /<source>/
+                const proxyBase = `http://localhost:4040/`;
+                if (!val.startsWith(proxyBase))
+                    continue;
+                const hadTrailingSlash = val.endsWith("/");
+                const after = val.slice(proxyBase.length).replace(/\/$/, "");
+                // Only inject if the remaining path is just the source tag (no session already)
+                if (after && !after.includes("/")) {
+                    const suffix = hadTrailingSlash ? "/" : "";
+                    childEnv[key] = `${proxyBase}${after}/${sessionTag}${suffix}`;
+                }
+            }
+        }
         // Fill in mitmproxy CA cert path for tools that need HTTPS interception
         if (toolConfig.needsMitm && childEnv.SSL_CERT_FILE === "") {
             const certPath = join(homedir(), ".mitmproxy", "mitmproxy-ca-cert.pem");
@@ -372,18 +417,22 @@ else {
                 console.error(`Warning: mitmproxy CA cert not found at ${certPath}. Run 'mitmdump' once to generate it.`);
             }
         }
-        if (commandName === "pi") {
+        if (commandName === "pi" && !useMitm) {
             childEnv.PI_CODING_AGENT_DIR = preparePiAgentDir(childEnv.PI_CODING_AGENT_DIR);
         }
+        if (commandName === "bryti") {
+            childEnv.BRYTI_DATA_DIR = prepareBrytiDataDir(childEnv.BRYTI_DATA_DIR);
+        }
         // Spawn the child process with inherited stdio (interactive)
         // No shell: true. Avoids intermediate process that breaks signal delivery
-        childProcess = spawn(commandName, allArgs, {
+        const spawnTarget = toolConfig.executable ?? commandName;
+        childProcess = spawn(spawnTarget, allArgs, {
             stdio: "inherit",
             env: childEnv,
         });
         childProcess.on("error", (err) => {
             if (err.code === "ENOENT") {
-                console.error(`\nFailed to start '${commandName}': command not found.`);
+                console.error(`\nFailed to start '${spawnTarget}': command not found.`);
                 console.error("Try a known tool (claude, codex, gemini, aider, pi) or use:");
                 console.error("  context-lens -- <your-command> [args...]");
                 cleanup(127);
@@ -554,6 +603,91 @@ else {
             return targetDir;
         }
     }
+    /**
+     * Create a temporary Bryti data directory with a proxy-aware config.yml.
+     *
+     * Bryti reads base_url for each model provider from its config.yml and does
+     * not respect environment variable overrides. We copy the real config (from
+     * the original BRYTI_DATA_DIR or ./data) into a temp dir, rewriting every
+     * provider's base_url to point at the context-lens proxy, then set
+     * BRYTI_DATA_DIR to the temp dir so Bryti picks up the patched config.
+     *
+     * The original config is never modified. The temp dir is cleaned up on exit.
+     *
+     * Bryti also writes runtime state (history, memory, pi agent dir, etc.) into
+     * BRYTI_DATA_DIR. Those paths all live under the temp dir for this session,
+     * which is intentional: captures are ephemeral, not merged back.
+     *
+     * If no config.yml is found in the source data dir, we warn and fall back to
+     * the temp dir without a config patch (bryti will error on its own).
+     */
+    function prepareBrytiDataDir(targetDirEnv) {
+        const dirPrefix = targetDirEnv && targetDirEnv.length > 0
+            ? targetDirEnv
+            : join(tmpdir(), "context-lens-bryti-");
+        const targetDir = fs.mkdtempSync(dirPrefix);
+        brytiDataDirToCleanup = targetDir;
+        // Find the real bryti data dir: check BRYTI_DATA_DIR in current env (before
+        // our override) or fall back to ./data relative to cwd.
+        const realDataDir = resolve(process.env.BRYTI_DATA_DIR || join(process.cwd(), "data"));
+        const sourceConfigPath = join(realDataDir, "config.yml");
+        try {
+            if (!fs.existsSync(sourceConfigPath)) {
+                console.error(`Warning: no Bryti config.yml found at ${sourceConfigPath}. ` +
+                    "Bryti will start without a proxy-patched config.");
+                return targetDir;
+            }
+            const raw = fs.readFileSync(sourceConfigPath, "utf-8");
+            // Patch every `base_url:` value in the YAML that looks like an HTTP(S)
+            // URL (or is empty, meaning default Anthropic). We replace all provider
+            // base URLs with the proxy URL so all traffic is captured.
+            //
+            // We do a targeted line-level rewrite rather than full YAML parse+emit to
+            // avoid disturbing formatting, comments, or env-var substitution markers
+            // (${VAR}) that would fail a raw parse before substitution.
+            const proxyBase = `${CLI_CONSTANTS.PROXY_URL}/bryti`;
+            const patched = raw
+                .split("\n")
+                .map((line) => {
+                // Match lines like:  base_url: "..." or  base_url: ''  or  base_url:
+                // Only rewrite lines that are clearly provider base_url fields.
+                const m = line.match(/^(\s*base_url:\s*)(.*)$/);
+                if (!m)
+                    return line;
+                // Preserve the indent + key, replace the value
+                return `${m[1]}"${proxyBase}"`;
+            })
+                .join("\n");
+            const targetConfigPath = join(targetDir, "config.yml");
+            fs.writeFileSync(targetConfigPath, patched, "utf-8");
+            // Symlink everything else from the real data dir (history, memory,
+            // extension files, etc.) so bryti picks up existing state.
+            // Skip config.yml (already written above) and the .pi subdir (bryti
+            // regenerates it from config, and mixing temp + real paths would be
+            // confusing).
+            if (fs.existsSync(realDataDir)) {
+                for (const entry of fs.readdirSync(realDataDir, {
+                    withFileTypes: true,
+                })) {
+                    if (entry.name === "config.yml" || entry.name === ".pi")
+                        continue;
+                    const src = join(realDataDir, entry.name);
+                    const dst = join(targetDir, entry.name);
+                    try {
+                        fs.symlinkSync(src, dst);
+                    }
+                    catch {
+                        // Non-fatal: if symlink fails, bryti will recreate the dir/file
+                    }
+                }
+            }
+            return targetDir;
+        }
+        catch (err) {
+            console.error("Warning: failed to prepare Bryti proxy config:", err instanceof Error ? err.message : String(err));
+            return targetDir;
+        }
+    }
     // Open browser (cross-platform)
     function openBrowser(url) {
         const cmd = platform() === "darwin"
@@ -584,6 +718,14 @@ else {
                 console.error("Warning: failed to clean up temporary Pi config dir:", err instanceof Error ? err.message : String(err));
             }
         }
+        if (brytiDataDirToCleanup) {
+            try {
+                fs.rmSync(brytiDataDirToCleanup, { recursive: true, force: true });
+            }
+            catch (err) {
+                console.error("Warning: failed to clean up temporary Bryti data dir:", err instanceof Error ? err.message : String(err));
+            }
+        }
         if (remainingRefs === 0 && shouldShutdownServers) {
             if (proxyProcess && !proxyProcess.killed)
                 proxyProcess.kill();
@@ -915,9 +1057,9 @@ async function runDoctor() {
     // mitmproxy is only needed for Codex subscription mode, so report as
     // informational rather than a hard failure.
     const mitmdumpPath = findBinaryOnPath("mitmdump");
-    info("mitmdump (Codex only)", mitmdumpPath ?? "not found (install: pipx install mitmproxy)");
+    info("mitmdump (Codex, pi --mitm)", mitmdumpPath ?? "not found (install: pipx install mitmproxy)");
     const certPath = join(homedir(), ".mitmproxy", "mitmproxy-ca-cert.pem");
-    info("mitm CA cert (Codex only)", fs.existsSync(certPath)
+    info("mitm CA cert (Codex, pi --mitm)", fs.existsSync(certPath)
         ? certPath
         : "not present (run 'mitmdump' once to generate)");
     const contextDir = join(homedir(), ".context-lens");