docs/guides/cloud-agents/when-to-use-cloud-agents.mdx
This guide helps you decide whether cloud agents are the right abstraction for your problem.
<Tip> Use cloud agents when the work is **recurring**, spans **multiple systems**, and needs **team-owned outcomes**. If you want the canonical definition and taxonomy first, read: [Cloud Agents Taxonomy](/guides/cloud-agents/cloud-agents-taxonomy). </Tip>Use cloud agents when:
- security remediation
- recurring error triage
- dependency hygiene
- analytics-driven fixes
Avoid cloud agents when:
| Feature | Scripts / CI Jobs | Local Agents (TUI) | Cloud Agents (Headless) |
|---|---|---|---|
| Logic | Deterministic (If/Then) | AI / Probabilistic | AI / Probabilistic |
| Context | Inputs only | Full Repo + User Chat | Repo + Integrations (Snyk/GitHub/etc.) |
| Interaction | None (Logs only) | Interactive (Conversations) | Autonomous (Fire & Forget) |
| Tool Access | Unlimited | All (Ask permission supported) | Safe (No "Ask" tools) |
| Best For | Testing, Building, Linting | Debugging, Refactoring, Exploration | Triage, Remediation, Reporting |
Use cloud agents if you can say “yes” to most of these: