# Cursor Errors

> CursorAgentError class hierarchy, isRetryable, and recovery patterns. Use when classifying SDK failures, building retry logic, or surfacing actionable messages.

- Skill: `hktitan/cursor-errors` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add hktitan/cursor-errors`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hktitan/cursor-errors/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: HKTITAN (https://skillmd.com/u/hktitan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hktitan/cursor-errors

---


# cursor-errors

Every SDK throw is a `CursorAgentError` (or subclass). The `isRetryable` flag is your routing decision: retry transient errors, surface terminal ones.

## Base class

- [[references/cursor-agent-error]] — `isRetryable`, `code`, `cause`, `protoErrorCode`

## Subclasses

- [[references/auth-error]] — `AuthenticationError`
- [[references/rate-limit]] — `RateLimitError`
- [[references/configuration]] — `ConfigurationError`
- [[references/integration-not-connected]] — `IntegrationNotConnectedError`
- [[references/network]] — `NetworkError`
- [[references/unknown-agent]] — `UnknownAgentError`
- [[references/unsupported-op]] — `UnsupportedRunOperationError`

## Patterns

- [[references/retry-pattern]] — backoff using `isRetryable`
- [[references/schema-stability]] — defensive parsing of tool call args/result

## Cross-links

- Run status terminal-error vs throw — [[../cursor-runs/references/wait]]
- Operation gating — [[../cursor-runs/references/operation-support]]