Skip to content

docs(assistant): improve socat lmstudio breadcrumb - #416

Merged
itlackey merged 1 commit into
release/0.11.0from
worktree-agent-a4a1aac27d330cb5f
May 15, 2026
Merged

itlackey merged 1 commit into
release/0.11.0from
worktree-agent-a4a1aac27d330cb5f

Conversation

@itlackey

Copy link
Copy Markdown
Owner

Outcome of investigating the deferred socat lmstudio workaround

PR #411 left a TODO to drop the socat lmstudio proxy when OpenCode upstream lifts the hardcoded baseURL restriction. This PR is the result of investigating that.

Verdict: cannot remove yet

OpenCode versions checked: `1.2.24`, `1.3.3` (current pin), `1.14.50` (latest as of 2026-05-14). All three still hardcode `http://127.0.0.1:1234/v1\` in the lmstudio provider catalog entry.

OpenCode supports overriding the baseURL via the singular `provider` config key in `opencode.json`, but does NOT read an env var for it. Writing into `opencode.json` from the entrypoint would violate OpenPalm's "never overwrite user files" principle, so the socat workaround stays.

What this PR changes

Just the inline comment in `core/assistant/entrypoint.sh` `maybe_proxy_lmstudio`. The breadcrumb now records:

  • Versions verified + date of last check
  • The actual override mechanism (`provider` config key) and why we don't use it
  • The missing piece (env-var override)
  • Link to related upstream issue anomalyco/opencode#1555
  • TODO to file a fresh upstream issue requesting env-var override

When OpenCode adds env-var override and we bump to that version, `maybe_proxy_lmstudio` and the `socat` apt-get dependency can be deleted in one PR.

Test plan

Comment-only change; no behavior modified.

Verified across OpenCode 1.2.24, 1.3.3 (current pin), and 1.14.50 (latest):
- Hardcoded baseURL http://127.0.0.1:1234/v1 still present in models.dev catalog
- OpenCode supports `provider` (singular) config key to override but no env var
- Writing to opencode.json from entrypoint would violate "never overwrite user files"

Comment now records:
- Versions verified + date
- Pointer to upstream provider.ts mergeProvider for the override path
- Why env-var override is the missing piece
- Link to related upstream issue anomalyco/opencode#1555
- TODO to file a fresh issue requesting env-var override

When OpenCode adds env-var override, this whole function + the socat apt-get
dependency in the Dockerfile can be deleted.

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
@itlackey
itlackey force-pushed the worktree-agent-a4a1aac27d330cb5f branch from fba00f4 to 603f24a Compare May 15, 2026 01:00
@itlackey
itlackey merged commit 3fd93f6 into release/0.11.0 May 15, 2026
3 checks passed
@itlackey
itlackey deleted the worktree-agent-a4a1aac27d330cb5f branch May 15, 2026 01:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant