Skip to content

Commit 5850aa4

Browse files
committed
docs: update compatibility table with OpenCode limitations
- CodeWhale combo (TUI + exec) fully verified - OpenCode headless blocked by known upstream bugs (anomalyco/opencode#17516, #5888, #3213) - Recommended setup: CodeWhale supervisor + CodeWhale worker
1 parent 7f4f7e8 commit 5850aa4

1 file changed

Lines changed: 17 additions & 5 deletions

File tree

‎README.md‎

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -185,11 +185,23 @@ Three independent CodeWhale sessions, zero shared state except JSONL files on di
185185

186186
## Compatibility
187187

188-
| Client | Transport | Status |
189-
|---|---|---|
190-
| CodeWhale TUI | stdio MCP | ✅ Tested |
191-
| CodeWhale exec (headless) | stdio MCP | ✅ Tested |
192-
| OpenCode | HTTP/SSE MCP (`--port 9876`) | ✅ Ready |
188+
| Client | Inbox Protocol | Autonomous Worker | Notes |
189+
|---|---|---|---|
190+
| **CodeWhale TUI** | ✅ stdio MCP | ✅ Full supervisor | `inbox_send/poll/reply` native tools |
191+
| **CodeWhale exec** | ✅ stdio MCP | ✅ Full worker | `codewhale exec --auto` = `claude -p` |
192+
| **OpenCode TUI** | ✅ JSONL files | ❌ Manual only | MCP tools visible but headless `run` hangs |
193+
| **OpenCode run** | ⚠️ JSONL files | ❌ Blocked | See below |
194+
195+
### OpenCode limitations
196+
197+
OpenCode's headless mode (`opencode run`) has known issues that prevent autonomous worker operation:
198+
199+
- MCP tool calls cause the process to hang after completion ([anomalyco/opencode#17516](https://github.com/anomalyco/opencode/issues/17516))
200+
- `opencode serve` + `--attach` hangs even on simple prompts ([anomalyco/opencode#5888](https://github.com/anomalyco/opencode/issues/5888))
201+
202+
OpenCode TUI sessions can still participate in the inbox manually by reading/writing JSONL files directly. Full autonomous support depends on upstream fixes.
203+
204+
**Recommended setup**: CodeWhale as supervisor + CodeWhale `exec` as worker. This is the same pattern SeaShell uses with `claude -p` for Claude Code.
193205

194206
## Troubleshooting
195207

0 commit comments

Comments
 (0)