feat: Adds support for Cursor provider and other ACP backends by aweis89 · Pull Request #5095 · anomalyco/opencode

aweis89 · 2025-12-05T03:00:14Z

Summary

While ACP is already supported for custom IDE integrations (IDE/ACP-> OpenCode -> LLM), this adds support to use ACP as a backend LLM provider (OpenCode -> ACP)
Enables OpenCode to consume tokens from Cursor CLI for example while still using the regular OpenCode TUI.
This is useful for folks who have Cursor subscriptions for example, but want to use OpenCode's (amazing!) TUI
By enabling ACP as a backend provider, we don't need a uniq translation layer for OpenCode to multiple CLI backends

Resolves

Closes[FEATURE]: CLI Providers #3735 - CLI Providers feature request
ClosesSupport for Cursor? #2072 - Support for Cursor CLI
ClosesAllow using Gemini CLI for free Gemini requests #402 - Gemini CLI support for free tier access
Closes[FEATURE]: TUI as an ACP Client #5182

Implementation Details

Core Components

ACPClient (client.ts) - Manages subprocess lifecycle and ACP protocol communication
ACPLanguageModel (model.ts) - Implements LanguageModelV2 interface with streaming support
Message Converters (converters.ts) - Bidirectional conversion between Vercel AI SDK and ACP message formats
MCP Converter (mcp-converter.ts) - Converts OpenCode MCP configurations to ACP format
Provider Factory (factory.ts) - Creates ACP provider instances from configuration

Key Features

Full streaming support for real-time responses
Tool execution, passes along MCP servers, which are executed by the ACP
MCP server integration - OpenCode MCP servers exposed to ACP backends
Proper subprocess lifecycle management and cleanup
Comprehensive error handling

Testing

Tested with cursor-agent integration
Verified streaming responses
Confirmed MCP server exposure to ACP backend

Documentation

Added comprehensive README.md with setup instructions
Includes configuration examples for cursor-agent, goose, and gemini-cli
Documents architecture and design decisions

rekram1-node · 2025-12-05T03:19:59Z

we already have acp support, whats this for

aweis89 · 2025-12-05T03:34:53Z

we already have acp support, whats this for

This is for an ACP backend provider. For example, if you have a cursor account, and you want to use Opencode TUI's interface, but you want it to use cursor CLI agent as it's backend LLM:

Right now we have: IDE via ACP -> OpenCode -> LLM Provider
With this change you can now do: OpenCode -> Cursor CLI via ACP
The ACP becomes the LLM provider as apposed to the frontend interface.
This is useful for folks who want to use OpenCode but already have a subscription for cursor.
They can now use OpenCode while comsuming their tokens from Cursor

rekram1-node · 2025-12-05T03:46:54Z

okay i see

aweis89 · 2025-12-05T21:54:17Z

okay i see

Been using this all morning. It's pretty awesome to be able to use my Cursor subscription with OpenCode's best-in-class TUI!

Implemented a Proxy for the tools record when an ACP provider is active. This dynamically provides pass-through tool definitions for unknown tool calls, allowing them to be correctly proxied to the ACP.

aweis89 · 2025-12-21T04:29:23Z

aweis89 · 2025-12-21T04:30:31Z

Any chance this is something we can merge @rekram1-node?

jensenojs · 2025-12-25T08:41:07Z

same ask here

Resolved conflicts in: - transform.ts: Added @ai-sdk/google-vertex fall-through case while keeping ACP context logic - llm.ts: Merged ACP tool/jsonSchema imports with extractReasoningMiddleware from dev

Nasseratic · 2026-01-02T20:00:28Z

Awesome work @aweis89 ❤️

NazmiAltun · 2026-01-05T02:46:02Z

@rekram1-node any plans to have this feature ?

Removed future enhancements section from README.

oraclian94 · 2026-01-12T02:09:00Z

I hope this PR gets merged soon!

- update normalization to handle 'path' for both read and edit tools

Treat wrapped "ConnectError: ... ECONNRESET" (common via ACP subprocess backends) as retryable by unwrapping cause/message, and add a regression test.

LeonMueller-OneAndOnly · 2026-01-16T06:25:56Z

Here is another interesting approach for getting cursor to work in opencode

https://github.com/R44VC0RP/cursor-opencode-auth

aweis89 · 2026-01-18T19:09:39Z

Here is another interesting approach for getting cursor to work in opencode
https://github.com/R44VC0RP/cursor-opencode-auth

Were you able to get this working?

rekram1-node · 2026-01-18T22:22:20Z

It's super cool what you've made but unfortunately this isn't something we have bandwidth to maintain at the moment, this may be better suited to be written as a plugin, if you did make one we are happy to add to ecosystem page

Nomadcxx · 2026-01-19T03:59:34Z

This isn't something we have bandwidth to maintain at the moment, this may be better suited to be written as a plugin

Noooooooooo

kaan-zeroday · 2026-01-19T08:23:02Z

@aweis89 Can you publish as plugin?

oraclian94 · 2026-01-20T01:10:04Z

Noooooooooo!!!!

aweis89 · 2026-01-22T19:48:31Z

I've been using this recently published plugin lately and it actually works quite well

RespectMathias · 2026-03-19T10:38:12Z

Upvoting this. These Oauth plugins aren't the solution due to TOS. Would love ACP Client support for OpenCode. Especially since it is also a desktop app now.

MRDGH2821 · 2026-03-29T10:51:18Z

Would be really cool if this gets revived!

