cargo-orchestration

Solid

Make Cargo actually run something, or show what it would run — execute one connector action, run a multi-step workflow, trigger a batch across a whole segment or model, message an AI agent, build or edit a node graph, draw a workflow, tool or play as a diagram, and query the runtime tables (runs, batches, spans, records) with SQL. Triggers: "run this on all my contacts", "execute the action", "kick off a batch", "build a workflow", "schedule a play", "make it run every morning", "ask the agent", "show me the workflow", "what does this tool do", "visualize this play", "draw the graph", "explain this workflow", "how many runs failed today", "what is the output schema for this action", "add a step that". Skip when: explaining why a run misbehaved — use cargo-diagnostics; downloading result files — use cargo-analytics; committing the workflow as code — use cargo-cdk.

AI & Automation 17 stars 3 forks Updated today MIT

Install

View on GitHub

Quality Score: 86/100

Stars 20%
42
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Cargo CLI — Orchestration Runtime operations for the Cargo platform. **What do you want to run?** ``` Need to run something? ├── Don't know the action yet → action list <keywords> ├── One action, one record → action execute ├── One action, many records → action execute-batch ├── Multiple actions chained │ ├── One-off / ad-hoc → run create --nodes (one record) │ │ batch create --nodes (many records) │ └── Reusable workflow → build a tool, then run create --workflow-uuid │ or batch create --workflow-uuid ├── Conversational AI agent → message create └── Testing ONE node of a workflow you're building → node execute (debug only — see below) ``` > **Fanning out across many records (`action execute-batch`, `batch create`)? Sample first.** Run 10–20 records, report the observed cost and hit-rate, then ask the user to approve the full enrollment — quoting the **record count** and the **credit estimate**. See [Create a batch → the sample gate](#the-sample-gate). > **Every node execution costs 0.01 credits — 1 credit per 100 — whatever the node is.** > `branch`, `filter`, `switch`, `variables` and the rest carry no provider price, but > they are not free: the charge is per *execution*, so a graph's cost has two terms, > `(provider cost × records) + (nodes × records ÷ 100)`. On step-heavy, action-light > graphs the second term dominates. It shows up in **no** per-node field...

Details

Author
getcargohq
Repository
getcargohq/cargo-skills
Created
6 months ago
Last Updated
today
Language
TypeScript
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

cargo-diagnostics

Explain what a Cargo run or batch actually did, after the fact — trace one run node by node, draw the graph it executed with the failing step marked, sweep a batch or play for errors grouped by root cause, and attribute credit spend down to the node and the provider. Triggers: "why did this fail", "it succeeded but the output is wrong", "half my rows are empty", "why is this column blank", "what broke in this batch", "why did that cost so much", "which node is burning credits", "it worked yesterday", "these results look wrong", "it went down the wrong path", "this step never ran", "show me what the run did". Skip when: setting up an alert for next time — use cargo-observability; just downloading the data — use cargo-analytics.

17 Updated today
getcargohq
AI & Automation Solid

cargo-billing

Understand what Cargo is costing — remaining credits, usage broken down by workflow, connector, or agent, subscription state, and invoice history. Triggers: "how many credits do I have left", "what did that cost", "why is my bill so high", "am I about to run out", "will this fit in our budget", "show me my invoices", "how much have I spent this month", "what plan am I on", "what do I get for free", "how many free credits", "can I afford this run", "add a card", "update my payment method", "why was my card declined". Needs a token with admin access. Skip when: attributing spend to specific nodes or cutting a play cost — use cargo-diagnostics.

17 Updated today
getcargohq
Data & Documents Solid

cargo-analytics

Get data out of Cargo and measure what ran — download a run output, export a segment or model to CSV or JSON, and pull run and batch success and error counts. Triggers: "download the results", "export this to CSV", "give me the file", "how many succeeded", "what is my error rate", "send me the enriched list", "get the output of that run", "how many records did it write". Skip when: asking why something failed or where credits went — use cargo-diagnostics; asking about credits, plans, or invoices — use cargo-billing.

17 Updated today
getcargohq