# open-cursor

- [open-cursor](/docs): Run Cursor subscription models from OpenCode.
- Getting started
  - [Installation](/docs/getting-started/installation): Install open-cursor and add the cursor-acp provider to OpenCode.
  - [Authentication](/docs/getting-started/authentication): Sign in through cursor-agent or configure the optional SDK backend.
  - [Quick start](/docs/getting-started/quick-start): Run a first prompt through cursor-acp and choose a Cursor model.
  - [Troubleshooting](/docs/getting-started/troubleshooting): Diagnose missing models, empty replies, tool failures, quota errors, and stream cutoffs.
- Guides
  - [Choosing a model](/docs/guides/choosing-a-model): Use Cursor's CLI model list, understand Auto, and keep model cost data current.
  - [MCP servers](/docs/guides/mcp-servers): Expose local OpenCode MCP servers to Cursor models through namespaced tools.
  - [Permissions](/docs/guides/permissions): Keep MCP and shell access inside the approval boundaries you intended.
  - [Session resume](/docs/guides/session-resume): Reuse cursor-agent chat IDs safely across turns, with the limits made explicit.
  - [Subagents](/docs/guides/subagents): Delegate through OpenCode's Task tool without crossing into Cursor's separate agent catalog.
- Reference
  - [Configuration](/docs/reference/configuration): Reference for every CURSOR_ACP environment variable and its default.
  - [CLI reference](/docs/reference/cli): Commands and flags provided by the open-cursor executable.
  - [opencode.json](/docs/reference/opencode-json): The provider, plugin, model, variant, and cost entries used by cursor-acp.
  - [Alternatives](/docs/reference/alternatives): Compare the main Cursor-to-OpenCode integration approaches and their trust boundaries.
  - [Roadmap](/docs/reference/roadmap): What is stable, what remains compatibility code, and what needs revalidation.
- Architecture
  - [Architecture overview](/docs/architecture/overview): How OpenCode requests cross the local proxy, Cursor runtime, and provider boundary.
  - [Stream translation](/docs/architecture/stream-translation): How cursor-agent deltas and snapshots become non-duplicated OpenAI SSE chunks.
  - [Tool loop](/docs/architecture/tool-loop): Who executes tools, how calls cross the provider boundary, and where the safety limits sit.
  - [ACP and MCP](/docs/architecture/acp-and-mcp): Why the current bridge remains in production and what must change before a thin ACP path replaces it.
  - [cursor-agent tools](/docs/architecture/cursor-agent-tools): Observed Cursor tool events, their OpenCode mappings, and the passthrough boundary.
- Development
  - [Building](/docs/development/building): Build and install open-cursor from a local checkout.
  - [Testing](/docs/development/testing): Run the focused, CI, integration, and packaging checks used by the project.
  - [Releasing](/docs/development/releasing): Validate, version, tag, publish, and verify the npm package.
  - [Contributing](/docs/development/contributing): Make a focused change, prove it at the right boundary, and keep the public surface coherent.