Cursor error
Cursor: Private worker limit exceeded
Private worker limit exceededStatus: By designLast verified 3 documented fixes2 sources
What it means
A Cloud Agent run on Self-Hosted Machines does not start because the team hit the connected worker cap.
Causes
- The connected self-hosted worker cap was reached: 200 per user, 1000 per team.
How to fix it
- Fix 1.
Disconnect unused workers, or contact sales to discuss higher limits.
- Fix 2.
Check capacity in the Cloud Agents dashboard or call the summary API, which returns connected and in-use worker counts for your user and team.
Terminalcurl --request GET \ --url "https://api.cursor.com/v0/private-workers/summary" \ -u "$CURSOR_API_KEY:" - Fix 3.
Run the worker preflight report for auth, connectivity, routing and backend visibility.
Snippetagent worker debug
More Cursor errors
All 18 Cursor errorsAgent Execution Timed OutStatus: WorkaroundTimeout waiting for EverythingProviderStatus: Workaround<filename> is too large (4MB limit)Status: By designCursor is damagedStatus: Workaroundsuspicious activityStatus: Workaroundxcrun: error: unable to find utility "mcpbridge"Status: Workaroundmissing tabIdentifierStatus: Workaround{"error": "Too Many Requests", "message": "Rate limit exceeded. Please try again later."}Status: By design
Related reading
- Do Your Agent Hooks Fail Open? Claude Code vs Codex vs Cursor vs Gemini CLIA guard hook that crashes, times out or points at a missing script lets the tool call through by default in Claude Code. v2.1.295 adds onFailure: block. Here is what each coding agent does when your policy hook breaks, with real test runs.
- How to Keep API Keys Away From Your AI Coding Agent: Claude Code vs Codex vs Cursor vs Gemini CLIA deny rule on .env stops cat but not a Python one-liner. Here are the three layers that actually keep secrets out of a coding agent's context - file rules, environment scrubbing and credential masking - and what Claude Code, Codex, Cursor and Gemini CLI give you for each, with real test runs.
- Antigravity vs Cursor (2026): Pricing, Limits, Models, and Which to PickAntigravity vs Cursor: Antigravity is free with a weekly limit; Cursor starts at $20/month with the widest model menu. Pricing, limits and a decision guide.
- Slack Code vs Claude Code vs Cursor vs OpenCode: When Agents Belong in ChatSlack Code gives coding agents their own Slack channels with diffs, previews, and an audit log. When it beats Claude Code, Cursor, or OpenCode, and when not.
- Cursor Removes Dollar Costs From Usage Page: Tokens OnlyCursor removed dollar costs from its Usage page on July 31: self-serve plans see tokens only and the dashboard API zeroes cost fields, history included.
- AI Coding Agent Security Models Compared 2026: Permissions, Sandboxing, and Threat Models for Every Major ToolAI coding agent security models compared: how Claude Code, Cursor, Codex, Copilot, Aider and Windsurf handle permissions, sandboxing and prompt injection.
FAQ
What does "Private worker limit exceeded" mean in Cursor?
A Cloud Agent run on Self-Hosted Machines does not start because the team hit the connected worker cap.
How do I fix "Private worker limit exceeded"?
There are 3 documented fixes. Start with the first: Disconnect unused workers, or contact sales to discuss higher limits.
Is this Cursor error fixed?
Status: By design. Expected behavior, not a bug. The documented fixes change the setup that triggers it.
Sources
Last verified against 2 sources: official docs, maintainer replies and release notes.
Newsletter
Fixes for the tools you use, weekly
One email per week. New coding agent releases, what broke, and how developers are working around it.