anomalyco / anomalyco/opencode

[FEATURE]: Integrate opencode serve as a first-class monitor mode in the desktop client

Open
#46,154 2 comments 2 reactions 1 assignee View on GitHub

@Brendonovich is already working on this.

Since Aug 29, 2026.

Dominant language
TypeScript
Stars
209k
Forks
27.5k
PR merge metrics
PR metrics pending

Description

Summary

  • I have searched for existing issues before filing this

Integrate opencode serve as a first-class, optional monitor/mode within the OpenCode desktop client — so users can serve their local instance to mobile or other devices without running a separate sidecar process.


Problem

Today, opencode serve must be run as a separate process alongside the desktop client. This creates:

  1. Mobile access friction — users who want OpenCode on their phone/tablet must set up serve as a sidecar, manage auth, port forwarding, and reverse proxy manually
  2. Fragmented UX — "Run OpenCode" and "Serve OpenCode" are two separate mental models; most users don't discover serve exists
  3. Half-baked integrations — plugins like neohiro/mobile-sync exist to fill this gap but are inherently limited because serve was never an integrated feature
  4. No unified session/project sharingserve as a sidecar doesn't carry OpenCode's session context naturally between devices

Proposed Solution

Add a "Serve Mode" toggle in the desktop client:

Status Popover → [ ] Enable Serve
┌─ Serve Settings ──────────────────┐
│ Port:     [ 18792 ]              │
│ Auth:     [x] Require password  │
│ Network:  ( ) Local only         │
│           (•) Accessible LAN     │
│           ( ) Public (Tunnel)   │
│ Password: [ ••••••••••••••••• ] │
└──────────────────────────────────┘

Behavior:

  • Serve starts/stops within the same OpenCode process
  • Session and project context is shared naturally (same process)
  • Auth is integrated with the client's auth system
  • Client shows a "Serving" indicator with URL and QR code
  • Future: built-in tunneling for true mobile access

Related Issues

Related Issue Topic This Issue
#19078 serve ignores configuration Making serve a built-in client feature
#14445 serve base directory security Same underlying serve, different ask
#43039 no-password flag for serve Auth UX in the integrated panel
#44640 require auth for non-loopback binds Secure-by-default in the integrated panel
#32932 serve doesn't release port on exit Should be fixed in integrated mode
#43110 generic ServeError on Windows Better error UX in integrated panel

OS

Primarily Windows and macOS (desktop use case). All platforms benefit.


🦙 Creative Monkey at FrenzyPenguin Media — open-source security hardening & privacy tools

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.