@tonyclaw/agent-inspector 2.0.14 → 2.0.16

package/.output/server/{_tanstack-start-manifest_v-CHekFSzj.mjs → _tanstack-start-manifest_v-xeOo5gW5.mjs}

@@ -1,4 +1,4 @@
-const tsrStartManifest = () => ({ "routes": { "__root__": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/__root.tsx", "children": ["/", "/api/config", "/api/health", "/api/logs", "/api/mcp", "/api/models", "/api/providers", "/api/sessions", "/proxy/$", "/session/$sessionId", "/api/knowledge/candidates", "/api/knowledge/project-context", "/api/knowledge/search", "/api/knowledge/sessions/$sessionId/candidates"], "preloads": ["/assets/main-D6wegveF.js"], "assets": [] }, "/": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-_7blCOK0.js", "/assets/ProxyViewerContainer-vc50msJj.js"] }, "/api/config": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/config.ts", "children": ["/api/config/paths"] }, "/api/health": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/health.ts" }, "/api/logs": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.ts", "children": ["/api/logs/$id", "/api/logs/stream"] }, "/api/mcp": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/mcp.ts" }, "/api/models": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/models.ts" }, "/api/providers": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.ts", "children": ["/api/providers/$providerId", "/api/providers/export", "/api/providers/import", "/api/providers/scan"] }, "/api/sessions": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/sessions.ts" }, "/proxy/$": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/proxy/$.ts" }, "/session/$sessionId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/session/$sessionId.tsx", "assets": [], "preloads": ["/assets/_sessionId-3bjQPmHl.js", "/assets/ProxyViewerContainer-vc50msJj.js"] }, "/api/config/paths": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/config.paths.ts" }, "/api/knowledge/candidates": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.ts", "children": ["/api/knowledge/candidates/$candidateId"] }, "/api/knowledge/project-context": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.project-context.ts" }, "/api/knowledge/search": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.search.ts" }, "/api/logs/$id": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.ts", "children": ["/api/logs/$id/chunks", "/api/logs/$id/replay"] }, "/api/logs/stream": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.stream.ts" }, "/api/providers/$providerId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.ts", "children": ["/api/providers/$providerId/model-metadata", "/api/providers/$providerId/test"] }, "/api/providers/export": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.export.ts" }, "/api/providers/import": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.import.ts" }, "/api/providers/scan": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.scan.ts" }, "/api/knowledge/candidates/$candidateId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.$candidateId.ts", "children": ["/api/knowledge/candidates/$candidateId/promote"] }, "/api/logs/$id/chunks": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.chunks.ts" }, "/api/logs/$id/replay": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.replay.ts" }, "/api/providers/$providerId/model-metadata": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.model-metadata.ts" }, "/api/providers/$providerId/test": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.test.ts", "children": ["/api/providers/$providerId/test/log"] }, "/api/knowledge/candidates/$candidateId/promote": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.$candidateId.promote.ts" }, "/api/knowledge/sessions/$sessionId/candidates": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.sessions.$sessionId.candidates.ts" }, "/api/providers/$providerId/test/log": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.test.log.ts" } }, "clientEntry": "/assets/main-D6wegveF.js" });
+const tsrStartManifest = () => ({ "routes": { "__root__": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/__root.tsx", "children": ["/", "/api/config", "/api/health", "/api/logs", "/api/mcp", "/api/models", "/api/providers", "/api/sessions", "/proxy/$", "/session/$sessionId", "/api/knowledge/candidates", "/api/knowledge/project-context", "/api/knowledge/search", "/api/knowledge/sessions/$sessionId/candidates"], "preloads": ["/assets/main-B2t-3SYj.js"], "assets": [] }, "/": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/index.tsx", "assets": [], "preloads": ["/assets/index-BkdYiTpV.js", "/assets/ProxyViewerContainer-B1KylMPs.js"] }, "/api/config": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/config.ts", "children": ["/api/config/paths"] }, "/api/health": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/health.ts" }, "/api/logs": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.ts", "children": ["/api/logs/$id", "/api/logs/stream"] }, "/api/mcp": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/mcp.ts" }, "/api/models": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/models.ts" }, "/api/providers": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.ts", "children": ["/api/providers/$providerId", "/api/providers/export", "/api/providers/import", "/api/providers/scan"] }, "/api/sessions": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/sessions.ts" }, "/proxy/$": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/proxy/$.ts" }, "/session/$sessionId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/session/$sessionId.tsx", "assets": [], "preloads": ["/assets/_sessionId-CShO0OrR.js", "/assets/ProxyViewerContainer-B1KylMPs.js"] }, "/api/config/paths": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/config.paths.ts" }, "/api/knowledge/candidates": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.ts", "children": ["/api/knowledge/candidates/$candidateId"] }, "/api/knowledge/project-context": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.project-context.ts" }, "/api/knowledge/search": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.search.ts" }, "/api/logs/$id": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.ts", "children": ["/api/logs/$id/chunks", "/api/logs/$id/replay"] }, "/api/logs/stream": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.stream.ts" }, "/api/providers/$providerId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.ts", "children": ["/api/providers/$providerId/model-metadata", "/api/providers/$providerId/test"] }, "/api/providers/export": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.export.ts" }, "/api/providers/import": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.import.ts" }, "/api/providers/scan": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.scan.ts" }, "/api/knowledge/candidates/$candidateId": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.$candidateId.ts", "children": ["/api/knowledge/candidates/$candidateId/promote"] }, "/api/logs/$id/chunks": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.chunks.ts" }, "/api/logs/$id/replay": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/logs.$id.replay.ts" }, "/api/providers/$providerId/model-metadata": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.model-metadata.ts" }, "/api/providers/$providerId/test": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.test.ts", "children": ["/api/providers/$providerId/test/log"] }, "/api/knowledge/candidates/$candidateId/promote": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.candidates.$candidateId.promote.ts" }, "/api/knowledge/sessions/$sessionId/candidates": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/knowledge.sessions.$sessionId.candidates.ts" }, "/api/providers/$providerId/test/log": { "filePath": "C:/Users/claw/workspace/agent-inspector/src/routes/api/providers.$providerId.test.log.ts" } }, "clientEntry": "/assets/main-B2t-3SYj.js" });
 export {
   tsrStartManifest
 };

