11# OpenCode API Compatibility Checklist
22
33This document tracks the implementation status of OpenCode-compatible API endpoints.
4- Last audited against OpenCode source: ** 2026-02 -24**
4+ Last audited against OpenCode source: ** 2026-03 -24**
55
66## Status Legend
77- [ ] Not implemented
@@ -20,6 +20,7 @@ Last audited against OpenCode source: **2026-02-24**
2020| [ x] | GET | ` /global/config ` | Get global configuration |
2121| [ x] | PATCH | ` /global/config ` | Update global configuration |
2222| [ x] | POST | ` /global/dispose ` | Dispose all instances |
23+ | [ ~ ] | POST | ` /global/upgrade ` | Upgrade opencode (stub - not applicable) |
2324
2425---
2526
@@ -29,6 +30,7 @@ Last audited against OpenCode source: **2026-02-24**
2930| --------| --------| ------| -------------|
3031| [ x] | GET | ` /project ` | List all projects |
3132| [ x] | GET | ` /project/current ` | Get the current project |
33+ | [ x] | POST | ` /project/git/init ` | Initialize git repository |
3234| [ x] | PATCH | ` /project/{projectID} ` | Update project (name, icon, commands) |
3335| [ x] | GET | ` /path ` | Get the current path |
3436| [ x] | GET | ` /vcs ` | Get VCS info for current project |
@@ -174,7 +176,7 @@ Last audited against OpenCode source: **2026-02-24**
174176
175177---
176178
177- ## Worktrees (Experimental)
179+ ## Worktrees & Workspaces (Experimental)
178180
179181| Status | Method | Path | Description |
180182| --------| --------| ------| -------------|
@@ -193,12 +195,20 @@ Last audited against OpenCode source: **2026-02-24**
193195| Status | Method | Path | Description |
194196| --------| --------| ------| -------------|
195197| [ x] | GET | ` /lsp ` | Get LSP server status |
196- | [ x] | POST | ` /lsp/start ` | Start an LSP server |
197- | [ x] | POST | ` /lsp/stop ` | Stop an LSP server |
198- | [ x] | GET | ` /lsp/servers ` | List available LSP servers |
199- | [ x] | GET | ` /lsp/diagnostics ` | Get LSP diagnostics (CLI-based) |
200198| [ x] | GET | ` /formatter ` | Get formatter status (stub) |
201199
200+ ### AgentPool Extensions (commented out, not in upstream OpenCode)
201+
202+ These routes were agentpool-specific extensions. OpenCode handles diagnostics
203+ internally via tool call results, not HTTP endpoints.
204+
205+ | Status | Method | Path | Description |
206+ | --------| --------| ------| -------------|
207+ | [ -] | POST | ` /lsp/start ` | Start an LSP server (commented out) |
208+ | [ -] | POST | ` /lsp/stop ` | Stop an LSP server (commented out) |
209+ | [ -] | GET | ` /lsp/servers ` | List available LSP servers (commented out) |
210+ | [ -] | GET | ` /lsp/diagnostics ` | Get LSP diagnostics (commented out) |
211+
202212---
203213
204214## MCP
@@ -416,3 +426,15 @@ _PARAM_NAME_MAP = {
416426 " line_hint" : " lineHint" ,
417427}
418428```
429+
430+ ---
431+
432+ ## Notes
433+
434+ - ** Diagnostics** : OpenCode does NOT expose diagnostics via HTTP routes. Diagnostics are
435+ handled internally — LSP servers push them to in-process clients, and tools (` write ` ,
436+ ` edit ` , ` apply_patch ` ) include them in their return metadata after file operations.
437+ - ** LSP extensions** : The ` /lsp/start ` , ` /lsp/stop ` , ` /lsp/servers ` , ` /lsp/diagnostics `
438+ routes are agentpool extensions commented out in ` lsp_routes.py ` .
439+ - ** Upgrade** : The ` /global/upgrade ` route is stubbed since it's not applicable to agentpool.
440+ - ** Git init** : The ` /project/git/init ` route is stubbed — could be implemented later.
0 commit comments