Also https://x.com/leerob/status/2034788399249244604

rekram1-node force-pushed the dev branch from 398b39a to 5013d64Compare December 5, 2025 05:13

aweis89 force-pushed the enable-acp branch from ae4bd70 to 8c83a41Compare December 5, 2025 21:17

aweis89 changed the title ~~feat: Add ACP (Agent Client Protocol) provider support~~feat: Adds support for Cursor provider and other ACP backendsDec 5, 2025

aweis89 force-pushed the enable-acp branch 3 times, most recently from 8641762 to d94185fCompare December 7, 2025 06:26

aweis89 force-pushed the enable-acp branch from 537f601 to 86f396aCompare December 15, 2025 03:16

feat: adds support for backed ACP provider
a3d0747

aweis89 force-pushed the enable-acp branch from 1385d03 to a3d0747Compare December 16, 2025 21:16

aweis89 added 5 commits December 18, 2025 21:09

Merge branch 'dev' into enable-acp
8fb9d82

fix: allow unknown tool calls for ACP providers
d89f726
Implemented a Proxy for the tools record when an ACP provider is active. This dynamically provides pass-through tool definitions for unknown tool calls, allowing them to be correctly proxied to the ACP.

Merge branch 'dev' into enable-acp
c0e24b4

Merge branch 'dev' into enable-acp
a526bf8

Merge branch 'dev' into enable-acp
9f11771

Merge branch 'dev' into enable-acp
eb2b941

aweis89 force-pushed the enable-acp branch from 80a55e8 to eb2b941Compare December 31, 2025 04:04

aweis89 added 4 commits December 30, 2025 23:07

chore: merge dev branch to resolve conflicts
4423aaf
Resolved conflicts in: - transform.ts: Added @ai-sdk/google-vertex fall-through case while keeping ACP context logic - llm.ts: Merged ACP tool/jsonSchema imports with extractReasoningMiddleware from dev

Merge branch 'dev' into enable-acp
e57e42e

Merge branch 'dev' into enable-acp
4f88fb4

Merge branch 'dev' into enable-acp
64a8429

Merge branch 'dev' into enable-acp
40f6535

aweis89 added 9 commits January 9, 2026 09:35

remove hardcoded version number in acp client.ts
5fd21c3

better error handling for permission denials
517326c

remove entire model list for ACP provider in opencode.jsonc
1ae1451

use promise instead of polling to wait for pending notifications
5ef010f

Update README to remove future enhancements
ac85fca
Removed future enhancements section from README.

add types for ACP tool results and improve logging
16d2418

revert unecessary await
1cf04d7

document addinng type: acp to ACP provider README.md
01d2a93

Merge branch 'dev' into enable-acp
a174e0c

fix(acp): normalize tool input field names for edit tool
18250d4
- update normalization to handle 'path' for both read and edit tools

aweis89 force-pushed the enable-acp branch from 4663ba3 to 18250d4Compare January 14, 2026 02:37

Merge branch 'dev' into enable-acp
7514c0d

github-actionsBot mentioned this pull request Jan 14, 2026
feat(tui): add username and password options for basic authentication for TUI attach #8459
Closed

Retry wrapped ECONNRESET errors
4962e64
Treat wrapped "ConnectError: ... ECONNRESET" (common via ACP subprocess backends) as retryable by unwrapping cause/message, and add a regression test.

aweis89 added 3 commits January 16, 2026 11:35

Merge remote-tracking branch 'upstream/dev' into enable-acp
c874f9a

Merge remote-tracking branch 'upstream/dev' into enable-acp
0d0ed1a

Merge upstream/dev into enable-acp
9a0fe56

aweis89 closed this Jan 22, 2026

b1rdex mentioned this pull request Jan 24, 2026
[FEATURE]:Support Augment code #10216
Closed
1 task

MRDGH2821 mentioned this pull request Apr 7, 2026
Support for Cursor? #2072
Open

Uh oh!

Conversation

aweis89 commented Dec 5, 2025• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Resolves

Implementation Details

Core Components

Key Features

Testing

Documentation

Uh oh!

rekram1-node commented Dec 5, 2025

Uh oh!

aweis89 commented Dec 5, 2025• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

rekram1-node commented Dec 5, 2025

Uh oh!

aweis89 commented Dec 5, 2025

Uh oh!

aweis89 commented Dec 21, 2025

Uh oh!

aweis89 commented Dec 21, 2025

Uh oh!

jensenojs commented Dec 25, 2025

Uh oh!

Nasseratic commented Jan 2, 2026

Uh oh!

NazmiAltun commented Jan 5, 2026

Uh oh!

oraclian94 commented Jan 12, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

LeonMueller-OneAndOnly commented Jan 16, 2026

Uh oh!

aweis89 commented Jan 18, 2026

Uh oh!

rekram1-node commented Jan 18, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Nomadcxx commented Jan 19, 2026

Uh oh!

kaan-zeroday commented Jan 19, 2026

Uh oh!

oraclian94 commented Jan 20, 2026

Uh oh!

aweis89 commented Jan 22, 2026

Uh oh!

RespectMathias commented Mar 19, 2026

Uh oh!

MRDGH2821 commented Mar 29, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

20 participants

aweis89 commented Dec 5, 2025•
edited
Loading

aweis89 commented Dec 5, 2025•
edited
Loading

oraclian94 commented Jan 12, 2026•
edited
Loading

rekram1-node commented Jan 18, 2026•
edited
Loading