package/.output/server/index.mjs

@@ -35,103 +35,103 @@ const headers = ((m) => function headersRouteRule(event) {
   }
 });
 const assets = {
-  "/assets/CompareDrawer-BR_kCD7Q.js": {
+  "/assets/CompareDrawer-DPs4UHwd.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"49fe-h2V2O7V6W/qLlUGdYpKUldvpjWs"',
-    "mtime": "2026-06-27T01:00:07.209Z",
+    "etag": '"49fe-juuwKqSVn4vg8/mxHy0rBBfuaz0"',
+    "mtime": "2026-06-27T02:00:30.203Z",
     "size": 18942,
-    "path": "../public/assets/CompareDrawer-BR_kCD7Q.js"
+    "path": "../public/assets/CompareDrawer-DPs4UHwd.js"
   },
-  "/assets/index-_7blCOK0.js": {
+  "/assets/index-BkdYiTpV.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"74-QxBCxL6xnKy+9Y7QZcRvqsp/t4g"',
-    "mtime": "2026-06-27T01:00:07.209Z",
+    "etag": '"74-95mLx/6mpmji+KzspWJRgr0j2HE"',
+    "mtime": "2026-06-27T02:00:30.203Z",
     "size": 116,
-    "path": "../public/assets/index-_7blCOK0.js"
+    "path": "../public/assets/index-BkdYiTpV.js"
   },
-  "/assets/ReplayDialog-DsAYQBHZ.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"2361-2SJPnlXCUj030vkvF0obKqO2ww4"',
-    "mtime": "2026-06-27T01:00:07.209Z",
-    "size": 9057,
-    "path": "../public/assets/ReplayDialog-DsAYQBHZ.js"
+  "/assets/alibaba-TTwafVwX.svg": {
+    "type": "image/svg+xml",
+    "etag": '"171b-6dyV5K8QjiaY35sN9qNprh9zDIs"',
+    "mtime": "2026-06-27T02:00:30.202Z",
+    "size": 5915,
+    "path": "../public/assets/alibaba-TTwafVwX.svg"
+  },
+  "/assets/minimax-BPMzvuL-.jpeg": {
+    "type": "image/jpeg",
+    "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
+    "mtime": "2026-06-27T02:00:30.203Z",
+    "size": 6918,
+    "path": "../public/assets/minimax-BPMzvuL-.jpeg"
   },
   "/assets/index-D_nZj9Vt.css": {
     "type": "text/css; charset=utf-8",
     "etag": '"1a275-7T1iSNG2p6BSsqLwdpfky+9evLw"',
-    "mtime": "2026-06-27T01:00:07.209Z",
+    "mtime": "2026-06-27T02:00:30.203Z",
     "size": 107125,
     "path": "../public/assets/index-D_nZj9Vt.css"
   },
-  "/assets/alibaba-TTwafVwX.svg": {
-    "type": "image/svg+xml",
-    "etag": '"171b-6dyV5K8QjiaY35sN9qNprh9zDIs"',
-    "mtime": "2026-06-27T01:00:07.209Z",
-    "size": 5915,
-    "path": "../public/assets/alibaba-TTwafVwX.svg"
+  "/assets/ReplayDialog-8ISC28XF.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"2361-7pKZf9oNiHpnogtvILlZkhLSrZs"',
+    "mtime": "2026-06-27T02:00:30.203Z",
+    "size": 9057,
+    "path": "../public/assets/ReplayDialog-8ISC28XF.js"
   },
-  "/assets/RequestAnatomy-B4uqyUt8.js": {
+  "/assets/RequestAnatomy-BhbsgfBO.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"4485-He+g7fOqSzn4yv1CcgVk+VCluMQ"',
-    "mtime": "2026-06-27T01:00:07.209Z",
+    "etag": '"4485-4Urj/0VSY4KkQLnUk4c+RLhwDb4"',
+    "mtime": "2026-06-27T02:00:30.203Z",
     "size": 17541,
-    "path": "../public/assets/RequestAnatomy-B4uqyUt8.js"
+    "path": "../public/assets/RequestAnatomy-BhbsgfBO.js"
   },
-  "/assets/StreamingChunkSequence-BECMV-xf.js": {
+  "/assets/ResponseView-CyM7JXeA.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d5b-Gb7t7c7o7NuJl7mOyiJKP6Wyw8Q"',
-    "mtime": "2026-06-27T01:00:07.211Z",
-    "size": 3419,
-    "path": "../public/assets/StreamingChunkSequence-BECMV-xf.js"
+    "etag": '"30cd-UFEnNJc8VomMOrzXynlO8nTuVzo"',
+    "mtime": "2026-06-27T02:00:30.203Z",
+    "size": 12493,
+    "path": "../public/assets/ResponseView-CyM7JXeA.js"
   },
-  "/assets/main-D6wegveF.js": {
+  "/assets/StreamingChunkSequence-BaX0x38n.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"51726-8FmBhflOXcjuOjvtwi9jMU4uXjU"',
-    "mtime": "2026-06-27T01:00:07.209Z",
-    "size": 333606,
-    "path": "../public/assets/main-D6wegveF.js"
+    "etag": '"d5b-H/I8iDw6s0pMrSJmzT6dZsygy7E"',
+    "mtime": "2026-06-27T02:00:30.203Z",
+    "size": 3419,
+    "path": "../public/assets/StreamingChunkSequence-BaX0x38n.js"
   },
   "/assets/zhipuai-BPNAnxo-.svg": {
     "type": "image/svg+xml",
     "etag": '"2bf8-hNaLCTi89nOFCsIIfWpP/jrfo0s"',
-    "mtime": "2026-06-27T01:00:07.209Z",
+    "mtime": "2026-06-27T02:00:30.203Z",
     "size": 11256,
     "path": "../public/assets/zhipuai-BPNAnxo-.svg"
   },
-  "/assets/_sessionId-3bjQPmHl.js": {
+  "/assets/_sessionId-CShO0OrR.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"d2-OsIEVGbAQp+p9USHQURDEp0WwIc"',
-    "mtime": "2026-06-27T01:00:07.209Z",
+    "etag": '"d2-K80UxD/MymZ3TEMPLBomJfQN7CU"',
+    "mtime": "2026-06-27T02:00:30.203Z",
     "size": 210,
-    "path": "../public/assets/_sessionId-3bjQPmHl.js"
-  },
-  "/assets/ResponseView-C1vQL-fM.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": '"30cd-nQBYXVNim5cyoGVYNnBURUkaZhE"',
-    "mtime": "2026-06-27T01:00:07.211Z",
-    "size": 12493,
-    "path": "../public/assets/ResponseView-C1vQL-fM.js"
+    "path": "../public/assets/_sessionId-CShO0OrR.js"
   },
   "/assets/qwen-CONDcHqt.png": {
     "type": "image/png",
     "etag": '"572c3-cdJAPaHdOvFCGzuaQjagdgOu6XE"',
-    "mtime": "2026-06-27T01:00:07.209Z",
+    "mtime": "2026-06-27T02:00:30.203Z",
     "size": 357059,
     "path": "../public/assets/qwen-CONDcHqt.png"
   },
