@respan/cli 0.6.8 → 0.6.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/dist/hooks/gemini-cli.cjs +107 -48
  2. package/dist/hooks/gemini-cli.js +128 -57
  3. package/oclif.manifest.json +444 -444
  4. package/package.json +1 -1
package/oclif.manifest.json CHANGED
@@ -2370,17 +2370,16 @@
2370
2370
  "versions.js"
2371
2371
  ]
2372
2372
  },
2373
- "integrate:claude-code": {
2373
+ "traces:get": {
2374
2374
  "aliases": [],
2375
- "args": {},
2376
- "description": "Integrate Respan with Claude Code.\n\nInstalls a Stop hook that reads conversation transcripts and sends\nthem to Respan as structured spans (chat, tool, thinking).\n\nScope:\n --global Install hook script + register in ~/.claude/settings.json\n --local Write credentials + enable flag to .claude/settings.local.json\n (default) Both: install hook globally + enable for current project",
2377
- "examples": [
2378
- "respan integrate claude-code",
2379
- "respan integrate claude-code --global",
2380
- "respan integrate claude-code --local --project-id my-project",
2381
- "respan integrate claude-code --attrs '{\"env\":\"prod\"}'",
2382
- "respan integrate claude-code --dry-run"
2383
- ],
2375
+ "args": {
2376
+ "id": {
2377
+ "description": "Trace ID",
2378
+ "name": "id",
2379
+ "required": true
2380
+ }
2381
+ },
2382
+ "description": "Get a specific trace",
2384
2383
  "flags": {
2385
2384
  "api-key": {
2386
2385
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2415,81 +2414,119 @@
2415
2414
  "name": "verbose",
2416
2415
  "allowNo": false,
2417
2416
  "type": "boolean"
2417
+ }
2418
+ },
2419
+ "hasDynamicHelp": false,
2420
+ "hiddenAliases": [],
2421
+ "id": "traces:get",
2422
+ "pluginAlias": "@respan/cli",
2423
+ "pluginName": "@respan/cli",
2424
+ "pluginType": "core",
2425
+ "strict": true,
2426
+ "enableJsonFlag": false,
2427
+ "isESM": true,
2428
+ "relativePath": [
2429
+ "dist",
2430
+ "commands",
2431
+ "traces",
2432
+ "get.js"
2433
+ ]
2434
+ },
2435
+ "traces:list": {
2436
+ "aliases": [],
2437
+ "args": {},
2438
+ "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",
2439
+ "flags": {
2440
+ "api-key": {
2441
+ "description": "API key (env: RESPAN_API_KEY)",
2442
+ "env": "RESPAN_API_KEY",
2443
+ "name": "api-key",
2444
+ "hasDynamicHelp": false,
2445
+ "multiple": false,
2446
+ "type": "option"
2418
2447
  },
2419
- "local": {
2420
- "description": "Write per-project config (default)",
2421
- "exclusive": [
2422
- "global"
2423
- ],
2424
- "name": "local",
2448
+ "profile": {
2449
+ "description": "Named profile to use",
2450
+ "name": "profile",
2451
+ "hasDynamicHelp": false,
2452
+ "multiple": false,
2453
+ "type": "option"
2454
+ },
2455
+ "json": {
2456
+ "description": "Output as JSON",
2457
+ "name": "json",
2425
2458
  "allowNo": false,
2426
2459
  "type": "boolean"
2427
2460
  },
2428
- "global": {
2429
- "description": "Write user-level global config",
2430
- "exclusive": [
2431
- "local"
2432
- ],
2433
- "name": "global",
2461
+ "csv": {
2462
+ "description": "Output as CSV",
2463
+ "name": "csv",
2434
2464
  "allowNo": false,
2435
2465
  "type": "boolean"
2436
2466
  },
2437
- "project-id": {
2438
- "description": "Respan project ID (added to metadata / resource attributes)",
2439
- "env": "RESPAN_PROJECT_ID",
2440
- "name": "project-id",
2467
+ "verbose": {
2468
+ "char": "v",
2469
+ "description": "Show verbose output",
2470
+ "name": "verbose",
2471
+ "allowNo": false,
2472
+ "type": "boolean"
2473
+ },
2474
+ "limit": {
2475
+ "description": "Number of results per page",
2476
+ "name": "limit",
2477
+ "default": 10,
2441
2478
  "hasDynamicHelp": false,
2442
2479
  "multiple": false,
2443
2480
  "type": "option"
2444
2481
  },
2445
- "base-url": {
2446
- "description": "Respan API base URL (for enterprise deployments)",
2447
- "name": "base-url",
2448
- "default": "https://api.respan.ai/api",
2482
+ "page": {
2483
+ "description": "Page number",
2484
+ "name": "page",
2485
+ "default": 1,
2449
2486
  "hasDynamicHelp": false,
2450
2487
  "multiple": false,
2451
2488
  "type": "option"
2452
2489
  },
2453
- "attrs": {
2454
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2455
- "name": "attrs",
2456
- "default": "{}",
2490
+ "sort-by": {
2491
+ "description": "Sort field (prefix with - for descending)",
2492
+ "name": "sort-by",
2493
+ "default": "-timestamp",
2457
2494
  "hasDynamicHelp": false,
2458
2495
  "multiple": false,
2459
2496
  "type": "option"
2460
2497
  },
2461
- "customer-id": {
2462
- "description": "Customer/user identifier for traces (e.g. your name or email)",
2463
- "env": "RESPAN_CUSTOMER_ID",
2464
- "name": "customer-id",
2498
+ "start-time": {
2499
+ "description": "Start time filter (ISO 8601)",
2500
+ "name": "start-time",
2465
2501
  "hasDynamicHelp": false,
2466
2502
  "multiple": false,
2467
2503
  "type": "option"
2468
2504
  },
2469
- "span-name": {
2470
- "description": "Root span name for traces (default: claude-code)",
2471
- "name": "span-name",
2505
+ "end-time": {
2506
+ "description": "End time filter (ISO 8601)",
2507
+ "name": "end-time",
2472
2508
  "hasDynamicHelp": false,
2473
2509
  "multiple": false,
2474
2510
  "type": "option"
2475
2511
  },
2476
- "workflow-name": {
2477
- "description": "Workflow name for traces (default: claude-code)",
2478
- "name": "workflow-name",
2512
+ "environment": {
2513
+ "description": "Environment filter",
2514
+ "name": "environment",
2479
2515
  "hasDynamicHelp": false,
2480
2516
  "multiple": false,
2481
2517
  "type": "option"
2482
2518
  },
2483
- "dry-run": {
2484
- "description": "Preview changes without writing files",
2485
- "name": "dry-run",
2486
- "allowNo": false,
2487
- "type": "boolean"
2519
+ "filter": {
2520
+ "description": "Filter in field:operator:value format (repeatable)",
2521
+ "name": "filter",
2522
+ "hasDynamicHelp": false,
2523
+ "multiple": true,
2524
+ "type": "option"
2488
2525
  }
2489
2526
  },
2490
2527
  "hasDynamicHelp": false,
2491
2528
  "hiddenAliases": [],
2492
- "id": "integrate:claude-code",
2529
+ "id": "traces:list",
2493
2530
  "pluginAlias": "@respan/cli",
2494
2531
  "pluginName": "@respan/cli",
2495
2532
  "pluginType": "core",
@@ -2499,21 +2536,14 @@
2499
2536
  "relativePath": [
2500
2537
  "dist",
2501
2538
  "commands",
2502
- "integrate",
2503
- "claude-code.js"
2539
+ "traces",
2540
+ "list.js"
2504
2541
  ]
2505
2542
  },
2506
- "integrate:codex-cli": {
2543
+ "traces:summary": {
2507
2544
  "aliases": [],
2508
2545
  "args": {},
2509
- "description": "Integrate Respan with Codex CLI.\n\nInstalls a notify hook that reads session JSONL files and sends\nthem to Respan as structured spans (chat, tool, reasoning).\n\nScope:\n --global Install hook script + register notify in ~/.codex/config.toml\n --local Write .codex/respan.json with customer_id, span_name, etc.\n (default) Both: install hook globally + config for current project",
2510
- "examples": [
2511
- "respan integrate codex-cli",
2512
- "respan integrate codex-cli --global",
2513
- "respan integrate codex-cli --local --customer-id frank",
2514
- "respan integrate codex-cli --attrs '{\"env\":\"prod\"}'",
2515
- "respan integrate codex-cli --dry-run"
2516
- ],
2546
+ "description": "Get a summary of traces for a time range",
2517
2547
  "flags": {
2518
2548
  "api-key": {
2519
2549
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2549,80 +2579,26 @@
2549
2579
  "allowNo": false,
2550
2580
  "type": "boolean"
2551
2581
  },
2552
- "local": {
2553
- "description": "Write per-project config (default)",
2554
- "exclusive": [
2555
- "global"
2556
- ],
2557
- "name": "local",
2558
- "allowNo": false,
2559
- "type": "boolean"
2560
- },
2561
- "global": {
2562
- "description": "Write user-level global config",
2563
- "exclusive": [
2564
- "local"
2565
- ],
2566
- "name": "global",
2567
- "allowNo": false,
2568
- "type": "boolean"
2569
- },
2570
- "project-id": {
2571
- "description": "Respan project ID (added to metadata / resource attributes)",
2572
- "env": "RESPAN_PROJECT_ID",
2573
- "name": "project-id",
2574
- "hasDynamicHelp": false,
2575
- "multiple": false,
2576
- "type": "option"
2577
- },
2578
- "base-url": {
2579
- "description": "Respan API base URL (for enterprise deployments)",
2580
- "name": "base-url",
2581
- "default": "https://api.respan.ai/api",
2582
- "hasDynamicHelp": false,
2583
- "multiple": false,
2584
- "type": "option"
2585
- },
2586
- "attrs": {
2587
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2588
- "name": "attrs",
2589
- "default": "{}",
2590
- "hasDynamicHelp": false,
2591
- "multiple": false,
2592
- "type": "option"
2593
- },
2594
- "customer-id": {
2595
- "description": "Customer/user identifier for traces (e.g. your name or email)",
2596
- "env": "RESPAN_CUSTOMER_ID",
2597
- "name": "customer-id",
2598
- "hasDynamicHelp": false,
2599
- "multiple": false,
2600
- "type": "option"
2601
- },
2602
- "span-name": {
2603
- "description": "Root span name for traces (default: claude-code)",
2604
- "name": "span-name",
2582
+ "start-time": {
2583
+ "description": "Start time (ISO 8601)",
2584
+ "name": "start-time",
2585
+ "required": true,
2605
2586
  "hasDynamicHelp": false,
2606
2587
  "multiple": false,
2607
2588
  "type": "option"
2608
2589
  },
2609
- "workflow-name": {
2610
- "description": "Workflow name for traces (default: claude-code)",
2611
- "name": "workflow-name",
2590
+ "end-time": {
2591
+ "description": "End time (ISO 8601)",
2592
+ "name": "end-time",
2593
+ "required": true,
2612
2594
  "hasDynamicHelp": false,
2613
2595
  "multiple": false,
2614
2596
  "type": "option"
2615
- },
2616
- "dry-run": {
2617
- "description": "Preview changes without writing files",
2618
- "name": "dry-run",
2619
- "allowNo": false,
2620
- "type": "boolean"
2621
2597
  }
2622
2598
  },
2623
2599
  "hasDynamicHelp": false,
2624
2600
  "hiddenAliases": [],
2625
- "id": "integrate:codex-cli",
2601
+ "id": "traces:summary",
2626
2602
  "pluginAlias": "@respan/cli",
2627
2603
  "pluginName": "@respan/cli",
2628
2604
  "pluginType": "core",
@@ -2632,20 +2608,14 @@
2632
2608
  "relativePath": [
2633
2609
  "dist",
2634
2610
  "commands",
2635
- "integrate",
2636
- "codex-cli.js"
2611
+ "traces",
2612
+ "summary.js"
2637
2613
  ]
2638
2614
  },
2639
- "integrate:gemini-cli": {
2615
+ "users:create": {
2640
2616
  "aliases": [],
2641
2617
  "args": {},
2642
- "description": "Integrate Respan with Gemini CLI.\n\nInstalls an AfterModel hook that captures LLM request/response data\nand sends it to Respan as structured spans with model, token counts,\nand input/output.\n\nScope:\n --global Write to ~/.gemini/settings.json (default)\n --local Write to .gemini/settings.json in project root\n\nNote: Gemini CLI ignores workspace-level telemetry settings, so\n--global is the default.",
2643
- "examples": [
2644
- "respan integrate gemini-cli",
2645
- "respan integrate gemini-cli --local",
2646
- "respan integrate gemini-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
2647
- "respan integrate gemini-cli --dry-run"
2648
- ],
2618
+ "description": "Create a new user (customer)",
2649
2619
  "flags": {
2650
2620
  "api-key": {
2651
2621
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2681,212 +2651,39 @@
2681
2651
  "allowNo": false,
2682
2652
  "type": "boolean"
2683
2653
  },
2684
- "local": {
2685
- "description": "Write per-project config (default)",
2686
- "exclusive": [
2687
- "global"
2688
- ],
2689
- "name": "local",
2690
- "allowNo": false,
2691
- "type": "boolean"
2654
+ "identifier": {
2655
+ "description": "Customer identifier",
2656
+ "name": "identifier",
2657
+ "required": true,
2658
+ "hasDynamicHelp": false,
2659
+ "multiple": false,
2660
+ "type": "option"
2692
2661
  },
2693
- "global": {
2694
- "description": "Write user-level global config",
2695
- "exclusive": [
2696
- "local"
2697
- ],
2698
- "name": "global",
2699
- "allowNo": false,
2700
- "type": "boolean"
2701
- },
2702
- "project-id": {
2703
- "description": "Respan project ID (added to metadata / resource attributes)",
2704
- "env": "RESPAN_PROJECT_ID",
2705
- "name": "project-id",
2706
- "hasDynamicHelp": false,
2707
- "multiple": false,
2708
- "type": "option"
2709
- },
2710
- "base-url": {
2711
- "description": "Respan API base URL (for enterprise deployments)",
2712
- "name": "base-url",
2713
- "default": "https://api.respan.ai/api",
2714
- "hasDynamicHelp": false,
2715
- "multiple": false,
2716
- "type": "option"
2717
- },
2718
- "attrs": {
2719
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2720
- "name": "attrs",
2721
- "default": "{}",
2722
- "hasDynamicHelp": false,
2723
- "multiple": false,
2724
- "type": "option"
2725
- },
2726
- "customer-id": {
2727
- "description": "Customer/user identifier for traces (e.g. your name or email)",
2728
- "env": "RESPAN_CUSTOMER_ID",
2729
- "name": "customer-id",
2730
- "hasDynamicHelp": false,
2731
- "multiple": false,
2732
- "type": "option"
2733
- },
2734
- "span-name": {
2735
- "description": "Root span name for traces (default: claude-code)",
2736
- "name": "span-name",
2737
- "hasDynamicHelp": false,
2738
- "multiple": false,
2739
- "type": "option"
2740
- },
2741
- "workflow-name": {
2742
- "description": "Workflow name for traces (default: claude-code)",
2743
- "name": "workflow-name",
2744
- "hasDynamicHelp": false,
2745
- "multiple": false,
2746
- "type": "option"
2747
- },
2748
- "dry-run": {
2749
- "description": "Preview changes without writing files",
2750
- "name": "dry-run",
2751
- "allowNo": false,
2752
- "type": "boolean"
2753
- }
2754
- },
2755
- "hasDynamicHelp": false,
2756
- "hiddenAliases": [],
2757
- "id": "integrate:gemini-cli",
2758
- "pluginAlias": "@respan/cli",
2759
- "pluginName": "@respan/cli",
2760
- "pluginType": "core",
2761
- "strict": true,
2762
- "enableJsonFlag": false,
2763
- "isESM": true,
2764
- "relativePath": [
2765
- "dist",
2766
- "commands",
2767
- "integrate",
2768
- "gemini-cli.js"
2769
- ]
2770
- },
2771
- "integrate:opencode": {
2772
- "aliases": [],
2773
- "args": {},
2774
- "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.",
2775
- "examples": [
2776
- "respan integrate opencode",
2777
- "respan integrate opencode --global",
2778
- "respan integrate opencode --project-id my-project --attrs '{\"env\":\"prod\"}'",
2779
- "respan integrate opencode --dry-run"
2780
- ],
2781
- "flags": {
2782
- "api-key": {
2783
- "description": "API key (env: RESPAN_API_KEY)",
2784
- "env": "RESPAN_API_KEY",
2785
- "name": "api-key",
2786
- "hasDynamicHelp": false,
2787
- "multiple": false,
2788
- "type": "option"
2789
- },
2790
- "profile": {
2791
- "description": "Named profile to use",
2792
- "name": "profile",
2793
- "hasDynamicHelp": false,
2794
- "multiple": false,
2795
- "type": "option"
2796
- },
2797
- "json": {
2798
- "description": "Output as JSON",
2799
- "name": "json",
2800
- "allowNo": false,
2801
- "type": "boolean"
2802
- },
2803
- "csv": {
2804
- "description": "Output as CSV",
2805
- "name": "csv",
2806
- "allowNo": false,
2807
- "type": "boolean"
2808
- },
2809
- "verbose": {
2810
- "char": "v",
2811
- "description": "Show verbose output",
2812
- "name": "verbose",
2813
- "allowNo": false,
2814
- "type": "boolean"
2815
- },
2816
- "local": {
2817
- "description": "Write per-project config (default)",
2818
- "exclusive": [
2819
- "global"
2820
- ],
2821
- "name": "local",
2822
- "allowNo": false,
2823
- "type": "boolean"
2824
- },
2825
- "global": {
2826
- "description": "Write user-level global config",
2827
- "exclusive": [
2828
- "local"
2829
- ],
2830
- "name": "global",
2831
- "allowNo": false,
2832
- "type": "boolean"
2833
- },
2834
- "project-id": {
2835
- "description": "Respan project ID (added to metadata / resource attributes)",
2836
- "env": "RESPAN_PROJECT_ID",
2837
- "name": "project-id",
2838
- "hasDynamicHelp": false,
2839
- "multiple": false,
2840
- "type": "option"
2841
- },
2842
- "base-url": {
2843
- "description": "Respan API base URL (for enterprise deployments)",
2844
- "name": "base-url",
2845
- "default": "https://api.respan.ai/api",
2846
- "hasDynamicHelp": false,
2847
- "multiple": false,
2848
- "type": "option"
2849
- },
2850
- "attrs": {
2851
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2852
- "name": "attrs",
2853
- "default": "{}",
2854
- "hasDynamicHelp": false,
2855
- "multiple": false,
2856
- "type": "option"
2857
- },
2858
- "customer-id": {
2859
- "description": "Customer/user identifier for traces (e.g. your name or email)",
2860
- "env": "RESPAN_CUSTOMER_ID",
2861
- "name": "customer-id",
2662
+ "name": {
2663
+ "description": "Customer name",
2664
+ "name": "name",
2862
2665
  "hasDynamicHelp": false,
2863
2666
  "multiple": false,
2864
2667
  "type": "option"
2865
2668
  },
2866
- "span-name": {
2867
- "description": "Root span name for traces (default: claude-code)",
2868
- "name": "span-name",
2669
+ "email": {
2670
+ "description": "Customer email",
2671
+ "name": "email",
2869
2672
  "hasDynamicHelp": false,
2870
2673
  "multiple": false,
2871
2674
  "type": "option"
2872
2675
  },
2873
- "workflow-name": {
2874
- "description": "Workflow name for traces (default: claude-code)",
2875
- "name": "workflow-name",
2676
+ "metadata": {
2677
+ "description": "Metadata as JSON string",
2678
+ "name": "metadata",
2876
2679
  "hasDynamicHelp": false,
2877
2680
  "multiple": false,
2878
2681
  "type": "option"
2879
- },
2880
- "dry-run": {
2881
- "description": "Preview changes without writing files",
2882
- "name": "dry-run",
2883
- "allowNo": false,
2884
- "type": "boolean"
2885
2682
  }
2886
2683
  },
2887
2684
  "hasDynamicHelp": false,
2888
2685
  "hiddenAliases": [],
2889
- "id": "integrate:opencode",
2686
+ "id": "users:create",
2890
2687
  "pluginAlias": "@respan/cli",
2891
2688
  "pluginName": "@respan/cli",
2892
2689
  "pluginType": "core",
@@ -2896,20 +2693,20 @@
2896
2693
  "relativePath": [
2897
2694
  "dist",
2898
2695
  "commands",
2899
- "integrate",
2900
- "opencode.js"
2696
+ "users",
2697
+ "create.js"
2901
2698
  ]
2902
2699
  },
2903
- "traces:get": {
2700
+ "users:get": {
2904
2701
  "aliases": [],
2905
2702
  "args": {
2906
2703
  "id": {
2907
- "description": "Trace ID",
2704
+ "description": "Customer identifier",
2908
2705
  "name": "id",
2909
2706
  "required": true
2910
2707
  }
2911
2708
  },
2912
- "description": "Get a specific trace",
2709
+ "description": "Get a specific user (customer)",
2913
2710
  "flags": {
2914
2711
  "api-key": {
2915
2712
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2948,7 +2745,7 @@
2948
2745
  },
2949
2746
  "hasDynamicHelp": false,
2950
2747
  "hiddenAliases": [],
2951
- "id": "traces:get",
2748
+ "id": "users:get",
2952
2749
  "pluginAlias": "@respan/cli",
2953
2750
  "pluginName": "@respan/cli",
2954
2751
  "pluginType": "core",
@@ -2958,14 +2755,14 @@
2958
2755
  "relativePath": [
2959
2756
  "dist",
2960
2757
  "commands",
2961
- "traces",
2758
+ "users",
2962
2759
  "get.js"
2963
2760
  ]
2964
2761
  },
2965
- "traces:list": {
2762
+ "users:list": {
2966
2763
  "aliases": [],
2967
2764
  "args": {},
2968
- "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",
2765
+ "description": "List users (customers)",
2969
2766
  "flags": {
2970
2767
  "api-key": {
2971
2768
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3004,7 +2801,7 @@
3004
2801
  "limit": {
3005
2802
  "description": "Number of results per page",
3006
2803
  "name": "limit",
3007
- "default": 10,
2804
+ "default": 20,
3008
2805
  "hasDynamicHelp": false,
3009
2806
  "multiple": false,
3010
2807
  "type": "option"
@@ -3018,23 +2815,8 @@
3018
2815
  "type": "option"
3019
2816
  },
3020
2817
  "sort-by": {
3021
- "description": "Sort field (prefix with - for descending)",
2818
+ "description": "Sort field",
3022
2819
  "name": "sort-by",
3023
- "default": "-timestamp",
3024
- "hasDynamicHelp": false,
3025
- "multiple": false,
3026
- "type": "option"
3027
- },
3028
- "start-time": {
3029
- "description": "Start time filter (ISO 8601)",
3030
- "name": "start-time",
3031
- "hasDynamicHelp": false,
3032
- "multiple": false,
3033
- "type": "option"
3034
- },
3035
- "end-time": {
3036
- "description": "End time filter (ISO 8601)",
3037
- "name": "end-time",
3038
2820
  "hasDynamicHelp": false,
3039
2821
  "multiple": false,
3040
2822
  "type": "option"
@@ -3045,18 +2827,11 @@
3045
2827
  "hasDynamicHelp": false,
3046
2828
  "multiple": false,
3047
2829
  "type": "option"
3048
- },
3049
- "filter": {
3050
- "description": "Filter in field:operator:value format (repeatable)",
3051
- "name": "filter",
3052
- "hasDynamicHelp": false,
3053
- "multiple": true,
3054
- "type": "option"
3055
2830
  }
3056
2831
  },
3057
2832
  "hasDynamicHelp": false,
3058
2833
  "hiddenAliases": [],
3059
- "id": "traces:list",
2834
+ "id": "users:list",
3060
2835
  "pluginAlias": "@respan/cli",
3061
2836
  "pluginName": "@respan/cli",
3062
2837
  "pluginType": "core",
@@ -3066,14 +2841,20 @@
3066
2841
  "relativePath": [
3067
2842
  "dist",
3068
2843
  "commands",
3069
- "traces",
2844
+ "users",
3070
2845
  "list.js"
3071
2846
  ]
3072
2847
  },
3073
- "traces:summary": {
2848
+ "users:update": {
3074
2849
  "aliases": [],
3075
- "args": {},
3076
- "description": "Get a summary of traces for a time range",
2850
+ "args": {
2851
+ "id": {
2852
+ "description": "Customer identifier",
2853
+ "name": "id",
2854
+ "required": true
2855
+ }
2856
+ },
2857
+ "description": "Update a user (customer)",
3077
2858
  "flags": {
3078
2859
  "api-key": {
3079
2860
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3109,18 +2890,23 @@
3109
2890
  "allowNo": false,
3110
2891
  "type": "boolean"
3111
2892
  },
3112
- "start-time": {
3113
- "description": "Start time (ISO 8601)",
3114
- "name": "start-time",
3115
- "required": true,
2893
+ "name": {
2894
+ "description": "Customer name",
2895
+ "name": "name",
3116
2896
  "hasDynamicHelp": false,
3117
2897
  "multiple": false,
3118
2898
  "type": "option"
3119
2899
  },
3120
- "end-time": {
3121
- "description": "End time (ISO 8601)",
3122
- "name": "end-time",
3123
- "required": true,
2900
+ "email": {
2901
+ "description": "Customer email",
2902
+ "name": "email",
2903
+ "hasDynamicHelp": false,
2904
+ "multiple": false,
2905
+ "type": "option"
2906
+ },
2907
+ "metadata": {
2908
+ "description": "Metadata as JSON string",
2909
+ "name": "metadata",
3124
2910
  "hasDynamicHelp": false,
3125
2911
  "multiple": false,
3126
2912
  "type": "option"
@@ -3128,7 +2914,7 @@
3128
2914
  },
3129
2915
  "hasDynamicHelp": false,
3130
2916
  "hiddenAliases": [],
3131
- "id": "traces:summary",
2917
+ "id": "users:update",
3132
2918
  "pluginAlias": "@respan/cli",
3133
2919
  "pluginName": "@respan/cli",
3134
2920
  "pluginType": "core",
@@ -3138,14 +2924,21 @@
3138
2924
  "relativePath": [
3139
2925
  "dist",
3140
2926
  "commands",
3141
- "traces",
3142
- "summary.js"
2927
+ "users",
2928
+ "update.js"
3143
2929
  ]
3144
2930
  },
3145
- "users:create": {
2931
+ "integrate:claude-code": {
3146
2932
  "aliases": [],
3147
2933
  "args": {},
3148
- "description": "Create a new user (customer)",
2934
+ "description": "Integrate Respan with Claude Code.\n\nInstalls a Stop hook that reads conversation transcripts and sends\nthem to Respan as structured spans (chat, tool, thinking).\n\nScope:\n --global Install hook script + register in ~/.claude/settings.json\n --local Write credentials + enable flag to .claude/settings.local.json\n (default) Both: install hook globally + enable for current project",
2935
+ "examples": [
2936
+ "respan integrate claude-code",
2937
+ "respan integrate claude-code --global",
2938
+ "respan integrate claude-code --local --project-id my-project",
2939
+ "respan integrate claude-code --attrs '{\"env\":\"prod\"}'",
2940
+ "respan integrate claude-code --dry-run"
2941
+ ],
3149
2942
  "flags": {
3150
2943
  "api-key": {
3151
2944
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3181,39 +2974,80 @@
3181
2974
  "allowNo": false,
3182
2975
  "type": "boolean"
3183
2976
  },
3184
- "identifier": {
3185
- "description": "Customer identifier",
3186
- "name": "identifier",
3187
- "required": true,
2977
+ "local": {
2978
+ "description": "Write per-project config (default)",
2979
+ "exclusive": [
2980
+ "global"
2981
+ ],
2982
+ "name": "local",
2983
+ "allowNo": false,
2984
+ "type": "boolean"
2985
+ },
2986
+ "global": {
2987
+ "description": "Write user-level global config",
2988
+ "exclusive": [
2989
+ "local"
2990
+ ],
2991
+ "name": "global",
2992
+ "allowNo": false,
2993
+ "type": "boolean"
2994
+ },
2995
+ "project-id": {
2996
+ "description": "Respan project ID (added to metadata / resource attributes)",
2997
+ "env": "RESPAN_PROJECT_ID",
2998
+ "name": "project-id",
3188
2999
  "hasDynamicHelp": false,
3189
3000
  "multiple": false,
3190
3001
  "type": "option"
3191
3002
  },
3192
- "name": {
3193
- "description": "Customer name",
3194
- "name": "name",
3003
+ "base-url": {
3004
+ "description": "Respan API base URL (for enterprise deployments)",
3005
+ "name": "base-url",
3006
+ "default": "https://api.respan.ai/api",
3195
3007
  "hasDynamicHelp": false,
3196
3008
  "multiple": false,
3197
3009
  "type": "option"
3198
3010
  },
3199
- "email": {
3200
- "description": "Customer email",
3201
- "name": "email",
3011
+ "attrs": {
3012
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
3013
+ "name": "attrs",
3014
+ "default": "{}",
3202
3015
  "hasDynamicHelp": false,
3203
3016
  "multiple": false,
3204
3017
  "type": "option"
3205
3018
  },
3206
- "metadata": {
3207
- "description": "Metadata as JSON string",
3208
- "name": "metadata",
3019
+ "customer-id": {
3020
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
3021
+ "env": "RESPAN_CUSTOMER_ID",
3022
+ "name": "customer-id",
3209
3023
  "hasDynamicHelp": false,
3210
3024
  "multiple": false,
3211
3025
  "type": "option"
3026
+ },
3027
+ "span-name": {
3028
+ "description": "Root span name for traces (default: claude-code)",
3029
+ "name": "span-name",
3030
+ "hasDynamicHelp": false,
3031
+ "multiple": false,
3032
+ "type": "option"
3033
+ },
3034
+ "workflow-name": {
3035
+ "description": "Workflow name for traces (default: claude-code)",
3036
+ "name": "workflow-name",
3037
+ "hasDynamicHelp": false,
3038
+ "multiple": false,
3039
+ "type": "option"
3040
+ },
3041
+ "dry-run": {
3042
+ "description": "Preview changes without writing files",
3043
+ "name": "dry-run",
3044
+ "allowNo": false,
3045
+ "type": "boolean"
3212
3046
  }
3213
3047
  },
3214
3048
  "hasDynamicHelp": false,
3215
3049
  "hiddenAliases": [],
3216
- "id": "users:create",
3050
+ "id": "integrate:claude-code",
3217
3051
  "pluginAlias": "@respan/cli",
3218
3052
  "pluginName": "@respan/cli",
3219
3053
  "pluginType": "core",
@@ -3223,20 +3057,21 @@
3223
3057
  "relativePath": [
3224
3058
  "dist",
3225
3059
  "commands",
3226
- "users",
3227
- "create.js"
3060
+ "integrate",
3061
+ "claude-code.js"
3228
3062
  ]
3229
3063
  },
3230
- "users:get": {
3064
+ "integrate:codex-cli": {
3231
3065
  "aliases": [],
3232
- "args": {
3233
- "id": {
3234
- "description": "Customer identifier",
3235
- "name": "id",
3236
- "required": true
3237
- }
3238
- },
3239
- "description": "Get a specific user (customer)",
3066
+ "args": {},
3067
+ "description": "Integrate Respan with Codex CLI.\n\nInstalls a notify hook that reads session JSONL files and sends\nthem to Respan as structured spans (chat, tool, reasoning).\n\nScope:\n --global Install hook script + register notify in ~/.codex/config.toml\n --local Write .codex/respan.json with customer_id, span_name, etc.\n (default) Both: install hook globally + config for current project",
3068
+ "examples": [
3069
+ "respan integrate codex-cli",
3070
+ "respan integrate codex-cli --global",
3071
+ "respan integrate codex-cli --local --customer-id frank",
3072
+ "respan integrate codex-cli --attrs '{\"env\":\"prod\"}'",
3073
+ "respan integrate codex-cli --dry-run"
3074
+ ],
3240
3075
  "flags": {
3241
3076
  "api-key": {
3242
3077
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3271,11 +3106,81 @@
3271
3106
  "name": "verbose",
3272
3107
  "allowNo": false,
3273
3108
  "type": "boolean"
3109
+ },
3110
+ "local": {
3111
+ "description": "Write per-project config (default)",
3112
+ "exclusive": [
3113
+ "global"
3114
+ ],
3115
+ "name": "local",
3116
+ "allowNo": false,
3117
+ "type": "boolean"
3118
+ },
3119
+ "global": {
3120
+ "description": "Write user-level global config",
3121
+ "exclusive": [
3122
+ "local"
3123
+ ],
3124
+ "name": "global",
3125
+ "allowNo": false,
3126
+ "type": "boolean"
3127
+ },
3128
+ "project-id": {
3129
+ "description": "Respan project ID (added to metadata / resource attributes)",
3130
+ "env": "RESPAN_PROJECT_ID",
3131
+ "name": "project-id",
3132
+ "hasDynamicHelp": false,
3133
+ "multiple": false,
3134
+ "type": "option"
3135
+ },
3136
+ "base-url": {
3137
+ "description": "Respan API base URL (for enterprise deployments)",
3138
+ "name": "base-url",
3139
+ "default": "https://api.respan.ai/api",
3140
+ "hasDynamicHelp": false,
3141
+ "multiple": false,
3142
+ "type": "option"
3143
+ },
3144
+ "attrs": {
3145
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
3146
+ "name": "attrs",
3147
+ "default": "{}",
3148
+ "hasDynamicHelp": false,
3149
+ "multiple": false,
3150
+ "type": "option"
3151
+ },
3152
+ "customer-id": {
3153
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
3154
+ "env": "RESPAN_CUSTOMER_ID",
3155
+ "name": "customer-id",
3156
+ "hasDynamicHelp": false,
3157
+ "multiple": false,
3158
+ "type": "option"
3159
+ },
3160
+ "span-name": {
3161
+ "description": "Root span name for traces (default: claude-code)",
3162
+ "name": "span-name",
3163
+ "hasDynamicHelp": false,
3164
+ "multiple": false,
3165
+ "type": "option"
3166
+ },
3167
+ "workflow-name": {
3168
+ "description": "Workflow name for traces (default: claude-code)",
3169
+ "name": "workflow-name",
3170
+ "hasDynamicHelp": false,
3171
+ "multiple": false,
3172
+ "type": "option"
3173
+ },
3174
+ "dry-run": {
3175
+ "description": "Preview changes without writing files",
3176
+ "name": "dry-run",
3177
+ "allowNo": false,
3178
+ "type": "boolean"
3274
3179
  }
3275
3180
  },
3276
3181
  "hasDynamicHelp": false,
3277
3182
  "hiddenAliases": [],
3278
- "id": "users:get",
3183
+ "id": "integrate:codex-cli",
3279
3184
  "pluginAlias": "@respan/cli",
3280
3185
  "pluginName": "@respan/cli",
3281
3186
  "pluginType": "core",
@@ -3285,14 +3190,20 @@
3285
3190
  "relativePath": [
3286
3191
  "dist",
3287
3192
  "commands",
3288
- "users",
3289
- "get.js"
3193
+ "integrate",
3194
+ "codex-cli.js"
3290
3195
  ]
3291
3196
  },
3292
- "users:list": {
3197
+ "integrate:gemini-cli": {
3293
3198
  "aliases": [],
3294
3199
  "args": {},
3295
- "description": "List users (customers)",
3200
+ "description": "Integrate Respan with Gemini CLI.\n\nInstalls an AfterModel hook that captures LLM request/response data\nand sends it to Respan as structured spans with model, token counts,\nand input/output.\n\nScope:\n --global Write to ~/.gemini/settings.json (default)\n --local Write to .gemini/settings.json in project root\n\nNote: Gemini CLI ignores workspace-level telemetry settings, so\n--global is the default.",
3201
+ "examples": [
3202
+ "respan integrate gemini-cli",
3203
+ "respan integrate gemini-cli --local",
3204
+ "respan integrate gemini-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
3205
+ "respan integrate gemini-cli --dry-run"
3206
+ ],
3296
3207
  "flags": {
3297
3208
  "api-key": {
3298
3209
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3328,40 +3239,80 @@
3328
3239
  "allowNo": false,
3329
3240
  "type": "boolean"
3330
3241
  },
3331
- "limit": {
3332
- "description": "Number of results per page",
3333
- "name": "limit",
3334
- "default": 20,
3242
+ "local": {
3243
+ "description": "Write per-project config (default)",
3244
+ "exclusive": [
3245
+ "global"
3246
+ ],
3247
+ "name": "local",
3248
+ "allowNo": false,
3249
+ "type": "boolean"
3250
+ },
3251
+ "global": {
3252
+ "description": "Write user-level global config",
3253
+ "exclusive": [
3254
+ "local"
3255
+ ],
3256
+ "name": "global",
3257
+ "allowNo": false,
3258
+ "type": "boolean"
3259
+ },
3260
+ "project-id": {
3261
+ "description": "Respan project ID (added to metadata / resource attributes)",
3262
+ "env": "RESPAN_PROJECT_ID",
3263
+ "name": "project-id",
3335
3264
  "hasDynamicHelp": false,
3336
3265
  "multiple": false,
3337
3266
  "type": "option"
3338
3267
  },
3339
- "page": {
3340
- "description": "Page number",
3341
- "name": "page",
3342
- "default": 1,
3268
+ "base-url": {
3269
+ "description": "Respan API base URL (for enterprise deployments)",
3270
+ "name": "base-url",
3271
+ "default": "https://api.respan.ai/api",
3343
3272
  "hasDynamicHelp": false,
3344
3273
  "multiple": false,
3345
3274
  "type": "option"
3346
3275
  },
3347
- "sort-by": {
3348
- "description": "Sort field",
3349
- "name": "sort-by",
3276
+ "attrs": {
3277
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
3278
+ "name": "attrs",
3279
+ "default": "{}",
3350
3280
  "hasDynamicHelp": false,
3351
3281
  "multiple": false,
3352
3282
  "type": "option"
3353
3283
  },
3354
- "environment": {
3355
- "description": "Environment filter",
3356
- "name": "environment",
3284
+ "customer-id": {
3285
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
3286
+ "env": "RESPAN_CUSTOMER_ID",
3287
+ "name": "customer-id",
3357
3288
  "hasDynamicHelp": false,
3358
3289
  "multiple": false,
3359
3290
  "type": "option"
3291
+ },
3292
+ "span-name": {
3293
+ "description": "Root span name for traces (default: claude-code)",
3294
+ "name": "span-name",
3295
+ "hasDynamicHelp": false,
3296
+ "multiple": false,
3297
+ "type": "option"
3298
+ },
3299
+ "workflow-name": {
3300
+ "description": "Workflow name for traces (default: claude-code)",
3301
+ "name": "workflow-name",
3302
+ "hasDynamicHelp": false,
3303
+ "multiple": false,
3304
+ "type": "option"
3305
+ },
3306
+ "dry-run": {
3307
+ "description": "Preview changes without writing files",
3308
+ "name": "dry-run",
3309
+ "allowNo": false,
3310
+ "type": "boolean"
3360
3311
  }
3361
3312
  },
3362
3313
  "hasDynamicHelp": false,
3363
3314
  "hiddenAliases": [],
3364
- "id": "users:list",
3315
+ "id": "integrate:gemini-cli",
3365
3316
  "pluginAlias": "@respan/cli",
3366
3317
  "pluginName": "@respan/cli",
3367
3318
  "pluginType": "core",
@@ -3371,20 +3322,20 @@
3371
3322
  "relativePath": [
3372
3323
  "dist",
3373
3324
  "commands",
3374
- "users",
3375
- "list.js"
3325
+ "integrate",
3326
+ "gemini-cli.js"
3376
3327
  ]
3377
3328
  },
3378
- "users:update": {
3329
+ "integrate:opencode": {
3379
3330
  "aliases": [],
3380
- "args": {
3381
- "id": {
3382
- "description": "Customer identifier",
3383
- "name": "id",
3384
- "required": true
3385
- }
3386
- },
3387
- "description": "Update a user (customer)",
3331
+ "args": {},
3332
+ "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.",
3333
+ "examples": [
3334
+ "respan integrate opencode",
3335
+ "respan integrate opencode --global",
3336
+ "respan integrate opencode --project-id my-project --attrs '{\"env\":\"prod\"}'",
3337
+ "respan integrate opencode --dry-run"
3338
+ ],
3388
3339
  "flags": {
3389
3340
  "api-key": {
3390
3341
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3420,31 +3371,80 @@
3420
3371
  "allowNo": false,
3421
3372
  "type": "boolean"
3422
3373
  },
3423
- "name": {
3424
- "description": "Customer name",
3425
- "name": "name",
3374
+ "local": {
3375
+ "description": "Write per-project config (default)",
3376
+ "exclusive": [
3377
+ "global"
3378
+ ],
3379
+ "name": "local",
3380
+ "allowNo": false,
3381
+ "type": "boolean"
3382
+ },
3383
+ "global": {
3384
+ "description": "Write user-level global config",
3385
+ "exclusive": [
3386
+ "local"
3387
+ ],
3388
+ "name": "global",
3389
+ "allowNo": false,
3390
+ "type": "boolean"
3391
+ },
3392
+ "project-id": {
3393
+ "description": "Respan project ID (added to metadata / resource attributes)",
3394
+ "env": "RESPAN_PROJECT_ID",
3395
+ "name": "project-id",
3426
3396
  "hasDynamicHelp": false,
3427
3397
  "multiple": false,
3428
3398
  "type": "option"
3429
3399
  },
3430
- "email": {
3431
- "description": "Customer email",
3432
- "name": "email",
3400
+ "base-url": {
3401
+ "description": "Respan API base URL (for enterprise deployments)",
3402
+ "name": "base-url",
3403
+ "default": "https://api.respan.ai/api",
3433
3404
  "hasDynamicHelp": false,
3434
3405
  "multiple": false,
3435
3406
  "type": "option"
3436
3407
  },
3437
- "metadata": {
3438
- "description": "Metadata as JSON string",
3439
- "name": "metadata",
3408
+ "attrs": {
3409
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
3410
+ "name": "attrs",
3411
+ "default": "{}",
3412
+ "hasDynamicHelp": false,
3413
+ "multiple": false,
3414
+ "type": "option"
3415
+ },
3416
+ "customer-id": {
3417
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
3418
+ "env": "RESPAN_CUSTOMER_ID",
3419
+ "name": "customer-id",
3420
+ "hasDynamicHelp": false,
3421
+ "multiple": false,
3422
+ "type": "option"
3423
+ },
3424
+ "span-name": {
3425
+ "description": "Root span name for traces (default: claude-code)",
3426
+ "name": "span-name",
3427
+ "hasDynamicHelp": false,
3428
+ "multiple": false,
3429
+ "type": "option"
3430
+ },
3431
+ "workflow-name": {
3432
+ "description": "Workflow name for traces (default: claude-code)",
3433
+ "name": "workflow-name",
3440
3434
  "hasDynamicHelp": false,
3441
3435
  "multiple": false,
3442
3436
  "type": "option"
3437
+ },
3438
+ "dry-run": {
3439
+ "description": "Preview changes without writing files",
3440
+ "name": "dry-run",
3441
+ "allowNo": false,
3442
+ "type": "boolean"
3443
3443
  }
3444
3444
  },
3445
3445
  "hasDynamicHelp": false,
3446
3446
  "hiddenAliases": [],
3447
- "id": "users:update",
3447
+ "id": "integrate:opencode",
3448
3448
  "pluginAlias": "@respan/cli",
3449
3449
  "pluginName": "@respan/cli",
3450
3450
  "pluginType": "core",
@@ -3454,10 +3454,10 @@
3454
3454
  "relativePath": [
3455
3455
  "dist",
3456
3456
  "commands",
3457
- "users",
3458
- "update.js"
3457
+ "integrate",
3458
+ "opencode.js"
3459
3459
  ]
3460
3460
  }
3461
3461
  },
3462
- "version": "0.6.8"
3462
+ "version": "0.6.9"
3463
3463
  }