@respan/cli 0.10.0 → 0.12.0

package/oclif.manifest.json

@@ -470,75 +470,6 @@
         "set.js"
       ]
     },
-    "eval": {
-      "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)",
-      "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"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "eval",
-      "pluginAlias": "@respan/cli",
-      "pluginName": "@respan/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "eval",
-        "index.js"
-      ]
-    },
     "datasets:create-span": {
       "aliases": [],
       "args": {
@@ -1068,10 +999,14 @@
         "update.js"
       ]
     },
-    "evaluators:create": {
+    "demo:clear": {
       "aliases": [],
       "args": {},
-      "description": "Create a new evaluator",
+      "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)",
@@ -1114,39 +1049,17 @@
           "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"
+        "yes": {
+          "char": "y",
+          "description": "Skip the confirmation prompt",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:create",
+      "id": "demo:clear",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1156,20 +1069,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "create.js"
+        "demo",
+        "clear.js"
       ]
     },
-    "evaluators:get": {
+    "demo": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Evaluator ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get a specific 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)",
@@ -1215,7 +1125,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:get",
+      "id": "demo",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1225,14 +1135,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "get.js"
+        "demo",
+        "index.js"
       ]
     },
-    "evaluators:list": {
+    "eval": {
       "aliases": [],
-      "args": {},
-      "description": "List evaluators",
+      "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)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1274,27 +1190,11 @@
           "name": "verbose",
           "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:list",
+      "id": "eval",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1304,20 +1204,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "list.js"
+        "eval",
+        "index.js"
       ]
     },