-  "/assets/minimax-BPMzvuL-.jpeg": {
-    "type": "image/jpeg",
-    "etag": '"1b06-IwivU89ko5UTMUM1/t7hn4sQK9A"',
-    "mtime": "2026-06-27T01:00:07.209Z",
-    "size": 6918,
-    "path": "../public/assets/minimax-BPMzvuL-.jpeg"
+  "/assets/main-B2t-3SYj.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": '"51726-Ul/gmLn0c+fZ++xIS/dA5sr6Iz8"',
+    "mtime": "2026-06-27T02:00:30.203Z",
+    "size": 333606,
+    "path": "../public/assets/main-B2t-3SYj.js"
   },
-  "/assets/ProxyViewerContainer-vc50msJj.js": {
+  "/assets/ProxyViewerContainer-B1KylMPs.js": {
     "type": "text/javascript; charset=utf-8",
-    "etag": '"a9ec5-5Nw0Ue/3Bsh3sQUrw5wRg6ihYpI"',
-    "mtime": "2026-06-27T01:00:07.211Z",
-    "size": 696005,
-    "path": "../public/assets/ProxyViewerContainer-vc50msJj.js"
+    "etag": '"aa428-Xk8wdnw0jCK7Acfwjq6ObVCPbmA"',
+    "mtime": "2026-06-27T02:00:30.203Z",
+    "size": 697384,
+    "path": "../public/assets/ProxyViewerContainer-B1KylMPs.js"
   }
 };
 function readAsset(id) {

package/README.md

@@ -7,7 +7,7 @@ The npm package and CLI remain `agent-inspector`; the platform name is Agent Ins
 ## What It Does
 
 - Runs a local transparent proxy for Anthropic and OpenAI-compatible APIs.
-- Captures model requests, responses, streaming chunks, tool definitions, token usage, and errors.
+- Captures model requests, responses, tool definitions, token usage, and errors.
 - Provides a web UI for browsing sessions and logs in real time.
 - Includes a Chrome companion extension for quick capture status and log navigation.
 - Generates reviewable knowledge candidates from agent sessions.
@@ -71,6 +71,36 @@ ANTHROPIC_BASE_URL=http://localhost:25947/proxy <tool>
 
 The web UI runs at http://localhost:25947.
 
+## Capture Modes
+
+Agent Inspector starts in `simple` capture mode by default:
+
+```bash
+agent-inspector
+agent-inspector --mode simple
+```
+
+Simple mode keeps the proxy lightweight for everyday use. It records the data
+needed for the session timeline, request/response views, token usage, provider
+routing, errors, and knowledge workflows, but it does not retain raw request
+headers, upstream headers, or detailed streaming chunk artifacts.
+
+Use `full` mode when you need protocol-level diagnostics:
+
+```bash
+agent-inspector --mode full
+```
+
+Full mode captures the additional raw details used by the `Raw Headers`,
+`Headers`, and `Raw Response` views. It is useful for provider debugging,
+header transformation checks, and SSE stream inspection, but it uses more CPU,
+memory, and disk.
+
+The mode is decided at process start. To change modes, restart the server. You
+can also set `AGENT_INSPECTOR_MODE=full` or
+`AGENT_INSPECTOR_CAPTURE_MODE=full`; the CLI flag takes precedence over the
+environment.
+
 ## Jenkins Release Webhook
 
 The `agent-inspector-release` Jenkins pipeline can be triggered from GitCode by

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonyclaw/agent-inspector",
-  "version": "2.0.14",
+  "version": "2.0.16",
   "type": "module",
   "description": "Agent observability and knowledge capture layer for AI coding tools.",
   "license": "MIT",

package/src/cli/templates/codex-skill-onboard.ts

@@ -47,6 +47,8 @@ Codex user-level configuration lives in \`~/.codex/config.toml\`. Codex supports
 
 Keep this setup local and explicit. Agent Inspector MCP tools can read captured requests and provider configuration, so only wire it into trusted local Codex environments.
 
+Agent Inspector starts in **Simple mode** by default. Keep Simple mode for everyday capture: requests, responses, tools, timing, and token usage stay available without retaining heavier raw headers, raw response, or detailed SSE chunk artifacts. Use **Full mode** only when the user is debugging provider headers, raw response payloads, or SSE stream details.
+
 ---
 
 ## Phase 0: Preflight
@@ -77,19 +79,21 @@ Do not read \`~/.codex/auth.json\`, token files, or unrelated Codex state files.
 
 ## Phase 1: Start Agent Inspector
 
-Start or reuse Agent Inspector before wiring MCP. Prefer the installed binary so Windows users get the branded runtime in Task Manager.
+Start or reuse Agent Inspector before wiring MCP. Prefer the installed binary so Windows users get the branded runtime in Task Manager. Start onboarding in Simple mode; if the user needs raw headers, raw response, or SSE chunks later, restart with \`agent-inspector --mode full\`.
 
 \`\`\`powershell
-agent-inspector --background --no-open
+agent-inspector --mode simple --background --no-open
 Invoke-RestMethod -Uri "http://localhost:${port}/api/health" -TimeoutSec 3
+Invoke-RestMethod -Uri "http://localhost:${port}/api/config" -TimeoutSec 3 | Select-Object captureMode
 \`\`\`
 
 \`\`\`bash
-agent-inspector --background --no-open
+agent-inspector --mode simple --background --no-open
 curl -fsS "http://localhost:${port}/api/health"
+curl -fsS "http://localhost:${port}/api/config" | grep -o '"captureMode":"[^"]*"'
 \`\`\`
 
-If the health check fails, show only the relevant error and ask whether to diagnose startup before editing Codex config.
+If the health check fails, show only the relevant error and ask whether to diagnose startup before editing Codex config. If the active capture mode is not \`simple\`, explain that an existing process is already running and offer to restart with \`agent-inspector --mode simple --force-restart\`.
 
 ---
 

package/src/cli/templates/skill-onboard.ts

@@ -226,11 +226,13 @@ if ($null) { Write-Host 'claude-code: present' } else { Write-Host 'claude-code:
 \`\`\`
 ## Welcome to Agent Inspector!
 
-Agent Inspector is an agent observability and knowledge-capture platform for AI coding tools. The \`agent-inspector\` CLI runs a transparent local proxy + Web UI, so you can see every model request and response: system prompts, tool definitions, message history, SSE streaming chunks, and token counts captured live in a browser tab.
+Agent Inspector is an agent observability and knowledge-capture platform for AI coding tools. The \`agent-inspector\` CLI runs a transparent local proxy + Web UI, so you can see model requests and responses, system prompts, tool definitions, message history, timing, and token counts captured live in a browser tab.
+
+Agent Inspector starts in **Simple mode** by default. Simple mode is the right habit for everyday use: it keeps requests, responses, tools, timing, and token usage while avoiding heavier raw headers, raw response, and detailed SSE chunk artifacts. Use **Full mode** only when the user is debugging provider headers, raw response payloads, or SSE stream details.
 
 **What we'll do in the next ~10 minutes:**
 1. Add your first LLM provider (Anthropic or OpenAI key)
-2. Start the proxy
+2. Start the proxy in Simple mode
 3. Wire your AI tool to use it
 4. Capture a first request end-to-end
 5. Tour the key UI affordances
@@ -346,7 +348,7 @@ $json | Set-Content -Path $file -Encoding UTF8
 
 ## Phase 3: Start proxy
 
-**EXPLAIN:** "Time to start the proxy. It binds to port ${port} by default, reuses an already-running healthy agent-inspector, and prints the URL. Use \`--force-restart\` only when you intentionally want to replace the existing process."
+**EXPLAIN:** "Time to start the proxy. It binds to port ${port} by default, starts in Simple mode for lower overhead, reuses an already-running healthy agent-inspector, and prints the URL. Use \`--force-restart\` only when you intentionally want to replace the existing process. If the user is diagnosing raw headers, raw response, or SSE chunks, restart with \`agent-inspector --mode full\`."
 
 **DO:** Skip this phase entirely if the Phase 0 health check already reported \`PROXY: up\` and the user opted to skip done phases.
 
@@ -354,7 +356,7 @@ $json | Set-Content -Path $file -Encoding UTF8
 
 \`\`\`bash
 # Unix / macOS / WSL
-agent-inspector --background --no-open > /tmp/agent-inspector.log 2>&1
+agent-inspector --mode simple --background --no-open > /tmp/agent-inspector.log 2>&1
 \`\`\`
 
 \`\`\`powershell
@@ -367,14 +369,14 @@ $err = Join-Path $env:TEMP 'agent-inspector.err.log'
 $found = Get-Command agent-inspector -ErrorAction SilentlyContinue
 if ($found) {
   $shim = $found.Source
-  $args = '--background','--no-open'
+  $args = '--mode','simple','--background','--no-open'
 } elseif (Test-Path (Join-Path $env:APPDATA 'npm/agent-inspector.cmd')) {
   $shim = Join-Path $env:APPDATA 'npm/agent-inspector.cmd'
-  $args = '--background','--no-open'
+  $args = '--mode','simple','--background','--no-open'
 } else {
   # bin not on PATH and not at the default npm prefix — let cmd resolve it
   $shim = 'cmd.exe'
-  $args = '/c','agent-inspector','--background','--no-open'
+  $args = '/c','agent-inspector','--mode','simple','--background','--no-open'
 }
 Start-Process -FilePath $shim -ArgumentList $args -RedirectStandardOutput $log -RedirectStandardError $err -WindowStyle Hidden
 \`\`\`
@@ -394,6 +396,12 @@ done
 curl -sS "http://localhost:${port}/api/health"
 \`\`\`
 
+**DO:** Read \`/api/config\` and tell the user which capture mode is active. If it is not \`simple\` during onboarding, explain that an existing process is already running and offer to restart with \`agent-inspector --mode simple --force-restart\`.
+
+\`\`\`bash
+curl -sS "http://localhost:${port}/api/config" | grep -o '"captureMode":"[^"]*"'
+\`\`\`
+
 > **PAUSE** — if the health check fails, show the user the log file (\`/tmp/agent-inspector.log\` or \`%TEMP%\\agent-inspector.log\`) and diagnose. Common issues: another process on the port, firewall, missing providers. Use \`AskUserQuestion\` with header \`Proxy up?\` and options \`["Yes, proxy is up", "No, I see an error in the log"]\`. Wait for the answer.
 
 ---

package/src/cli.ts

@@ -11,6 +11,9 @@ const __dirname = dirname(__filename);
 const DEFAULT_PORT = 25947;
 const LOCAL_PROBE_TIMEOUT_MS = 2000;
 const BRANDED_WINDOWS_RUNTIME_EXE = "agent-inspector.exe";
+const DEFAULT_CAPTURE_MODE = "simple";
+
+type CaptureMode = "simple" | "full";
 
 process.title = "Agent Inspector";
 
@@ -56,6 +59,24 @@ async function isInspectorHealthy(port: number): Promise<boolean> {
   }
 }
 
+async function getRunningCaptureMode(port: number): Promise<CaptureMode | null> {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), LOCAL_PROBE_TIMEOUT_MS);
+  try {
+    const response = await fetch(`http://127.0.0.1:${port}/api/config`, {
+      cache: "no-store",
+      signal: controller.signal,
+    });
+    if (!response.ok) return null;
+    const raw: unknown = await response.json();
+    return readCaptureMode(raw);
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+
 function isPortAcceptingConnections(port: number): Promise<boolean> {
   return new Promise((resolve) => {
     const socket = createConnection({ host: "127.0.0.1", port });
@@ -138,9 +159,31 @@ function resolveServerCommand(outputDir: string, serverPath: string): ServerComm
     : { command: process.execPath, args: [serverPath] };
 }
 
+function parseCaptureMode(value: string | undefined): CaptureMode | null {
+  switch (value) {
+    case undefined:
+      return null;
+    case "simple":
+      return "simple";
+    case "full":
+      return "full";
+    default:
+      return null;
+  }
+}
+
+function readCaptureMode(raw: unknown): CaptureMode | null {
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return null;
+  const descriptor = Object.getOwnPropertyDescriptor(raw, "captureMode");
+  const value: unknown = descriptor?.value;
+  return typeof value === "string" ? parseCaptureMode(value) : null;
+}
+
 async function runStart(args: string[]): Promise<void> {
   const envPort = process.env["PORT"];
   const portDefault = envPort !== undefined ? Number(envPort) : DEFAULT_PORT;
+  const envMode =
+    process.env["AGENT_INSPECTOR_CAPTURE_MODE"] ?? process.env["AGENT_INSPECTOR_MODE"];
 
   let port = portDefault;
   let open = true;
@@ -149,9 +192,34 @@ async function runStart(args: string[]): Promise<void> {
   let forceRestart = false;
   let configDir: string | undefined;
   let providersJson: string | undefined;
+  let captureMode = DEFAULT_CAPTURE_MODE;
+  let captureModeWasSpecified = false;
+
+  if (envMode !== undefined && envMode !== "") {
+    const parsedMode = parseCaptureMode(envMode);
+    if (parsedMode === null) {
+      console.error(`Invalid capture mode: ${envMode}. Use simple or full.`);
+      process.exitCode = 1;
+      return;
+    }
+    captureMode = parsedMode;
+    captureModeWasSpecified = true;
+  }
 
   for (let i = 0; i < args.length; i++) {
     const arg = args[i] ?? "";
+    if (arg.startsWith("--mode=") || arg.startsWith("--capture-mode=")) {
+      const value = arg.slice(arg.indexOf("=") + 1);
+      const parsedMode = parseCaptureMode(value);
+      if (parsedMode === null) {
+        console.error(`Invalid capture mode: ${value}. Use simple or full.`);
+        process.exitCode = 1;
+        return;
+      }
+      captureMode = parsedMode;
+      captureModeWasSpecified = true;
+      continue;
+    }
     switch (arg) {
       case "--port":
       case "-p":
@@ -181,6 +249,20 @@ async function runStart(args: string[]): Promise<void> {
         providersJson = args[i + 1];
         i++;
         break;
+      case "--mode":
+      case "--capture-mode": {
+        const value = args[i + 1];
+        const parsedMode = parseCaptureMode(value);
+        if (parsedMode === null) {
+          console.error(`Invalid capture mode: ${String(value)}. Use simple or full.`);
+          process.exitCode = 1;
+          return;
+        }
+        captureMode = parsedMode;
+        captureModeWasSpecified = true;
+        i++;
+        break;
+      }
       default:
         break;
     }
@@ -270,6 +352,13 @@ async function runStart(args: string[]): Promise<void> {
 
   if (!forceRestart && (await isInspectorHealthy(port))) {
     console.log(`agent-inspector is already running at ${url}`);
+    if (captureModeWasSpecified) {
+      const runningMode = await getRunningCaptureMode(port);
+      if (runningMode !== null && runningMode !== captureMode) {
+        console.log(`Existing instance capture mode is ${runningMode}; requested ${captureMode}.`);
+        console.log(`Use --force-restart to restart with ${captureMode} mode.`);
+      }
+    }
     console.log(`Use --force-restart to restart the existing instance.`);
     if (open && openWasSpecified) {
       openBrowser(url);
@@ -289,6 +378,7 @@ async function runStart(args: string[]): Promise<void> {
   }
 
   console.log(`Server running at ${url}`);
+  console.log(`   Capture mode: ${captureMode}`);
   console.log(`   Proxy: ${url}/proxy`);
   console.log(``);
   console.log(`Route AI coding tools through the proxy:`);
@@ -339,6 +429,7 @@ async function runStart(args: string[]): Promise<void> {
   if (providersJson !== undefined) {
     serverEnv["AGENT_INSPECTOR_PROVIDERS_JSON"] = providersJson;
   }
+  serverEnv["AGENT_INSPECTOR_CAPTURE_MODE"] = captureMode;
   const serverProcess = spawn(serverCommand.command, serverCommand.args, {
     stdio: background ? ["ignore", "ignore", "ignore"] : "inherit",
     detached: background,

package/src/components/OnboardingBanner.tsx

@@ -7,10 +7,12 @@ import { useOnboarding } from "../lib/useOnboarding";
  * dismissal through the server runtime config.
  */
 export function OnboardingBanner(): JSX.Element | null {
-  const { hasSeenOnboarding, isLoading, markSeen } = useOnboarding();
+  const { hasSeenOnboarding, captureMode, isLoading, markSeen } = useOnboarding();
 
   if (isLoading || hasSeenOnboarding) return null;
 
+  const isFullMode = captureMode === "full";
+
   return (
     <div
       role="note"
@@ -19,17 +21,38 @@ export function OnboardingBanner(): JSX.Element | null {
     >
       <div className="min-w-0 flex-1">
         <div className="mb-1 font-medium text-amber-600 dark:text-amber-400">
-          Agent Inspector is ready
+          {isFullMode
+            ? "Agent Inspector is ready in Full mode"
+            : "Agent Inspector is ready in Simple mode"}
         </div>
         <ul className="space-y-0.5 text-xs leading-relaxed text-muted-foreground">
+          {isFullMode ? (
+            <>
+              <li>
+                <strong>Full mode</strong>: raw headers, raw response, and SSE chunks are captured
+                for diagnostics.
+              </li>
+              <li>
+                <strong>Daily work</strong>: restart with <code>agent-inspector --mode simple</code>{" "}
+                to reduce capture overhead.
+              </li>
+            </>
+          ) : (
+            <>
+              <li>
+                <strong>Simple mode</strong>: lightweight capture for requests, responses, tools,
+                timing, and token usage.
+              </li>
+              <li>
+                <strong>Need diagnostics?</strong> Restart with{" "}
+                <code>agent-inspector --mode full</code> for raw headers, raw response, and SSE
+                chunks.
+              </li>
+            </>
+          )}
           <li>
-            <strong>Trace</strong>: requests, responses, streaming chunks, tools, and timing.
-          </li>
-          <li>
-            <strong>Replay</strong>: resend captured requests and compare provider behavior.
-          </li>
-          <li>
-            <strong>Memory</strong>: create reviewable candidates before promotion to OpenClaw.
+            <strong>Replay and Memory</strong>: available in both modes for provider checks and
+            reviewable knowledge candidates.
           </li>
         </ul>
       </div>