@respan/cli 0.13.2 → 0.14.0

package/oclif.manifest.json

@@ -264,16 +264,16 @@
         "status.js"
       ]
     },
-    "config:get": {
+    "collector:config": {
       "aliases": [],
-      "args": {
-        "key": {
-          "description": "Config key",
-          "name": "key",
-          "required": true
-        }
-      },
-      "description": "Get a configuration value",
+      "args": {},
+      "description": "Write the Respan collector configuration.\n\nThe Respan collector is the upstream OpenTelemetry Collector (contrib\n0.160.0) with a config that receives OTLP/HTTP from the Respan SDKs\non localhost and forwards it to Respan through a bounded, persistent\n(write-ahead-log) queue — spans survive Respan outages and collector\nrestarts without unbounded local growth.\n\nThe written file never contains your API key: it reads RESPAN_API_KEY from\nthe environment. Use \"respan collector start\" to run it, or run\notelcol-contrib yourself with --config <file>.",
+      "examples": [
+        "respan collector config",
+        "respan collector config --print",
+        "respan collector config --output ./collector.yaml --max-size-mib 1024",
+        "respan collector config --export-url https://respan.internal/api/v2/traces"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -315,11 +315,63 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "export-url": {
+          "description": "Respan ingest URL (default: <base URL>/api/v2/traces from your auth config)",
+          "env": "RESPAN_COLLECTOR_EXPORT_URL",
+          "name": "export-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "data-dir": {
+          "description": "Persistent queue directory, binary mode only (default: ~/.respan/collector/data)",
+          "name": "data-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "max-size-mib": {
+          "description": "Disk cap for the persistent queue in MiB (minimum 100)",
+          "name": "max-size-mib",
+          "default": 512,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "queue-size": {
+          "description": "Batches kept while Respan is unreachable",
+          "name": "queue-size",
+          "default": 10000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "port": {
+          "description": "Local OTLP/HTTP port the SDKs send to",
+          "name": "port",
+          "default": 4318,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output": {
+          "description": "Where to write the config (default: ~/.respan/collector/config.yaml)",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "print": {
+          "description": "Print the config to stdout instead of writing it",
+          "name": "print",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:get",
+      "id": "collector:config",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -329,14 +381,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "get.js"
+        "collector",
+        "config.js"
       ]
     },
-    "config:list": {
+    "collector:start": {
       "aliases": [],
       "args": {},
-      "description": "List all configuration",
+      "description": "Start a local Respan collector.\n\nRuns the OpenTelemetry Collector (contrib) with the Respan config: the SDKs\nsend to http://127.0.0.1:4318, and the collector forwards to Respan through\na bounded, persistent queue so traces survive outages and restarts.\n\nModes:\n  --docker   docker run otel/opentelemetry-collector-contrib with the queue in\n             the respan-collector-queue volume (default when Docker is available)\n  --binary   download otelcol-contrib to ~/.respan/collector/bin and run it\n             detached, logging to ~/.respan/collector/collector.log\n\nThe API key is passed to the collector through its environment only; the\nconfig file never contains it.",
+      "examples": [
+        "respan collector start",
+        "respan collector start --binary",
+        "respan collector start --docker --max-size-mib 1024 --queue-size 20000",
+        "respan collector start --export-url https://respan.internal/api/v2/traces",
+        "respan collector start --dry-run"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -378,85 +437,74 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "config:list",
-      "pluginAlias": "@respan/cli",
-      "pluginName": "@respan/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "config",
-        "list.js"
-      ]
-    },
-    "config:set": {
-      "aliases": [],
-      "args": {
-        "key": {
-          "description": "Config key",
-          "name": "key",
-          "required": true
         },
-        "value": {
-          "description": "Config value",
-          "name": "value",
-          "required": true
-        }
-      },
-      "description": "Set a configuration value",
-      "flags": {
-        "api-key": {
-          "description": "API key (env: RESPAN_API_KEY)",
-          "env": "RESPAN_API_KEY",
-          "name": "api-key",
+        "docker": {
+          "description": "Use the Docker container (default when Docker is available)",
+          "exclusive": [
+            "binary"
+          ],
+          "name": "docker",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "binary": {
+          "description": "Use the otelcol-contrib binary in ~/.respan/collector/bin",
+          "exclusive": [
+            "docker"
+          ],
+          "name": "binary",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "export-url": {
+          "description": "Respan ingest URL (default: <base URL>/api/v2/traces from your auth config)",
+          "env": "RESPAN_COLLECTOR_EXPORT_URL",
+          "name": "export-url",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "base-url": {
-          "description": "Temporary API base URL override for this command",
-          "name": "base-url",
+        "data-dir": {
+          "description": "Persistent queue directory, binary mode only (default: ~/.respan/collector/data)",
+          "name": "data-dir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "profile": {
-          "description": "Named profile to use",
-          "name": "profile",
+        "max-size-mib": {
+          "description": "Disk cap for the persistent queue in MiB (minimum 100)",
+          "name": "max-size-mib",
+          "default": 512,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "json": {
-          "description": "Output as JSON",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
+        "queue-size": {
+          "description": "Batches kept while Respan is unreachable",
+          "name": "queue-size",
+          "default": 10000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "csv": {
-          "description": "Output as CSV",
-          "name": "csv",
-          "allowNo": false,
-          "type": "boolean"
+        "port": {
+          "description": "Local OTLP/HTTP port the SDKs send to",
+          "name": "port",
+          "default": 4318,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "verbose": {
-          "char": "v",
-          "description": "Show verbose output",
-          "name": "verbose",
+        "dry-run": {
+          "description": "Show what would be done without starting anything",
+          "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:set",
+      "id": "collector:start",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -466,17 +514,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "set.js"
+        "collector",
+        "start.js"
       ]
     },
-    "demo:clear": {
+    "collector:status": {
       "aliases": [],
       "args": {},
-      "description": "Delete the sample prompts, datasets, and evaluators created by `respan demo`. Demo traces are left in place (each run is timestamped history). Idempotent — safe to re-run.",
+      "description": "Show the local Respan collector's health and queue.\n\nReports how the collector is running (Docker container or binary), the\nhealth_check result, and the exporter metrics that matter for delivery:\nqueued batches, spans sent, spans dropped because the queue was full\n(enqueue-failed) and spans rejected by Respan (send-failed).",
       "examples": [
-        "<%= config.bin %> demo clear",
-        "<%= config.bin %> demo clear --yes"
+        "respan collector status",
+        "respan collector status --json"
       ],
       "flags": {
         "api-key": {
@@ -520,17 +568,36 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "yes": {
-          "char": "y",
-          "description": "Skip the confirmation prompt",
-          "name": "yes",
+        "docker": {
+          "description": "Use the Docker container (default when Docker is available)",
+          "exclusive": [
+            "binary"
+          ],
+          "name": "docker",
           "allowNo": false,
           "type": "boolean"
+        },
+        "binary": {
+          "description": "Use the otelcol-contrib binary in ~/.respan/collector/bin",
+          "exclusive": [
+            "docker"
+          ],
+          "name": "binary",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "port": {
+          "description": "Local OTLP/HTTP port used in the SDK hint",
+          "name": "port",
+          "default": 4318,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "demo:clear",
+      "id": "collector:status",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -540,16 +607,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "demo",
-        "clear.js"
+        "collector",
+        "status.js"
       ]
     },
-    "demo": {
+    "collector:stop": {
       "aliases": [],
       "args": {},
-      "description": "Seed your account with sample data (prompts and traces) so you have something to explore. Idempotent — safe to re-run.",
+      "description": "Stop the local Respan collector.\n\nRemoves the respan-collector container or stops the detached binary. Spans\nstill queued on disk are kept and delivered the next time the collector\nstarts; pass --purge --yes to delete them.",
       "examples": [
-        "<%= config.bin %> demo"
+        "respan collector stop",
+        "respan collector stop --purge --yes"
       ],
       "flags": {
         "api-key": {
@@ -592,11 +660,41 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "docker": {
+          "description": "Use the Docker container (default when Docker is available)",
+          "exclusive": [
+            "binary"
+          ],
+          "name": "docker",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "binary": {
+          "description": "Use the otelcol-contrib binary in ~/.respan/collector/bin",
+          "exclusive": [
+            "docker"
+          ],
+          "name": "binary",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "purge": {
+          "description": "Also delete the queued data (the respan-collector-queue volume / data dir). Requires --yes",
+          "name": "purge",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "description": "Confirm deleting queued spans with --purge",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "demo",
+      "id": "collector:stop",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -606,20 +704,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "demo",
-        "index.js"
+        "collector",
+        "stop.js"
       ]
     },
-    "datasets:create-span": {
+    "config:get": {
       "aliases": [],
       "args": {
-        "dataset-id": {
-          "description": "Dataset ID",
-          "name": "dataset-id",
+        "key": {
+          "description": "Config key",
+          "name": "key",
           "required": true
         }
       },
-      "description": "Create a span in a dataset",
+      "description": "Get a configuration value",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -661,19 +759,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": "config:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -683,14 +773,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "datasets",
-        "create-span.js"
+        "config",
+        "get.js"
       ]
     },
-    "datasets:create": {
+    "config:list": {
       "aliases": [],
       "args": {},
-      "description": "Create a new dataset",
+      "description": "List all configuration",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -732,26 +822,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "name": {
-          "description": "Dataset name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Dataset description",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:create",
+      "id": "config:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -761,25 +836,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "datasets",
-        "create.js"
+        "config",
+        "list.js"
       ]
     },
-    "datasets:get-span": {
+    "config:set": {
       "aliases": [],
       "args": {
-        "dataset-id": {
-          "description": "Dataset ID",
-          "name": "dataset-id",
+        "key": {
+          "description": "Config key",
+          "name": "key",
           "required": true
         },
-        "span-id": {
-          "description": "Span ID",
-          "name": "span-id",
+        "value": {
+          "description": "Config value",
+          "name": "value",
           "required": true
         }
       },
-      "description": "Get a specific span from a dataset",
+      "description": "Set a configuration value",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -825,7 +900,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:get-span",
+      "id": "config:set",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -835,20 +910,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "datasets",
-        "get-span.js"
+        "config",
+        "set.js"
       ]
     },
-    "datasets:get": {
+    "datasets:create-span": {
       "aliases": [],
       "args": {
-        "id": {
+        "dataset-id": {
           "description": "Dataset ID",
-          "name": "id",
+          "name": "dataset-id",
           "required": true
         }
       },
-      "description": "Get a specific dataset",
+      "description": "Create a span in a dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -890,11 +965,19 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "datasets:get",
+        },
+        "body": {
+          "description": "Span body as JSON string",
+          "name": "body",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "datasets:create-span",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -905,13 +988,13 @@
         "dist",
         "commands",
         "datasets",
-        "get.js"
+        "create-span.js"
       ]
     },
-    "datasets:list": {
+    "datasets:create": {
       "aliases": [],
       "args": {},
-      "description": "List datasets",
+      "description": "Create a new dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -954,18 +1037,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "default": 50,
+        "name": {
+          "description": "Dataset name",
+          "name": "name",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "description": {
+          "description": "Dataset description",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -973,7 +1055,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:list",
+      "id": "datasets:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -984,19 +1066,24 @@
         "dist",
         "commands",
         "datasets",
-        "list.js"
+        "create.js"
       ]
     },
-    "datasets:spans": {
+    "datasets:get-span": {
       "aliases": [],
       "args": {
         "dataset-id": {
           "description": "Dataset ID",
           "name": "dataset-id",
           "required": true
+        },
+        "span-id": {
+          "description": "Span ID",
+          "name": "span-id",
+          "required": true
         }
       },
-      "description": "List spans in a dataset",
+      "description": "Get a specific span from a dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1042,7 +1129,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:spans",
+      "id": "datasets:get-span",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1053,10 +1140,10 @@
         "dist",
         "commands",
         "datasets",
-        "spans.js"
+        "get-span.js"
       ]
     },
-    "datasets:update": {
+    "datasets:get": {
       "aliases": [],
       "args": {
         "id": {
@@ -1065,7 +1152,7 @@
           "required": true
         }
       },
-      "description": "Update a dataset",
+      "description": "Get a specific dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1107,25 +1194,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "name": {
-          "description": "Dataset name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Dataset description",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:update",
+      "id": "datasets:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1136,19 +1209,13 @@
         "dist",
         "commands",
         "datasets",
-        "update.js"
+        "get.js"
       ]
     },
-    "eval": {
+    "datasets:list": {
       "aliases": [],
-      "args": {
-        "file": {
-          "description": "Path to eval JSON file",
-          "name": "file",
-          "required": true
-        }
-      },
-      "description": "Run an eval defined in a JSON file (creates prompt + dataset on the platform)",
+      "args": {},
+      "description": "List datasets",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1190,11 +1257,27 @@
           "name": "verbose",
           "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,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "eval",
+      "id": "datasets:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1204,14 +1287,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "eval",
-        "index.js"
+        "datasets",
+        "list.js"
       ]
     },
-    "evaluators:create": {
+    "datasets:spans": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new evaluator",
+      "args": {
+        "dataset-id": {
+          "description": "Dataset ID",
+          "name": "dataset-id",
+          "required": true
+        }
+      },
+      "description": "List spans in a dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1253,40 +1342,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:spans",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1296,20 +1356,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "create.js"
+        "datasets",
+        "spans.js"
       ]
     },
-    "evaluators:get": {
+    "datasets:update": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Evaluator ID",
+          "description": "Dataset ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific evaluator",
+      "description": "Update a dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1351,11 +1411,25 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "name": {
+          "description": "Dataset name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Dataset description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:get",
+      "id": "datasets:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1365,14 +1439,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "get.js"
+        "datasets",
+        "update.js"
       ]
     },
-    "evaluators:list": {
+    "demo:clear": {
       "aliases": [],
       "args": {},
-      "description": "List evaluators",
+      "description": "Delete the sample prompts, datasets, and evaluators created by `respan demo`. Demo traces are left in place (each run is timestamped history). Idempotent — safe to re-run.",
+      "examples": [
+        "<%= config.bin %> demo clear",
+        "<%= config.bin %> demo clear --yes"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1415,26 +1493,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "default": 20,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "yes": {
+          "char": "y",
+          "description": "Skip the confirmation prompt",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:list",
+      "id": "demo:clear",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1444,20 +1513,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "list.js"
+        "demo",
+        "clear.js"
       ]
     },
-    "evaluators:run": {
+    "demo": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Evaluator ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Run an evaluator",
+      "args": {},
+      "description": "Seed your account with sample data (prompts and traces) so you have something to explore. Idempotent — safe to re-run.",
+      "examples": [
+        "<%= config.bin %> demo"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1499,32 +1565,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": "demo",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1534,20 +1579,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "run.js"
+        "demo",
+        "index.js"
       ]
     },
-    "evaluators:update": {
+    "eval": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Evaluator ID",
-          "name": "id",
+        "file": {
+          "description": "Path to eval JSON file",
+          "name": "file",
           "required": true
         }
       },
-      "description": "Update an evaluator",
+      "description": "Run an eval defined in a JSON file (creates prompt + dataset on the platform)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1589,32 +1634,11 @@
           "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": "evaluators:update",
+      "id": "eval",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1624,14 +1648,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "update.js"
+        "eval",
+        "index.js"
       ]
     },
-    "experiments:create": {
+    "evaluators:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a new experiment",
+      "description": "Create a new evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1675,31 +1699,30 @@
           "type": "boolean"
         },
         "name": {
-          "description": "Experiment name",
+          "description": "Evaluator name",
           "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "dataset-id": {
-          "description": "Dataset ID",
-          "name": "dataset-id",
-          "required": true,
+        "type": {
+          "description": "Evaluator type",
+          "name": "type",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "description": {
-          "description": "Experiment description",
+          "description": "Evaluator description",
           "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "workflows": {
-          "description": "Workflows configuration as JSON string",
-          "name": "workflows",
+        "config": {
+          "description": "Evaluator config as JSON string",
+          "name": "config",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1707,7 +1730,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "experiments:create",
+      "id": "evaluators:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1717,20 +1740,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "experiments",
+        "evaluators",
         "create.js"
       ]
     },
-    "experiments:get": {
+    "evaluators:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Experiment ID",
+          "description": "Evaluator ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific experiment",
+      "description": "Get a specific evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1776,7 +1799,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "experiments:get",
+      "id": "evaluators:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1786,14 +1809,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "experiments",
+        "evaluators",
         "get.js"
       ]
     },
-    "experiments:list": {
+    "evaluators:list": {
       "aliases": [],
       "args": {},
-      "description": "List experiments",
+      "description": "List evaluators",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1855,7 +1878,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "experiments:list",
+      "id": "evaluators:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1865,22 +1888,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "experiments",
+        "evaluators",
         "list.js"
       ]
     },
-    "integrate:claude-code": {
+    "evaluators:run": {
       "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\nDefault behavior installs the global hook and writes local project config.",
-      "examples": [
-        "respan integrate claude-code",
-        "respan integrate claude-code --disable",
-        "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"
-      ],
+      "args": {
+        "id": {
+          "description": "Evaluator ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Run an evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1891,9 +1912,8 @@
           "type": "option"
         },
         "base-url": {
-          "description": "Respan API base URL (for enterprise deployments)",
+          "description": "Temporary API base URL override for this command",
           "name": "base-url",
-          "default": "https://api.respan.ai/api",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1924,90 +1944,31 @@
           "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"
-        },
-        "enable": {
-          "description": "Enable tracing (default)",
-          "exclusive": [
-            "disable"
-          ],
-          "name": "enable",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "disable": {
-          "description": "Disable tracing",
-          "exclusive": [
-            "enable"
-          ],
-          "name": "disable",
-          "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"
-        },
-        "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",
+        "dataset-id": {
+          "description": "Dataset ID to evaluate against",
+          "name": "dataset-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "span-name": {
-          "description": "Root span name for traces (default: claude-code)",
-          "name": "span-name",
+        "log-ids": {
+          "description": "Comma-separated log/span IDs to evaluate",
+          "name": "log-ids",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "workflow-name": {
-          "description": "Workflow name for traces (default: claude-code)",
-          "name": "workflow-name",
+        "params": {
+          "description": "Additional parameters as JSON string",
+          "name": "params",
           "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:claude-code",
+      "id": "evaluators:run",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2017,22 +1978,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "integrate",
-        "claude-code.js"
+        "evaluators",
+        "run.js"
       ]
     },
-    "integrate:codex-cli": {
+    "evaluators:update": {
       "aliases": [],
-      "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\nDefault behavior installs the global notify hook and writes local project config.",
-      "examples": [
-        "respan integrate codex-cli",
-        "respan integrate codex-cli --disable",
-        "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"
-      ],
+      "args": {
+        "id": {
+          "description": "Evaluator ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update an evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2043,9 +2002,8 @@
           "type": "option"
         },
         "base-url": {
-          "description": "Respan API base URL (for enterprise deployments)",
+          "description": "Temporary API base URL override for this command",
           "name": "base-url",
-          "default": "https://api.respan.ai/api",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2076,90 +2034,31 @@
           "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"
-        },
-        "enable": {
-          "description": "Enable tracing (default)",
-          "exclusive": [
-            "disable"
-          ],
-          "name": "enable",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "disable": {
-          "description": "Disable tracing",
-          "exclusive": [
-            "enable"
-          ],
-          "name": "disable",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "project-id": {
-          "description": "Respan project ID (added to metadata / resource attributes)",
-          "env": "RESPAN_PROJECT_ID",
-          "name": "project-id",
+        "name": {
+          "description": "Evaluator name",
+          "name": "name",
           "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",
+        "description": {
+          "description": "Evaluator description",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "workflow-name": {
-          "description": "Workflow name for traces (default: claude-code)",
-          "name": "workflow-name",
+        "config": {
+          "description": "Evaluator config as JSON string",
+          "name": "config",
           "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:codex-cli",
+      "id": "evaluators:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2169,21 +2068,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "integrate",
-        "codex-cli.js"
+        "evaluators",
+        "update.js"
       ]
     },
-    "integrate:gemini-cli": {
+    "experiments:create": {
       "aliases": [],
       "args": {},
-      "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\nGemini CLI ignores workspace-level telemetry settings, so --global is the default.",
-      "examples": [
-        "respan integrate gemini-cli",
-        "respan integrate gemini-cli --disable",
-        "respan integrate gemini-cli --local",
-        "respan integrate gemini-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
-        "respan integrate gemini-cli --dry-run"
-      ],
+      "description": "Create a new experiment",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2194,9 +2086,8 @@
           "type": "option"
         },
         "base-url": {
-          "description": "Respan API base URL (for enterprise deployments)",
+          "description": "Temporary API base URL override for this command",
           "name": "base-url",
-          "default": "https://api.respan.ai/api",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2227,90 +2118,40 @@
           "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"
-        },
-        "enable": {
-          "description": "Enable tracing (default)",
-          "exclusive": [
-            "disable"
-          ],
-          "name": "enable",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "disable": {
-          "description": "Disable tracing",
-          "exclusive": [
-            "enable"
-          ],
-          "name": "disable",
-          "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"
-        },
-        "attrs": {
-          "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
-          "name": "attrs",
-          "default": "{}",
+        "name": {
+          "description": "Experiment name",
+          "name": "name",
+          "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",
+        "dataset-id": {
+          "description": "Dataset ID",
+          "name": "dataset-id",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "span-name": {
-          "description": "Root span name for traces (default: claude-code)",
-          "name": "span-name",
+        "description": {
+          "description": "Experiment description",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "workflow-name": {
-          "description": "Workflow name for traces (default: claude-code)",
-          "name": "workflow-name",
+        "workflows": {
+          "description": "Workflows configuration as JSON string",
+          "name": "workflows",
           "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": "experiments:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2320,21 +2161,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "integrate",
-        "gemini-cli.js"
+        "experiments",
+        "create.js"
       ]
     },
-    "integrate:opencode": {
+    "experiments:get": {
       "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 --disable",
-        "respan integrate opencode --global",
-        "respan integrate opencode --project-id my-project --attrs '{\"env\":\"prod\"}'",
-        "respan integrate opencode --dry-run"
-      ],
+      "args": {
+        "id": {
+          "description": "Experiment ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific experiment",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2345,9 +2185,8 @@
           "type": "option"
         },
         "base-url": {
-          "description": "Respan API base URL (for enterprise deployments)",
+          "description": "Temporary API base URL override for this command",
           "name": "base-url",
-          "default": "https://api.respan.ai/api",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2377,91 +2216,11 @@
           "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"
-        },
-        "enable": {
-          "description": "Enable tracing (default)",
-          "exclusive": [
-            "disable"
-          ],
-          "name": "enable",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "disable": {
-          "description": "Disable tracing",
-          "exclusive": [
-            "enable"
-          ],
-          "name": "disable",
-          "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"
-        },
-        "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": "integrate:opencode",
+      "id": "experiments:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2471,14 +2230,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "integrate",
-        "opencode.js"
+        "experiments",
+        "get.js"
       ]
     },
-    "logs:create": {
+    "experiments:list": {
       "aliases": [],
       "args": {},
-      "description": "Create a log span",
+      "description": "List experiments",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2521,10 +2280,89 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "input": {
-          "description": "Input text or JSON",
-          "name": "input",
-          "required": true,
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "experiments:list",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "experiments",
+        "list.js"
+      ]
+    },
+    "logs:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a 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"
+        },
+        "base-url": {
+          "description": "Temporary API base URL override for this command",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile": {
+          "description": "Named profile to use",
+          "name": "profile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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"
+        },
+        "input": {
+          "description": "Input text or JSON",
+          "name": "input",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4269,7 +4107,791 @@
         "users",
         "update.js"
       ]
+    },
+    "integrate:claude-code": {
+      "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\nDefault behavior installs the global hook and writes local project config.",
+      "examples": [
+        "respan integrate claude-code",
+        "respan integrate claude-code --disable",
+        "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)",
+          "env": "RESPAN_API_KEY",
+          "name": "api-key",
+          "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"
+        },
+        "profile": {
+          "description": "Named profile to use",
+          "name": "profile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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"
+        },
+        "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"
+        },
+        "enable": {
+          "description": "Enable tracing (default)",
+          "exclusive": [
+            "disable"
+          ],
+          "name": "enable",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "disable": {
+          "description": "Disable tracing",
+          "exclusive": [
+            "enable"
+          ],
+          "name": "disable",
+          "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"
+        },
+        "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": "integrate:claude-code",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "integrate",
+        "claude-code.js"
+      ]
+    },
+    "integrate:codex-cli": {
+      "aliases": [],
+      "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\nDefault behavior installs the global notify hook and writes local project config.",
+      "examples": [
+        "respan integrate codex-cli",
+        "respan integrate codex-cli --disable",
+        "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)",
+          "env": "RESPAN_API_KEY",
+          "name": "api-key",
+          "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"
+        },
+        "profile": {
+          "description": "Named profile to use",
+          "name": "profile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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"
+        },
+        "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"
+        },
+        "enable": {
+          "description": "Enable tracing (default)",
+          "exclusive": [
+            "disable"
+          ],
+          "name": "enable",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "disable": {
+          "description": "Disable tracing",
+          "exclusive": [
+            "enable"
+          ],
+          "name": "disable",
+          "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"
+        },
+        "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": "integrate:codex-cli",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "integrate",
+        "codex-cli.js"
+      ]
+    },
+    "integrate:gemini-cli": {
+      "aliases": [],
+      "args": {},
+      "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\nGemini CLI ignores workspace-level telemetry settings, so --global is the default.",
+      "examples": [
+        "respan integrate gemini-cli",
+        "respan integrate gemini-cli --disable",
+        "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)",
+          "env": "RESPAN_API_KEY",
+          "name": "api-key",
+          "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"
+        },
+        "profile": {
+          "description": "Named profile to use",
+          "name": "profile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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"
+        },
+        "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"
+        },
+        "enable": {
+          "description": "Enable tracing (default)",
+          "exclusive": [
+            "disable"
+          ],
+          "name": "enable",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "disable": {
+          "description": "Disable tracing",
+          "exclusive": [
+            "enable"
+          ],
+          "name": "disable",
+          "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"
+        },
+        "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": "integrate:gemini-cli",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "integrate",
+        "gemini-cli.js"
+      ]
+    },
+    "integrate:opencode": {
+      "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 --disable",
+        "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)",
+          "env": "RESPAN_API_KEY",
+          "name": "api-key",
+          "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"
+        },
+        "profile": {
+          "description": "Named profile to use",
+          "name": "profile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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"
+        },
+        "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"
+        },
+        "enable": {
+          "description": "Enable tracing (default)",
+          "exclusive": [
+            "disable"
+          ],
+          "name": "enable",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "disable": {
+          "description": "Disable tracing",
+          "exclusive": [
+            "enable"
+          ],
+          "name": "disable",
+          "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"
+        },
+        "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": "integrate:opencode",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "integrate",
+        "opencode.js"
+      ]
+    },
+    "integrate:pi": {
+      "aliases": [],
+      "args": {},
+      "description": "Integrate Respan with the pi coding agent (https://pi.dev).\n\nInstalls the @respan/instrumentation-pi pi package — a pi extension that\ntraces every agent run as one turn span per prompt with chat and tool spans underneath,\ncorrelating all runs of a pi session by its session id — and writes a\nnon-secret respan.json config for it.\n\nScope:\n  --global   pi install npm:@respan/instrumentation-pi + ~/.pi/agent/respan.json (default)\n  --local    pi install -l npm:@respan/instrumentation-pi + .pi/respan.json in the project root\n\nTrace scope (--trace-scope, \"trace_scope\" in respan.json):\n  run        one trace per agent run; runs of a session share a thread id (default)\n  session    one multi-root trace per pi session (long-lived, resumed sessions)\n\nDurable delivery (--with-collector):\n  Sets base_url to a local Respan collector (http://127.0.0.1:4318) so traces\n  go through its persistent queue and survive Respan outages. Run\n  \"respan collector start\" once per machine.\n\nCredentials are never written to these files: the extension reads\nRESPAN_API_KEY or ~/.respan/credentials.json (from \"respan auth login\").",
+      "examples": [
+        "respan integrate pi",
+        "respan integrate pi --disable",
+        "respan integrate pi --local",
+        "respan integrate pi --customer-id frank --workflow-name email-agent",
+        "respan integrate pi --trace-scope session",
+        "respan integrate pi --with-collector",
+        "respan integrate pi --project-id my-project --attrs '{\"env\":\"prod\"}'",
+        "respan integrate pi --dry-run"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (env: RESPAN_API_KEY)",
+          "env": "RESPAN_API_KEY",
+          "name": "api-key",
+          "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"
+        },
+        "profile": {
+          "description": "Named profile to use",
+          "name": "profile",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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"
+        },
+        "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"
+        },
+        "enable": {
+          "description": "Enable tracing (default)",
+          "exclusive": [
+            "disable"
+          ],
+          "name": "enable",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "disable": {
+          "description": "Disable tracing",
+          "exclusive": [
+            "enable"
+          ],
+          "name": "disable",
+          "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"
+        },
+        "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": "Alias of --workflow-name (default: pi)",
+          "name": "span-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workflow-name": {
+          "description": "traceloop.workflow.name on pi turn spans (default: pi)",
+          "name": "workflow-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Preview changes without writing files",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "trace-scope": {
+          "description": "Trace scope: \"run\" = one trace per agent run (default), \"session\" = one multi-root trace per pi session",
+          "name": "trace-scope",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "run",
+            "session"
+          ],
+          "type": "option"
+        },
+        "with-collector": {
+          "description": "Send traces through a local Respan collector (respan collector start) for durable delivery",
+          "name": "with-collector",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "collector-port": {
+          "description": "Port of the local collector, with --with-collector (default: 4318)",
+          "name": "collector-port",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "integrate:pi",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "integrate",
+        "pi.js"
+      ]
     }
   },
-  "version": "0.13.2"
+  "version": "0.14.0"
 }