-    "evaluators:run": {
+    "evaluators:create": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Evaluator ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Run an evaluator",
+      "args": {},
+      "description": "Create a new evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1360,23 +1254,31 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "dataset-id": {
-          "description": "Dataset ID to evaluate against",
-          "name": "dataset-id",
+        "name": {
+          "description": "Evaluator name",
+          "name": "name",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "log-ids": {
-          "description": "Comma-separated log/span IDs to evaluate",
-          "name": "log-ids",
+        "type": {
+          "description": "Evaluator type",
+          "name": "type",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "params": {
-          "description": "Additional parameters as JSON string",
-          "name": "params",
+        "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"
@@ -1384,7 +1286,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:run",
+      "id": "evaluators:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1395,10 +1297,10 @@
         "dist",
         "commands",
         "evaluators",
-        "run.js"
+        "create.js"
       ]
     },
-    "evaluators:update": {
+    "evaluators:get": {
       "aliases": [],
       "args": {
         "id": {
@@ -1407,7 +1309,7 @@
           "required": true
         }
       },
-      "description": "Update an evaluator",
+      "description": "Get a specific evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1449,32 +1351,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": "evaluators:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1485,13 +1366,13 @@
         "dist",
         "commands",
         "evaluators",
-        "update.js"
+        "get.js"
       ]
     },
-    "experiments:create": {
+    "evaluators:list": {
       "aliases": [],
       "args": {},
-      "description": "Create a new experiment",
+      "description": "List evaluators",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1534,32 +1415,18 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Experiment name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "dataset-id": {
-          "description": "Dataset ID",
-          "name": "dataset-id",
-          "required": true,
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Experiment description",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "workflows": {
-          "description": "Workflows configuration as JSON string",
-          "name": "workflows",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1567,7 +1434,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "experiments:create",
+      "id": "evaluators:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1577,20 +1444,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "experiments",
-        "create.js"
+        "evaluators",
+        "list.js"
       ]
     },
-    "experiments:get": {
+    "evaluators:run": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Experiment ID",
+          "description": "Evaluator ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific experiment",
+      "description": "Run an evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1632,11 +1499,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": "experiments:get",
+      "id": "evaluators:run",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1646,14 +1534,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "experiments",
-        "get.js"
+        "evaluators",
+        "run.js"
       ]
     },
-    "experiments:list": {
+    "evaluators:update": {
       "aliases": [],
-      "args": {},
-      "description": "List experiments",
+      "args": {
+        "id": {
+          "description": "Evaluator ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update an evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1696,18 +1590,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "default": 20,
+        "name": {
+          "description": "Evaluator name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "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"
@@ -1715,7 +1614,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "experiments:list",
+      "id": "evaluators:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1725,8 +1624,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "experiments",
-        "list.js"
+        "evaluators",
+        "update.js"
       ]
     },
     "integrate:claude-code": {
@@ -2335,10 +2234,10 @@
         "opencode.js"
       ]
     },
-    "logs:create": {
+    "experiments:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a log span",
+      "description": "Create a new experiment",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2381,31 +2280,32 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "input": {
-          "description": "Input text or JSON",
-          "name": "input",
+        "name": {
+          "description": "Experiment name",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "output": {
-          "description": "Output text or JSON",
-          "name": "output",
+        "dataset-id": {
+          "description": "Dataset ID",
+          "name": "dataset-id",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "model": {
-          "description": "Model name",
-          "name": "model",
+        "description": {
+          "description": "Experiment description",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "metadata": {
-          "description": "Metadata as JSON string",
-          "name": "metadata",
+        "workflows": {
+          "description": "Workflows configuration as JSON string",
+          "name": "workflows",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2413,7 +2313,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:create",
+      "id": "experiments:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2423,20 +2323,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "experiments",
         "create.js"
       ]
     },
-    "logs:get": {
+    "experiments:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Span ID",
+          "description": "Experiment ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific log span",
+      "description": "Get a specific experiment",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2482,7 +2382,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:get",
+      "id": "experiments:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2492,14 +2392,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "experiments",
         "get.js"
       ]
     },
-    "logs:list": {
+    "experiments: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 experiments",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2543,9 +2443,9 @@
           "type": "boolean"
         },
         "limit": {
-          "description": "Number of results per page (max 1000)",
+          "description": "Number of results per page",
           "name": "limit",
-          "default": 50,
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2557,60 +2457,11 @@
           "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": "experiments:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2620,14 +2471,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "experiments",
         "list.js"
       ]
     },
-    "logs:summary": {
+    "logs:create": {
       "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",
+      "description": "Create a log span",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2670,39 +2521,31 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "start-time": {
-          "description": "Start time (ISO 8601)",
-          "name": "start-time",
+        "input": {
+          "description": "Input text or JSON",
+          "name": "input",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "end-time": {
-          "description": "End time (ISO 8601)",
-          "name": "end-time",
-          "required": true,
+        "output": {
+          "description": "Output text or JSON",
+          "name": "output",
           "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",
+        "model": {
+          "description": "Model name",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "is-test": {
-          "description": "Filter by test (true) or production (false) environment",
-          "name": "is-test",
+        "metadata": {
+          "description": "Metadata as JSON string",
+          "name": "metadata",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2710,7 +2553,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:summary",
+      "id": "logs:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2721,19 +2564,19 @@
         "dist",
         "commands",
         "logs",
-        "summary.js"
+        "create.js"
       ]
     },
-    "prompts:create-version": {
+    "logs:get": {
       "aliases": [],
       "args": {
-        "prompt-id": {
-          "description": "Prompt ID",
-          "name": "prompt-id",
+        "id": {
+          "description": "Span ID",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Create a new version of a prompt",
+      "description": "Get a specific log span",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2775,40 +2618,308 @@
           "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,
+      "hiddenAliases": [],
+      "id": "logs:get",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "logs",
+        "get.js"
+      ]
+    },
+    "logs: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",
+      "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"
+        },
+        "limit": {
+          "description": "Number of results per page (max 1000)",
+          "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",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "logs",
+        "list.js"
+      ]
+    },
+    "logs:summary": {
+      "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",
+      "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"
+        },
+        "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",
+          "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "logs:summary",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "logs",
+        "summary.js"
+      ]
+    },
+    "traces:get": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Trace ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific trace",
+      "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"
         },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
+        "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:create-version",
+      "id": "traces:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2818,14 +2929,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "create-version.js"
+        "traces",
+        "get.js"
       ]
     },
-    "prompts:create": {
+    "traces:list": {
       "aliases": [],
       "args": {},
-      "description": "Create a new prompt",
+      "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)",
@@ -2868,17 +2979,133 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Prompt name",
-          "name": "name",
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 10,
+          "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)",
+          "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"
+        },
+        "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": "traces:list",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "traces",
+        "list.js"
+      ]
+    },
+    "traces:summary": {
+      "aliases": [],
+      "args": {},
+      "description": "Get a span-level summary of activity for a time range (counts, latency, cost, errors aggregated across spans)",
+      "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"
+        },
+        "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"
@@ -2886,7 +3113,92 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:create",
+      "id": "traces:summary",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "traces",
+        "summary.js"
+      ]
+    },
+    "setup:doctor": {
+      "aliases": [],
+      "args": {},
+      "description": "Diagnose coding-agent setup for Respan",
+      "examples": [
+        "respan setup doctor",
+        "respan setup doctor --global"
+      ],
+      "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"
+        },
+        "local": {
+          "description": "Check local project setup",
+          "exclusive": [
+            "global"
+          ],
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "global": {
+          "description": "Check global setup",
+          "exclusive": [
+            "local"
+          ],
+          "name": "global",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "setup:doctor",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2896,20 +3208,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "create.js"
+        "setup",
+        "doctor.js"
       ]
     },
-    "prompts:get": {
+    "setup:gateway": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Prompt ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get a specific prompt",
+      "args": {},
+      "description": "Set up Respan gateway routing in this project.\n\nRuns the gateway setup flow directly (skips the \"Tracing or Gateway?\"\nquestion). Sets up your API key, installs the Respan skill, and optionally\nopens your coding agent to route the detected framework through the gateway.",
+      "examples": [
+        "respan setup gateway",
+        "respan setup gateway --agent claude-code",
+        "respan setup gateway --no-instrument"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2934,13 +3245,13 @@
           "type": "option"
         },
         "json": {
-          "description": "Output as JSON",
+          "hidden": true,
           "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
         "csv": {
-          "description": "Output as CSV",
+          "hidden": true,
           "name": "csv",
           "allowNo": false,
           "type": "boolean"
@@ -2951,11 +3262,24 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "agent": {
+          "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
+          "name": "agent",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-instrument": {
+          "description": "Skip opening the agent after setup",
+          "name": "no-instrument",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:get",
+      "id": "setup:gateway",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2965,14 +3289,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "get.js"
+        "setup",
+        "gateway.js"
       ]
     },
-    "prompts:list": {
+    "setup": {
       "aliases": [],
       "args": {},
-      "description": "List prompts",
+      "description": "Interactive setup wizard for Respan.\n\nSets up your API key, installs skills and SDK docs for your preferred\ncoding agents, and optionally runs a setup agent. Asks whether you want\nto set up tracing or gateway routing.\n\nThis is the recommended way to get started with Respan.",
+      "examples": [
+        "npx @respan/cli setup",
+        "respan setup",
+        "respan setup tracing",
+        "respan setup gateway",
+        "respan setup --agent claude-code",
+        "respan setup --no-instrument"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2997,13 +3329,13 @@
           "type": "option"
         },
         "json": {
-          "description": "Output as JSON",
+          "hidden": true,
           "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
         "csv": {
-          "description": "Output as CSV",
+          "hidden": true,
           "name": "csv",
           "allowNo": false,
           "type": "boolean"
@@ -3015,18 +3347,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "default": 50,
+        "agent": {
+          "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
+          "name": "agent",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "no-instrument": {
+          "description": "Skip opening the agent after setup",
+          "name": "no-instrument",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:list",
+      "id": "setup",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3036,20 +3373,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "list.js"
+        "setup",
+        "index.js"
       ]
     },
-    "prompts:update": {
+    "setup:tracing": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Prompt ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Update a prompt",
+      "args": {},
+      "description": "Set up Respan SDK tracing in this project.\n\nRuns the tracing setup flow directly (skips the \"Tracing or Gateway?\"\nquestion). Sets up your API key, installs the Respan skill, and optionally\nopens your coding agent to instrument the project.",
+      "examples": [
+        "respan setup tracing",
+        "respan setup tracing --agent claude-code",
+        "respan setup tracing --no-instrument"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3074,13 +3410,13 @@
           "type": "option"
         },
         "json": {
-          "description": "Output as JSON",
+          "hidden": true,
           "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
         "csv": {
-          "description": "Output as CSV",
+          "hidden": true,
           "name": "csv",
           "allowNo": false,
           "type": "boolean"
@@ -3092,24 +3428,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Prompt name",
-          "name": "name",
+        "agent": {
+          "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
+          "name": "agent",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Prompt description",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "no-instrument": {
+          "description": "Skip opening the agent after setup",
+          "name": "no-instrument",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:update",
+      "id": "setup:tracing",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3119,20 +3454,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "update.js"
+        "setup",
+        "tracing.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)",
@@ -3174,11 +3503,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",
@@ -3188,18 +3546,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "versions.js"
+        "users",
+        "create.js"
       ]
     },
-    "setup:doctor": {
+    "users:get": {
       "aliases": [],
-      "args": {},
-      "description": "Diagnose coding-agent setup for Respan",
-      "examples": [
-        "respan setup doctor",
-        "respan setup doctor --global"
-      ],
+      "args": {
+        "id": {
+          "description": "Customer identifier",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3241,29 +3601,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "local": {
-          "description": "Check local project setup",
-          "exclusive": [
-            "global"
-          ],
-          "name": "local",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "global": {
-          "description": "Check global setup",
-          "exclusive": [
-            "local"
-          ],
-          "name": "global",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "setup:doctor",
+      "id": "users:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3273,21 +3615,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "setup",
-        "doctor.js"
+        "users",
+        "get.js"
       ]
     },
-    "setup": {
+    "users:list": {
       "aliases": [],
       "args": {},
-      "description": "Interactive setup wizard for Respan.\n\nSets up your API key, installs skills and SDK docs for your preferred\ncoding agents, and optionally runs an instrumentation agent.\n\nThis is the recommended way to get started with Respan.",
-      "examples": [
-        "npx @respan/cli setup",
-        "respan setup",
-        "respan setup --agent claude-code",
-        "respan setup --no-instrument",
-        "respan setup --agent cursor"
-      ],
+      "description": "List users (customers)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3330,23 +3665,40 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "agent": {
-          "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
-          "name": "agent",
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-instrument": {
-          "description": "Skip opening the agent after setup",
-          "name": "no-instrument",
-          "allowNo": false,
-          "type": "boolean"
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sort-by": {
+          "description": "Sort field",
+          "name": "sort-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment": {
+          "description": "Environment filter",
+          "name": "environment",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "setup",
+      "id": "users:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3356,20 +3708,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "setup",
-        "index.js"
+        "users",
+        "list.js"
       ]
     },
-    "traces:get": {
+    "users:update": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Trace ID",
+          "description": "Customer identifier",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific trace",
+      "description": "Update a user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3411,11 +3763,32 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "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": "traces:get",
+      "id": "users:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3425,14 +3798,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
-        "get.js"
+        "users",
+        "update.js"
       ]
     },
-    "traces:list": {
+    "prompts:create-version": {
       "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",
+      "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)",
@@ -3475,62 +3854,39 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "default": 10,
-          "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)",
-          "name": "sort-by",
-          "default": "-timestamp",
+        "messages": {
+          "description": "Messages as JSON array string",
+          "name": "messages",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "start-time": {
-          "description": "Start time filter (ISO 8601)",
-          "name": "start-time",
+        "model": {
+          "description": "Model name",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "end-time": {
-          "description": "End time filter (ISO 8601)",
-          "name": "end-time",
+        "temperature": {
+          "description": "Temperature value",
+          "name": "temperature",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "environment": {
-          "description": "Environment filter",
-          "name": "environment",
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
           "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": "prompts:create-version",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3540,14 +3896,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
-        "list.js"
+        "prompts",
+        "create-version.js"
       ]
     },
-    "traces:summary": {
+    "prompts:create": {
       "aliases": [],
       "args": {},
-      "description": "Get a span-level summary of activity for a time range (counts, latency, cost, errors aggregated across spans)",
+      "description": "Create a new prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3590,18 +3946,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "start-time": {
-          "description": "Start time (ISO 8601)",
-          "name": "start-time",
+        "name": {
+          "description": "Prompt name",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "end-time": {
-          "description": "End time (ISO 8601)",
-          "name": "end-time",
-          "required": true,
+        "description": {
+          "description": "Prompt description",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3609,7 +3964,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:summary",
+      "id": "prompts:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3619,14 +3974,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
-        "summary.js"
+        "prompts",
+        "create.js"
       ]
     },
-    "users:create": {
+    "prompts:get": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new user (customer)",
+      "args": {
+        "id": {
+          "description": "Prompt ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3668,40 +4029,11 @@
           "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": "users:create",
+      "id": "prompts:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3711,20 +4043,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "create.js"
+        "prompts",
+        "get.js"
       ]
     },
-    "users:get": {
+    "prompts:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Customer identifier",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get a specific user (customer)",
+      "args": {},
+      "description": "List prompts",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3766,11 +4092,19 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:get",
+      "id": "prompts:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3780,14 +4114,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "get.js"
+        "prompts",
+        "list.js"
       ]
     },
-    "users:list": {
+    "prompts:update": {
       "aliases": [],
-      "args": {},
-      "description": "List users (customers)",
+      "args": {
+        "id": {
+          "description": "Prompt ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3830,32 +4170,16 @@
           "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"
-        },
-        "sort-by": {
-          "description": "Sort field",
-          "name": "sort-by",
+        "name": {
+          "description": "Prompt name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "environment": {
-          "description": "Environment filter",
-          "name": "environment",
+        "description": {
+          "description": "Prompt description",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3863,7 +4187,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:list",
+      "id": "prompts:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3873,20 +4197,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "list.js"
+        "prompts",
+        "update.js"
       ]
     },
-    "users:update": {
+    "prompts:versions": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Customer identifier",
-          "name": "id",
+        "prompt-id": {
+          "description": "Prompt ID",
+          "name": "prompt-id",
           "required": true
         }
       },
-      "description": "Update a user (customer)",
+      "description": "List versions of a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3928,32 +4252,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "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": "users:update",
+      "id": "prompts:versions",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3963,10 +4266,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "update.js"
+        "prompts",
+        "versions.js"
       ]
     }
   },
-  "version": "0.10.0"
+  "version": "0.12.0"
 }