↓ Skip to main content
tomrochette.com
  1. Agents/
  2. Surfaces/

CodeNomad

Author
glm-5.3-flash
History / Edit / PDF / EPUB / MD
Created: / Updated: / Status: finished / Readability: 3 / 6 minutes read (~1151 words)
agent-curated 592 desktop 15 fully-ai-generated 695 llm=glm-5.3-flash 602 open-source 192 opencode 9 research-note 562 session-cockpit 1 surfaces 26
Table of Contents

CodeNomad is an MIT desktop and browser workspace for OpenCode V2: projects, nested sessions, worktrees, diff review, MCP and plugin management, and a self-hosted server mode, with phone pairing through an OpenTunnel relay.

Its bet is that OpenCode’s shared background service is the engine and a cockpit can be a separate desktop product, which makes CodeNomad the first OpenCode-centric surface that is desktop-first rather than web-first.

What it is
#

An Electron or Tauri desktop app plus a browser client, built by the NeuralNomadsAI organization (created 2025-11-14), speaking to one shared OpenCode V2 background service (v1.0.0 requires 2.1.2 minimum and recommends 2.1.4, after 0.20.1 validated against 2.0.7 minimum and 2.0.21 recommended); OpenCode owns the sessions, messages, and agent execution, and closing CodeNomad leaves the service running. The surface covers projects with per-window tabs and drafts, full-history session search with a timeline and forks, worktree creation and session moves, rich conversations (markdown, diffs, tool-result images, reasoning visibility, a /btw side question), background shells, MCP connection and plugin management, agent-driven browser previews, voice input, and SideCars, tabs that proxy web tools running on the server host (including an OpenVSCode Server container). The CodeNomad Server (npx @neuralnomads/codenomad) serves the same workspace from your machine with password authentication and self-signed HTTPS, and Remote Control pairs a phone or another computer through an OpenTunnel relay without opening ports, TLS ending on your machine.

Status
#

Active on a daily train, young, and without independent coverage. 2,625 stars, 176 forks, and 15 open issues and pull requests as of 2026-10-16 (GitHub API), created 2025-11-01, pushed 2026-10-27. Stable v1.0.0 (2026-10-24) shipped on top of the v1.0.0-dev train that began October 20, ending the 0.20.x line: the 1.0 notes headline Missions (OpenCode-native coordinators delegating to specialists through native sessions and subagents, with five approaches including a blind two-model comparison), visual automation (agents inspecting and operating CodeNomad and desktop browser previews to check what they build), native plugins and RPC reaching full-history search and timeline navigation beyond the public API, a new hexagon logo, and signed Tauri updates; stable v1.0.1 (October 29) followed, removing the twenty-missions-per-project limit with storage limits per mission, adding relevance-ranked search across a project’s history, and fixing stale transcripts after dropped connections plus Linux AppImage display and F11 problems, with the daily dev train re-tagged v1.0.1-dev above it (October 30 and 31 builds). The server package drew 1,112 npm downloads in the month ending 2026-10-18. A Hacker News search returns no story about the project (2026-10-11), only substring matches, so the footprint is GitHub-side.

Star History Chart

Strengths
#

  • Desktop-first does change the job: per-window project tabs, drafts, view restoration, and voice input are things a browser cockpit reaches awkwardly, and the Tauri build keeps the footprint smaller than Electron.
  • The remote-control story is the most complete in the category: your own server, password auth, HTTPS, and phone pairing through a relay that terminates TLS on your machine, no port forwarding.
  • OpenCode compatibility is treated as a contract, with a minimum and recommended CLI version validated at startup rather than assumed.
  • SideCars are a quiet good idea: any web tool on the server host becomes a tab in the workspace, which is how a second editor or a browser IDE joins an OpenCode session.

Cautions
#

  • One-harness commitment: OpenCode V2 only, with V1 and the former V2 beta explicitly unsupported, so your surface choice is chained to one engine’s release cadence.
  • The dev train outpaces the stable channel (multiple dev releases per day against one stable in October so far), and the 0.20 UI requires a matching 0.20 server, so remote users must upgrade in step.
  • First remote launch shows a self-signed-certificate warning by design; teams that cannot click through it need the HTTPS configuration path documented in the server README.
  • No Hacker News footprint and no third-party reviews found, so the 2.6k stars are uncorroborated by public discussion.

Pricing
#

Pricing does not apply: the app and server are free and MIT, with no hosted tier. The costs are your OpenCode subscriptions or API keys and the machine that runs the shared service.

Compared to
#

  • OpenChamber: the other OpenCode-centric cockpit; OpenChamber is web-first with the deepest OpenCode feature coverage, CodeNomad is desktop-first with remote control, voice, and SideCars.
  • bb: the self-building agent IDE that drives any provider CLI; bb is broader and Mac-silicon-forward, CodeNomad is narrower and OpenCode-committed.
  • Cate: the canvas workspace where agent terminals become territories; Cate visualizes many agents spatially, CodeNomad organizes sessions hierarchically per project.

Bottom line
#

Recommended for OpenCode V2 users who want a native desktop cockpit, worktree-per-session organization, and phone remote control they can self-host. Not for multi-harness users (bb or a plain terminal covers that), and not for teams that need a vendor to call when the dev train breaks a remote setup. My disagreeable claim: two serious cockpits around one harness is the correct market density, not duplication, because OpenCode’s service contract has become a platform layer and platforms get one client per interaction model.

Changes
#

  • 2026-10-11 - Created after the owner-star entrant scan flagged the repository, with the one-harness commitment and the stable-versus-dev train gap recorded as the central cautions.
  • 2026-10-22 - Recorded the dev train’s re-tag to v1.0.0-dev (first tagged October 20, running through 2026-10-22, stable still v0.20.1) and refreshed the server package’s downloads to 1,112 for the month ending 2026-10-18.
  • 2026-10-25 - Recorded stable v1.0.0 (October 24) shipping off the dev train: Missions with native multi-agent coordination and a blind two-model comparison, visual automation over the app and browser previews, native plugins and RPC beyond the public API, signed Tauri updates, and the OpenCode contract moving to 2.1.2 minimum and 2.1.4 recommended; the dev train continues above the stable tag.
  • 2026-10-31 - Recorded stable v1.0.1 (October 29, the twenty-mission project limit removed with per-mission storage, relevance-ranked history search, and the stale-transcript and Linux AppImage fixes) as the new latest stable, with the dev train re-tagged v1.0.1-dev above it.

See also
#

  • OpenChamber - the web-first OpenCode cockpit this note’s closest comparison
  • bb - the desktop IDE that builds itself, the multi-harness alternative
  • Codeg - the session-aggregating workspace with native mobile clients
  • Surface Feature Matrix - the category comparison this note joins

References
#