@respan/cli 0.5.2 → 0.6.0

package/oclif.manifest.json

@@ -428,16 +428,10 @@
         "set.js"
       ]
     },
-    "datasets:add-spans": {
+    "evaluators:create": {
       "aliases": [],
-      "args": {
-        "dataset-id": {
-          "description": "Dataset ID",
-          "name": "dataset-id",
-          "required": true
-        }
-      },
-      "description": "Add existing spans to a dataset",
+      "args": {},
+      "description": "Create a new evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -473,18 +467,39 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "span-ids": {
-          "description": "Comma-separated span IDs",
-          "name": "span-ids",
+        "name": {
+          "description": "Evaluator name",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "type": {
+          "description": "Evaluator type",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Evaluator description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "config": {
+          "description": "Evaluator config as JSON string",
+          "name": "config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:add-spans",
+      "id": "evaluators:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -494,20 +509,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "datasets",
-        "add-spans.js"
+        "evaluators",
+        "create.js"
       ]
     },
-    "datasets:create-span": {
+    "evaluators:get": {
       "aliases": [],
       "args": {
-        "dataset-id": {
-          "description": "Dataset ID",
-          "name": "dataset-id",
+        "id": {
+          "description": "Evaluator ID",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Create a span in a dataset",
+      "description": "Get a specific evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -542,19 +557,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "body": {
-          "description": "Span body as JSON string",
-          "name": "body",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:create-span",
+      "id": "evaluators:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -564,14 +571,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "datasets",
-        "create-span.js"
+        "evaluators",
+        "get.js"
       ]
     },
-    "datasets:create": {
+    "evaluators:list": {
       "aliases": [],
       "args": {},
-      "description": "Create a new dataset",
+      "description": "List evaluators",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -607,17 +614,18 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Dataset name",
-          "name": "name",
-          "required": true,
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Dataset description",
-          "name": "description",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -625,7 +633,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:create",
+      "id": "evaluators:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -635,25 +643,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "datasets",
-        "create.js"
+        "evaluators",
+        "list.js"
       ]
     },
-    "datasets:get-span": {
+    "evaluators:run": {
       "aliases": [],
       "args": {
-        "dataset-id": {
-          "description": "Dataset ID",
-          "name": "dataset-id",
-          "required": true
-        },
-        "span-id": {
-          "description": "Span ID",
-          "name": "span-id",
+        "id": {
+          "description": "Evaluator ID",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific span from a dataset",
+      "description": "Run an evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -688,11 +691,32 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "dataset-id": {
+          "description": "Dataset ID to evaluate against",
+          "name": "dataset-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "log-ids": {
+          "description": "Comma-separated log/span IDs to evaluate",
+          "name": "log-ids",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "params": {
+          "description": "Additional parameters as JSON string",
+          "name": "params",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:get-span",
+      "id": "evaluators:run",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -702,20 +726,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "datasets",
-        "get-span.js"
+        "evaluators",
+        "run.js"
       ]
     },
-    "datasets:get": {
+    "evaluators:update": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Dataset ID",
+          "description": "Evaluator ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific dataset",
+      "description": "Update an evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -750,11 +774,32 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "name": {
+          "description": "Evaluator name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Evaluator description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "config": {
+          "description": "Evaluator config as JSON string",
+          "name": "config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:get",
+      "id": "evaluators:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -764,14 +809,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "datasets",
-        "get.js"
+        "evaluators",
+        "update.js"
       ]
     },
-    "datasets:list": {
+    "datasets:add-spans": {
       "aliases": [],
-      "args": {},
-      "description": "List datasets",
+      "args": {
+        "dataset-id": {
+          "description": "Dataset ID",
+          "name": "dataset-id",
+          "required": true
+        }
+      },
+      "description": "Add existing spans to a dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -807,18 +858,10 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "default": 50,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "span-ids": {
+          "description": "Comma-separated span IDs",
+          "name": "span-ids",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -826,7 +869,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:list",
+      "id": "datasets:add-spans",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -837,10 +880,10 @@
         "dist",
         "commands",
         "datasets",
-        "list.js"
+        "add-spans.js"
       ]
     },
-    "datasets:spans": {
+    "datasets:create-span": {
       "aliases": [],
       "args": {
         "dataset-id": {
@@ -849,7 +892,7 @@
           "required": true
         }
       },
-      "description": "List spans in a dataset",
+      "description": "Create a span in a dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -884,11 +927,19 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "body": {
+          "description": "Span body as JSON string",
+          "name": "body",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:spans",
+      "id": "datasets:create-span",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -899,19 +950,13 @@
         "dist",
         "commands",
         "datasets",
-        "spans.js"
+        "create-span.js"
       ]
     },
-    "datasets:update": {
+    "datasets:create": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Dataset ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Update a dataset",
+      "args": {},
+      "description": "Create a new dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -950,6 +995,7 @@
         "name": {
           "description": "Dataset name",
           "name": "name",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -964,7 +1010,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:update",
+      "id": "datasets:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -975,13 +1021,24 @@
         "dist",
         "commands",
         "datasets",
-        "update.js"
+        "create.js"
       ]
     },
-    "evaluators:create": {
+    "datasets:get-span": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new evaluator",
+      "args": {
+        "dataset-id": {
+          "description": "Dataset ID",
+          "name": "dataset-id",
+          "required": true
+        },
+        "span-id": {
+          "description": "Span ID",
+          "name": "span-id",
+          "required": true
+        }
+      },
+      "description": "Get a specific span from a dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1016,40 +1073,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "name": {
-          "description": "Evaluator name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "type": {
-          "description": "Evaluator type",
-          "name": "type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Evaluator description",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "config": {
-          "description": "Evaluator config as JSON string",
-          "name": "config",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:create",
+      "id": "datasets:get-span",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1059,20 +1087,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "create.js"
+        "datasets",
+        "get-span.js"
       ]
     },
-    "evaluators:get": {
+    "datasets:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Evaluator ID",
+          "description": "Dataset ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific evaluator",
+      "description": "Get a specific dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1111,7 +1139,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:get",
+      "id": "datasets:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1121,14 +1149,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
+        "datasets",
         "get.js"
       ]
     },
-    "evaluators:list": {
+    "datasets:list": {
       "aliases": [],
       "args": {},
-      "description": "List evaluators",
+      "description": "List datasets",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1167,7 +1195,7 @@
         "limit": {
           "description": "Number of results per page",
           "name": "limit",
-          "default": 20,
+          "default": 50,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1183,7 +1211,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:list",
+      "id": "datasets:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1193,20 +1221,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
+        "datasets",
         "list.js"
       ]
     },
-    "evaluators:run": {
+    "datasets:spans": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Evaluator ID",
-          "name": "id",
+        "dataset-id": {
+          "description": "Dataset ID",
+          "name": "dataset-id",
           "required": true
         }
       },
-      "description": "Run an evaluator",
+      "description": "List spans in a dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1241,32 +1269,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "dataset-id": {
-          "description": "Dataset ID to evaluate against",
-          "name": "dataset-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "log-ids": {
-          "description": "Comma-separated log/span IDs to evaluate",
-          "name": "log-ids",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "params": {
-          "description": "Additional parameters as JSON string",
-          "name": "params",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:run",
+      "id": "datasets:spans",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1276,20 +1283,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "run.js"
+        "datasets",
+        "spans.js"
       ]
     },
-    "evaluators:update": {
+    "datasets:update": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Evaluator ID",
+          "description": "Dataset ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Update an evaluator",
+      "description": "Update a dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1326,30 +1333,23 @@
           "type": "boolean"
         },
         "name": {
-          "description": "Evaluator name",
+          "description": "Dataset name",
           "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "description": {
-          "description": "Evaluator description",
+          "description": "Dataset description",
           "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "config": {
-          "description": "Evaluator config as JSON string",
-          "name": "config",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:update",
+      "id": "datasets:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1359,7 +1359,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
+        "datasets",
         "update.js"
       ]
     },
@@ -1583,17 +1583,10 @@
         "list.js"
       ]
     },
-    "integrate:claude-code": {
+    "logs:create": {
       "aliases": [],
       "args": {},
-      "description": "Integrate Respan with Claude Code.\n\nInstalls a Stop hook that reads conversation transcripts and sends\nthem to Respan as structured spans (chat, tool, thinking).\n\nScope:\n  --global   Install hook script + register in ~/.claude/settings.json\n  --local    Write credentials + enable flag to .claude/settings.local.json\n  (default)  Both: install hook globally + enable for current project",
-      "examples": [
-        "respan integrate claude-code",
-        "respan integrate claude-code --global",
-        "respan integrate claude-code --local --project-id my-project",
-        "respan integrate claude-code --attrs '{\"env\":\"prod\"}'",
-        "respan integrate claude-code --dry-run"
-      ],
+      "description": "Create a log span",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1629,80 +1622,101 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "local": {
-          "description": "Write per-project config (default)",
-          "exclusive": [
-            "global"
-          ],
-          "name": "local",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "global": {
-          "description": "Write user-level global config",
-          "exclusive": [
-            "local"
-          ],
-          "name": "global",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "project-id": {
-          "description": "Respan project ID (added to metadata / resource attributes)",
-          "env": "RESPAN_PROJECT_ID",
-          "name": "project-id",
+        "input": {
+          "description": "Input text or JSON",
+          "name": "input",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "base-url": {
-          "description": "Respan API base URL (for enterprise deployments)",
-          "name": "base-url",
-          "default": "https://api.respan.ai/api",
+        "output": {
+          "description": "Output text or JSON",
+          "name": "output",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "attrs": {
-          "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
-          "name": "attrs",
-          "default": "{}",
+        "model": {
+          "description": "Model name",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "customer-id": {
-          "description": "Customer/user identifier for traces (e.g. your name or email)",
-          "env": "RESPAN_CUSTOMER_ID",
-          "name": "customer-id",
+        "metadata": {
+          "description": "Metadata as JSON string",
+          "name": "metadata",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "span-name": {
-          "description": "Root span name for traces (default: claude-code)",
-          "name": "span-name",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "logs:create",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "logs",
+        "create.js"
+      ]
+    },
+    "logs:get": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Span ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific log span",
+      "flags": {
+        "api-key": {
+          "description": "API key (env: RESPAN_API_KEY)",
+          "env": "RESPAN_API_KEY",
+          "name": "api-key",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "workflow-name": {
-          "description": "Workflow name for traces (default: claude-code)",
-          "name": "workflow-name",
+        "profile": {
+          "description": "Named profile to use",
+          "name": "profile",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "dry-run": {
-          "description": "Preview changes without writing files",
-          "name": "dry-run",
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "csv": {
+          "description": "Output as CSV",
+          "name": "csv",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show verbose output",
+          "name": "verbose",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "integrate:claude-code",
+      "id": "logs:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1712,20 +1726,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "integrate",
-        "claude-code.js"
+        "logs",
+        "get.js"
       ]
     },
-    "integrate:codex-cli": {
+    "logs:list": {
       "aliases": [],
       "args": {},
-      "description": "Integrate Respan with Codex CLI.\n\nCodex CLI has native OTel traces (prompts, tool approvals, results)\nso we append an [otel] block to its TOML config.\n\nScope:\n  --local    Write to .codex/config.toml in project root (default)\n  --global   Write to ~/.codex/config.toml\n  If [otel] already exists in the target file, warns and does not overwrite.",
-      "examples": [
-        "respan integrate codex-cli",
-        "respan integrate codex-cli --global",
-        "respan integrate codex-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
-        "respan integrate codex-cli --dry-run"
-      ],
+      "description": "List and filter LLM request logs (spans).\n\nSupports pagination, sorting, time range, and server-side filtering.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (logs):\n  model, status_code, status, cost, latency, prompt_tokens,\n  completion_tokens, customer_identifier, custom_identifier,\n  thread_identifier, trace_unique_id, span_name, span_workflow_name,\n  environment, log_type, error_message, failed, provider_id,\n  deployment_name, prompt_name, prompt_id, unique_id, stream,\n  temperature, max_tokens, tokens_per_second, time_to_first_token,\n  total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1761,80 +1769,75 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "local": {
-          "description": "Write per-project config (default)",
-          "exclusive": [
-            "global"
-          ],
-          "name": "local",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "global": {
-          "description": "Write user-level global config",
-          "exclusive": [
-            "local"
-          ],
-          "name": "global",
-          "allowNo": false,
-          "type": "boolean"
+        "limit": {
+          "description": "Number of results per page (max 1000)",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "project-id": {
-          "description": "Respan project ID (added to metadata / resource attributes)",
-          "env": "RESPAN_PROJECT_ID",
-          "name": "project-id",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "base-url": {
-          "description": "Respan API base URL (for enterprise deployments)",
-          "name": "base-url",
-          "default": "https://api.respan.ai/api",
+        "sort-by": {
+          "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)",
+          "name": "sort-by",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "attrs": {
-          "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
-          "name": "attrs",
-          "default": "{}",
+        "start-time": {
+          "description": "Start time filter (ISO 8601)",
+          "name": "start-time",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "customer-id": {
-          "description": "Customer/user identifier for traces (e.g. your name or email)",
-          "env": "RESPAN_CUSTOMER_ID",
-          "name": "customer-id",
+        "end-time": {
+          "description": "End time filter (ISO 8601)",
+          "name": "end-time",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "span-name": {
-          "description": "Root span name for traces (default: claude-code)",
-          "name": "span-name",
+        "filter": {
+          "description": "Filter in field:operator:value format (repeatable)",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "all-envs": {
+          "description": "Include all environments (true/false)",
+          "name": "all-envs",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "workflow-name": {
-          "description": "Workflow name for traces (default: claude-code)",
-          "name": "workflow-name",
+        "is-test": {
+          "description": "Filter by test (true) or production (false) environment",
+          "name": "is-test",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "dry-run": {
-          "description": "Preview changes without writing files",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
+        "include-fields": {
+          "description": "Comma-separated fields to include in response",
+          "name": "include-fields",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "integrate:codex-cli",
+      "id": "logs:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1844,20 +1847,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "integrate",
-        "codex-cli.js"
+        "logs",
+        "list.js"
       ]
     },
-    "integrate:gemini-cli": {
+    "logs:summary": {
       "aliases": [],
       "args": {},
-      "description": "Integrate Respan with Gemini CLI.\n\nGemini CLI has native OTel traces (tool_call, llm_call, agent_call)\nso we configure it to send telemetry directly to the Respan OTLP\nendpoint.\n\nScope:\n  --local    Write to .gemini/settings.json in project root (default)\n  --global   Write to ~/.gemini/settings.json",
-      "examples": [
-        "respan integrate gemini-cli",
-        "respan integrate gemini-cli --global",
-        "respan integrate gemini-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
-        "respan integrate gemini-cli --dry-run"
-      ],
+      "description": "Get aggregated summary statistics for log spans in a time range.\n\nReturns total cost, total tokens, request count, and score summaries.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (logs):\n  model, status_code, status, cost, latency, prompt_tokens,\n  completion_tokens, customer_identifier, custom_identifier,\n  thread_identifier, trace_unique_id, span_name, span_workflow_name,\n  environment, log_type, error_message, failed, provider_id,\n  deployment_name, prompt_name, prompt_id, unique_id, stream,\n  temperature, max_tokens, tokens_per_second, time_to_first_token,\n  total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1893,80 +1890,47 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "local": {
-          "description": "Write per-project config (default)",
-          "exclusive": [
-            "global"
-          ],
-          "name": "local",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "global": {
-          "description": "Write user-level global config",
-          "exclusive": [
-            "local"
-          ],
-          "name": "global",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "project-id": {
-          "description": "Respan project ID (added to metadata / resource attributes)",
-          "env": "RESPAN_PROJECT_ID",
-          "name": "project-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "base-url": {
-          "description": "Respan API base URL (for enterprise deployments)",
-          "name": "base-url",
-          "default": "https://api.respan.ai/api",
+        "start-time": {
+          "description": "Start time (ISO 8601)",
+          "name": "start-time",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "attrs": {
-          "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
-          "name": "attrs",
-          "default": "{}",
+        "end-time": {
+          "description": "End time (ISO 8601)",
+          "name": "end-time",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "customer-id": {
-          "description": "Customer/user identifier for traces (e.g. your name or email)",
-          "env": "RESPAN_CUSTOMER_ID",
-          "name": "customer-id",
+        "filter": {
+          "description": "Filter in field:operator:value format (repeatable)",
+          "name": "filter",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "span-name": {
-          "description": "Root span name for traces (default: claude-code)",
-          "name": "span-name",
+        "all-envs": {
+          "description": "Include all environments (true/false)",
+          "name": "all-envs",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "workflow-name": {
-          "description": "Workflow name for traces (default: claude-code)",
-          "name": "workflow-name",
+        "is-test": {
+          "description": "Filter by test (true) or production (false) environment",
+          "name": "is-test",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "dry-run": {
-          "description": "Preview changes without writing files",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "integrate:gemini-cli",
+      "id": "logs:summary",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1976,20 +1940,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "integrate",
-        "gemini-cli.js"
+        "logs",
+        "summary.js"
       ]
     },
-    "integrate:opencode": {
+    "prompts:create-version": {
       "aliases": [],
-      "args": {},
-      "description": "Integrate Respan with OpenCode.\n\nOpenCode's built-in OTel does not work reliably, so this uses the\ncommunity opencode-otel plugin instead.\n\nScope:\n  --local    Write plugin config to project root (default)\n  --global   Write to ~/.config/opencode/plugins/otel.json\n  The opencode-otel package is always installed globally.",
-      "examples": [
-        "respan integrate opencode",
-        "respan integrate opencode --global",
-        "respan integrate opencode --project-id my-project --attrs '{\"env\":\"prod\"}'",
-        "respan integrate opencode --dry-run"
-      ],
+      "args": {
+        "prompt-id": {
+          "description": "Prompt ID",
+          "name": "prompt-id",
+          "required": true
+        }
+      },
+      "description": "Create a new version of a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2025,80 +1989,39 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "local": {
-          "description": "Write per-project config (default)",
-          "exclusive": [
-            "global"
-          ],
-          "name": "local",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "global": {
-          "description": "Write user-level global config",
-          "exclusive": [
-            "local"
-          ],
-          "name": "global",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "project-id": {
-          "description": "Respan project ID (added to metadata / resource attributes)",
-          "env": "RESPAN_PROJECT_ID",
-          "name": "project-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "base-url": {
-          "description": "Respan API base URL (for enterprise deployments)",
-          "name": "base-url",
-          "default": "https://api.respan.ai/api",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "attrs": {
-          "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
-          "name": "attrs",
-          "default": "{}",
+        "messages": {
+          "description": "Messages as JSON array string",
+          "name": "messages",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "customer-id": {
-          "description": "Customer/user identifier for traces (e.g. your name or email)",
-          "env": "RESPAN_CUSTOMER_ID",
-          "name": "customer-id",
+        "model": {
+          "description": "Model name",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "span-name": {
-          "description": "Root span name for traces (default: claude-code)",
-          "name": "span-name",
+        "temperature": {
+          "description": "Temperature value",
+          "name": "temperature",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "workflow-name": {
-          "description": "Workflow name for traces (default: claude-code)",
-          "name": "workflow-name",
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "dry-run": {
-          "description": "Preview changes without writing files",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "integrate:opencode",
+      "id": "prompts:create-version",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2108,14 +2031,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "integrate",
-        "opencode.js"
+        "prompts",
+        "create-version.js"
       ]
     },
-    "logs:create": {
+    "prompts:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a log span",
+      "description": "Create a new prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2151,31 +2074,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "input": {
-          "description": "Input text or JSON",
-          "name": "input",
+        "name": {
+          "description": "Prompt name",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "output": {
-          "description": "Output text or JSON",
-          "name": "output",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "model": {
-          "description": "Model name",
-          "name": "model",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "metadata": {
-          "description": "Metadata as JSON string",
-          "name": "metadata",
+        "description": {
+          "description": "Prompt description",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2183,7 +2092,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:create",
+      "id": "prompts:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2193,20 +2102,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "prompts",
         "create.js"
       ]
     },
-    "logs:get": {
+    "prompts:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Span ID",
+          "description": "Prompt ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific log span",
+      "description": "Get a specific prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2245,7 +2154,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:get",
+      "id": "prompts:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2255,14 +2164,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "prompts",
         "get.js"
       ]
     },
-    "logs:list": {
+    "prompts:list": {
       "aliases": [],
       "args": {},
-      "description": "List and filter LLM request logs (spans).\n\nSupports pagination, sorting, time range, and server-side filtering.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (logs):\n  model, status_code, status, cost, latency, prompt_tokens,\n  completion_tokens, customer_identifier, custom_identifier,\n  thread_identifier, trace_unique_id, span_name, span_workflow_name,\n  environment, log_type, error_message, failed, provider_id,\n  deployment_name, prompt_name, prompt_id, unique_id, stream,\n  temperature, max_tokens, tokens_per_second, time_to_first_token,\n  total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
+      "description": "List prompts",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2299,74 +2208,17 @@
           "type": "boolean"
         },
         "limit": {
-          "description": "Number of results per page (max 1000)",
+          "description": "Number of results per page",
           "name": "limit",
           "default": 50,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sort-by": {
-          "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)",
-          "name": "sort-by",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "start-time": {
-          "description": "Start time filter (ISO 8601)",
-          "name": "start-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "end-time": {
-          "description": "End time filter (ISO 8601)",
-          "name": "end-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "filter": {
-          "description": "Filter in field:operator:value format (repeatable)",
-          "name": "filter",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "all-envs": {
-          "description": "Include all environments (true/false)",
-          "name": "all-envs",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "is-test": {
-          "description": "Filter by test (true) or production (false) environment",
-          "name": "is-test",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "include-fields": {
-          "description": "Comma-separated fields to include in response",
-          "name": "include-fields",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:list",
+      "id": "prompts:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2376,14 +2228,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "prompts",
         "list.js"
       ]
     },
-    "logs:summary": {
+    "prompts:update": {
       "aliases": [],
-      "args": {},
-      "description": "Get aggregated summary statistics for log spans in a time range.\n\nReturns total cost, total tokens, request count, and score summaries.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (logs):\n  model, status_code, status, cost, latency, prompt_tokens,\n  completion_tokens, customer_identifier, custom_identifier,\n  thread_identifier, trace_unique_id, span_name, span_workflow_name,\n  environment, log_type, error_message, failed, provider_id,\n  deployment_name, prompt_name, prompt_id, unique_id, stream,\n  temperature, max_tokens, tokens_per_second, time_to_first_token,\n  total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
+      "args": {
+        "id": {
+          "description": "Prompt ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2419,39 +2277,16 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "start-time": {
-          "description": "Start time (ISO 8601)",
-          "name": "start-time",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "end-time": {
-          "description": "End time (ISO 8601)",
-          "name": "end-time",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "filter": {
-          "description": "Filter in field:operator:value format (repeatable)",
-          "name": "filter",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "all-envs": {
-          "description": "Include all environments (true/false)",
-          "name": "all-envs",
+        "name": {
+          "description": "Prompt name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "is-test": {
-          "description": "Filter by test (true) or production (false) environment",
-          "name": "is-test",
+        "description": {
+          "description": "Prompt description",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2459,7 +2294,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:summary",
+      "id": "prompts:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2469,11 +2304,11 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
-        "summary.js"
+        "prompts",
+        "update.js"
       ]
     },
-    "prompts:create-version": {
+    "prompts:versions": {
       "aliases": [],
       "args": {
         "prompt-id": {
@@ -2482,7 +2317,7 @@
           "required": true
         }
       },
-      "description": "Create a new version of a prompt",
+      "description": "List versions of a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2517,40 +2352,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "messages": {
-          "description": "Messages as JSON array string",
-          "name": "messages",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "model": {
-          "description": "Model name",
-          "name": "model",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "temperature": {
-          "description": "Temperature value",
-          "name": "temperature",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:create-version",
+      "id": "prompts:versions",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2561,13 +2367,19 @@
         "dist",
         "commands",
         "prompts",
-        "create-version.js"
+        "versions.js"
       ]
     },
-    "prompts:create": {
+    "traces:get": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new prompt",
+      "args": {
+        "id": {
+          "description": "Trace ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific trace",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2602,26 +2414,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "name": {
-          "description": "Prompt name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Prompt description",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:create",
+      "id": "traces:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2631,20 +2428,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "create.js"
+        "traces",
+        "get.js"
       ]
     },
-    "prompts:get": {
+    "traces:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Prompt ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get a specific prompt",
+      "args": {},
+      "description": "List and filter traces.\n\nA trace represents a complete workflow execution containing multiple spans.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (traces):\n  trace_unique_id, customer_identifier, environment, span_count,\n  llm_call_count, error_count, total_cost, total_tokens,\n  total_prompt_tokens, total_completion_tokens, duration,\n  span_workflow_name, metadata__<key>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2679,75 +2470,63 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "prompts:get",
-      "pluginAlias": "@respan/cli",
-      "pluginName": "@respan/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "prompts",
-        "get.js"
-      ]
-    },
-    "prompts:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List prompts",
-      "flags": {
-        "api-key": {
-          "description": "API key (env: RESPAN_API_KEY)",
-          "env": "RESPAN_API_KEY",
-          "name": "api-key",
+        },
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 10,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "profile": {
-          "description": "Named profile to use",
-          "name": "profile",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "json": {
-          "description": "Output as JSON",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
+        "sort-by": {
+          "description": "Sort field (prefix with - for descending)",
+          "name": "sort-by",
+          "default": "-timestamp",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "csv": {
-          "description": "Output as CSV",
-          "name": "csv",
-          "allowNo": false,
-          "type": "boolean"
+        "start-time": {
+          "description": "Start time filter (ISO 8601)",
+          "name": "start-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "verbose": {
-          "char": "v",
-          "description": "Show verbose output",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
+        "end-time": {
+          "description": "End time filter (ISO 8601)",
+          "name": "end-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "default": 50,
+        "environment": {
+          "description": "Environment filter",
+          "name": "environment",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "filter": {
+          "description": "Filter in field:operator:value format (repeatable)",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:list",
+      "id": "traces:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2757,20 +2536,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
+        "traces",
         "list.js"
       ]
     },
-    "prompts:update": {
+    "traces:summary": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Prompt ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Update a prompt",
+      "args": {},
+      "description": "Get a summary of traces for a time range",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2806,16 +2579,18 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Prompt name",
-          "name": "name",
+        "start-time": {
+          "description": "Start time (ISO 8601)",
+          "name": "start-time",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Prompt description",
-          "name": "description",
+        "end-time": {
+          "description": "End time (ISO 8601)",
+          "name": "end-time",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2823,7 +2598,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:update",
+      "id": "traces:summary",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2833,20 +2608,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "update.js"
+        "traces",
+        "summary.js"
       ]
     },
-    "prompts:versions": {
+    "users:create": {
       "aliases": [],
-      "args": {
-        "prompt-id": {
-          "description": "Prompt ID",
-          "name": "prompt-id",
-          "required": true
-        }
-      },
-      "description": "List versions of a prompt",
+      "args": {},
+      "description": "Create a new user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2881,11 +2650,40 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "identifier": {
+          "description": "Customer identifier",
+          "name": "identifier",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Customer name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "email": {
+          "description": "Customer email",
+          "name": "email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata": {
+          "description": "Metadata as JSON string",
+          "name": "metadata",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:versions",
+      "id": "users:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2895,20 +2693,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "versions.js"
+        "users",
+        "create.js"
       ]
     },
-    "traces:get": {
+    "users:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Trace ID",
+          "description": "Customer identifier",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific trace",
+      "description": "Get a specific user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2947,7 +2745,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:get",
+      "id": "users:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2957,14 +2755,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
+        "users",
         "get.js"
       ]
     },
-    "traces:list": {
+    "users:list": {
       "aliases": [],
       "args": {},
-      "description": "List and filter traces.\n\nA trace represents a complete workflow execution containing multiple spans.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (traces):\n  trace_unique_id, customer_identifier, environment, span_count,\n  llm_call_count, error_count, total_cost, total_tokens,\n  total_prompt_tokens, total_completion_tokens, duration,\n  span_workflow_name, metadata__<key>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
+      "description": "List users (customers)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3003,7 +2801,7 @@
         "limit": {
           "description": "Number of results per page",
           "name": "limit",
-          "default": 10,
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3017,23 +2815,8 @@
           "type": "option"
         },
         "sort-by": {
-          "description": "Sort field (prefix with - for descending)",
+          "description": "Sort field",
           "name": "sort-by",
-          "default": "-timestamp",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "start-time": {
-          "description": "Start time filter (ISO 8601)",
-          "name": "start-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "end-time": {
-          "description": "End time filter (ISO 8601)",
-          "name": "end-time",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3044,18 +2827,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "filter": {
-          "description": "Filter in field:operator:value format (repeatable)",
-          "name": "filter",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:list",
+      "id": "users:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3065,14 +2841,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
+        "users",
         "list.js"
       ]
     },
-    "traces:summary": {
+    "users:update": {
       "aliases": [],
-      "args": {},
-      "description": "Get a summary of traces for a time range",
+      "args": {
+        "id": {
+          "description": "Customer identifier",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3108,18 +2890,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "start-time": {
-          "description": "Start time (ISO 8601)",
-          "name": "start-time",
-          "required": true,
+        "name": {
+          "description": "Customer name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "end-time": {
-          "description": "End time (ISO 8601)",
-          "name": "end-time",
-          "required": true,
+        "email": {
+          "description": "Customer email",
+          "name": "email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata": {
+          "description": "Metadata as JSON string",
+          "name": "metadata",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3127,7 +2914,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:summary",
+      "id": "users:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3137,14 +2924,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
-        "summary.js"
+        "users",
+        "update.js"
       ]
     },
-    "users:create": {
+    "integrate:claude-code": {
       "aliases": [],
       "args": {},
-      "description": "Create a new user (customer)",
+      "description": "Integrate Respan with Claude Code.\n\nInstalls a Stop hook that reads conversation transcripts and sends\nthem to Respan as structured spans (chat, tool, thinking).\n\nScope:\n  --global   Install hook script + register in ~/.claude/settings.json\n  --local    Write credentials + enable flag to .claude/settings.local.json\n  (default)  Both: install hook globally + enable for current project",
+      "examples": [
+        "respan integrate claude-code",
+        "respan integrate claude-code --global",
+        "respan integrate claude-code --local --project-id my-project",
+        "respan integrate claude-code --attrs '{\"env\":\"prod\"}'",
+        "respan integrate claude-code --dry-run"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3180,39 +2974,80 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "identifier": {
-          "description": "Customer identifier",
-          "name": "identifier",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Customer name",
-          "name": "name",
+        "local": {
+          "description": "Write per-project config (default)",
+          "exclusive": [
+            "global"
+          ],
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "global": {
+          "description": "Write user-level global config",
+          "exclusive": [
+            "local"
+          ],
+          "name": "global",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project-id": {
+          "description": "Respan project ID (added to metadata / resource attributes)",
+          "env": "RESPAN_PROJECT_ID",
+          "name": "project-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "email": {
-          "description": "Customer email",
-          "name": "email",
+        "base-url": {
+          "description": "Respan API base URL (for enterprise deployments)",
+          "name": "base-url",
+          "default": "https://api.respan.ai/api",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "metadata": {
-          "description": "Metadata as JSON string",
-          "name": "metadata",
+        "attrs": {
+          "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
+          "name": "attrs",
+          "default": "{}",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "customer-id": {
+          "description": "Customer/user identifier for traces (e.g. your name or email)",
+          "env": "RESPAN_CUSTOMER_ID",
+          "name": "customer-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "span-name": {
+          "description": "Root span name for traces (default: claude-code)",
+          "name": "span-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workflow-name": {
+          "description": "Workflow name for traces (default: claude-code)",
+          "name": "workflow-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Preview changes without writing files",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:create",
+      "id": "integrate:claude-code",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3222,20 +3057,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "create.js"
+        "integrate",
+        "claude-code.js"
       ]
     },
-    "users:get": {
+    "integrate:codex-cli": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Customer identifier",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get a specific user (customer)",
+      "args": {},
+      "description": "Integrate Respan with Codex CLI.\n\nInstalls a notify hook that reads session JSONL files and sends\nthem to Respan as structured spans (chat, tool, reasoning).\n\nScope:\n  --global   Install hook script + register notify in ~/.codex/config.toml\n  --local    Write .codex/respan.json with customer_id, span_name, etc.\n  (default)  Both: install hook globally + config for current project",
+      "examples": [
+        "respan integrate codex-cli",
+        "respan integrate codex-cli --global",
+        "respan integrate codex-cli --local --customer-id frank",
+        "respan integrate codex-cli --attrs '{\"env\":\"prod\"}'",
+        "respan integrate codex-cli --dry-run"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3270,11 +3106,81 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "local": {
+          "description": "Write per-project config (default)",
+          "exclusive": [
+            "global"
+          ],
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "global": {
+          "description": "Write user-level global config",
+          "exclusive": [
+            "local"
+          ],
+          "name": "global",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project-id": {
+          "description": "Respan project ID (added to metadata / resource attributes)",
+          "env": "RESPAN_PROJECT_ID",
+          "name": "project-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "Respan API base URL (for enterprise deployments)",
+          "name": "base-url",
+          "default": "https://api.respan.ai/api",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "attrs": {
+          "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
+          "name": "attrs",
+          "default": "{}",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "customer-id": {
+          "description": "Customer/user identifier for traces (e.g. your name or email)",
+          "env": "RESPAN_CUSTOMER_ID",
+          "name": "customer-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "span-name": {
+          "description": "Root span name for traces (default: claude-code)",
+          "name": "span-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workflow-name": {
+          "description": "Workflow name for traces (default: claude-code)",
+          "name": "workflow-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Preview changes without writing files",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:get",
+      "id": "integrate:codex-cli",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3284,14 +3190,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "get.js"
+        "integrate",
+        "codex-cli.js"
       ]
     },
-    "users:list": {
+    "integrate:gemini-cli": {
       "aliases": [],
       "args": {},
-      "description": "List users (customers)",
+      "description": "Integrate Respan with Gemini CLI.\n\nInstalls an AfterModel hook that captures LLM request/response data\nand sends it to Respan as structured spans with model, token counts,\nand input/output.\n\nScope:\n  --global   Write to ~/.gemini/settings.json (default)\n  --local    Write to .gemini/settings.json in project root\n\nNote: Gemini CLI ignores workspace-level telemetry settings, so\n--global is the default.",
+      "examples": [
+        "respan integrate gemini-cli",
+        "respan integrate gemini-cli --local",
+        "respan integrate gemini-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
+        "respan integrate gemini-cli --dry-run"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3327,40 +3239,80 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "default": 20,
+        "local": {
+          "description": "Write per-project config (default)",
+          "exclusive": [
+            "global"
+          ],
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "global": {
+          "description": "Write user-level global config",
+          "exclusive": [
+            "local"
+          ],
+          "name": "global",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project-id": {
+          "description": "Respan project ID (added to metadata / resource attributes)",
+          "env": "RESPAN_PROJECT_ID",
+          "name": "project-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "base-url": {
+          "description": "Respan API base URL (for enterprise deployments)",
+          "name": "base-url",
+          "default": "https://api.respan.ai/api",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "sort-by": {
-          "description": "Sort field",
-          "name": "sort-by",
+        "attrs": {
+          "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
+          "name": "attrs",
+          "default": "{}",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "environment": {
-          "description": "Environment filter",
-          "name": "environment",
+        "customer-id": {
+          "description": "Customer/user identifier for traces (e.g. your name or email)",
+          "env": "RESPAN_CUSTOMER_ID",
+          "name": "customer-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "span-name": {
+          "description": "Root span name for traces (default: claude-code)",
+          "name": "span-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workflow-name": {
+          "description": "Workflow name for traces (default: claude-code)",
+          "name": "workflow-name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "dry-run": {
+          "description": "Preview changes without writing files",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:list",
+      "id": "integrate:gemini-cli",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3370,20 +3322,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "list.js"
+        "integrate",
+        "gemini-cli.js"
       ]
     },
-    "users:update": {
+    "integrate:opencode": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Customer identifier",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Update a user (customer)",
+      "args": {},
+      "description": "Integrate Respan with OpenCode.\n\nOpenCode's built-in OTel does not work reliably, so this uses the\ncommunity opencode-otel plugin instead.\n\nScope:\n  --local    Write plugin config to project root (default)\n  --global   Write to ~/.config/opencode/plugins/otel.json\n  The opencode-otel package is always installed globally.",
+      "examples": [
+        "respan integrate opencode",
+        "respan integrate opencode --global",
+        "respan integrate opencode --project-id my-project --attrs '{\"env\":\"prod\"}'",
+        "respan integrate opencode --dry-run"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3419,31 +3371,80 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Customer name",
-          "name": "name",
+        "local": {
+          "description": "Write per-project config (default)",
+          "exclusive": [
+            "global"
+          ],
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "global": {
+          "description": "Write user-level global config",
+          "exclusive": [
+            "local"
+          ],
+          "name": "global",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project-id": {
+          "description": "Respan project ID (added to metadata / resource attributes)",
+          "env": "RESPAN_PROJECT_ID",
+          "name": "project-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "email": {
-          "description": "Customer email",
-          "name": "email",
+        "base-url": {
+          "description": "Respan API base URL (for enterprise deployments)",
+          "name": "base-url",
+          "default": "https://api.respan.ai/api",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "metadata": {
-          "description": "Metadata as JSON string",
-          "name": "metadata",
+        "attrs": {
+          "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
+          "name": "attrs",
+          "default": "{}",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "customer-id": {
+          "description": "Customer/user identifier for traces (e.g. your name or email)",
+          "env": "RESPAN_CUSTOMER_ID",
+          "name": "customer-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "span-name": {
+          "description": "Root span name for traces (default: claude-code)",
+          "name": "span-name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "workflow-name": {
+          "description": "Workflow name for traces (default: claude-code)",
+          "name": "workflow-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Preview changes without writing files",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:update",
+      "id": "integrate:opencode",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3453,10 +3454,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "update.js"
+        "integrate",
+        "opencode.js"
       ]
     }
   },
-  "version": "0.5.2"
+  "version": "0.6.0"
 }