cargo-cli-analytics

Download and analyze Cargo workflow run metrics and segment exports.

15|3|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/getcargohq/cargo-skills --skill cargo-cli-analytics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cargo-cli-analytics
Source: https://github.com/getcargohq/cargo-skills/tree/main/cargo-cli-analytics
Command: npx skills add https://github.com/getcargohq/cargo-skills --skill cargo-cli-analytics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Helps operators and analysts quickly retrieve, inspect, and export Cargo workflow run results and segment data so they can monitor success/error rates, diagnose failures, and produce reports without manually piecing together CLI output.

Core Features & Use Cases

  • Run metrics & error monitoring: Query per-node success and error counts, compute error rates, and scope metrics to releases, batches, or date ranges.
  • Data export & downloads: Download finished run payloads, batch node outputs, and full segment exports for downstream analysis or debugging.
  • Failure triage: Count and retrieve only error runs, inspect batch summaries, and re-run failed records after remediation.
  • Use Case: An analyst detects an increase in errors for a workflow, counts error runs in the last 24 hours, downloads the error payloads for investigation, and exports the affected segment for cross-referencing.

Quick Start

Download finished runs for a workflow UUID and summarize per-node error rates for troubleshooting.

Frequently Asked Questions about cargo-cli-analytics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download workflow run results and segment exports from Cargo?

To download workflow run results and segment exports from Cargo, use this Skill to query finished run payloads, batch node outputs, and full segment data. Commands return JSON format and support filters like --workflow-uuid and --batch-uuid for targeted data retrieval.

Can I monitor workflow run metrics and count error rates for specific batches?

Yes, you can monitor workflow run metrics and count error rates per node. This Skill queries success and error counts, computes error rates, and scopes metrics to specific releases, batches, or date ranges using filters like --statuses and --created-after.

What's the best way to triage workflow failures and retrieve error payloads?

The best way to triage workflow failures is to count and retrieve only error runs using status filters, inspect batch summaries, and download the error payloads for investigation. This Skill supports filtering to isolate failed records for remediation and re-running.

Do I need a specific environment to export Cargo segment data and run metrics?

Yes, exporting Cargo segment data and run metrics requires the @cargo-ai/cli installed and a valid Cargo API token with workspace access. This Skill relies on these prerequisites to execute commands and return JSON output for downstream analysis.

Why are my Cargo workflow run downloads not returning expected batch data?

Cargo workflow run downloads may not return expected batch data if filters like --batch-uuid, --workflow-uuid, or --created-after are misconfigured. This Skill scopes queries precisely; verify your UUIDs and date ranges to ensure correct payload retrieval.

Does cargo-cli-analytics support querying run metrics by date range?

Yes, cargo-cli-analytics supports querying run metrics by date range. You can use the --created-after filter to scope per-node success and error counts to specific timeframes, enabling targeted monitoring and troubleshooting of recent workflow activity.