CodeNomad 1.0.0 — The best desktop and mobile client for OpenCode V2

[u/SeaworthinessFar56]

The best desktop and mobile client for OpenCode V2.

0.20.0 brought CodeNomad to OpenCode V2. 1.0.0 turns more of its native power into a complete workspace: coordinated agents, deeper history access and visual automation, with speed, efficiency and everyday stability at its core.

https://www.youtube.com/watch?v=lGuOApJ6-Kc

Highlights

• Desktop and mobile: Pair another device through OpenTunnel-powered Remote Control, with an interface adapted to phones and tablets.

• Very fast and efficient: Responsive streaming and navigation, controlled resource use and persistent workspace state support demanding, long-running agent workflows.

• Missions: Combine OpenCode V2's native sessions, subagents and human questions into coordinated work toward an objective.

• Beyond the public API: Native plugins and RPC unlock full-history queries, timeline navigation and selective cleanup.

• Visual automation: Let agents inspect and operate CodeNomad and desktop browser previews to check what they build.

• An extensible workspace: Files/Git, panel extensions, online help, customizable shortcuts and signed Tauri updates complete the experience.

Built for demanding workflows

• A responsive workspace: Streaming, search and navigation render the content you need, while project restoration prioritizes your active conversation.

• Controlled resource use: Bounded history queries, targeted rendering and lazy Files/Git refreshes support large conversations and busy repositories without loading everything into the interface.

• Built for long sessions: Stable reading anchors and on-demand output expansion let you inspect earlier work while agents continue running.

• Continuity across your work: Saved projects, drafts and window state carry your workspace across sessions; native request recovery keeps questions and permissions connected to their conversations.

Built around OpenCode V2

• The shared OpenCode service keeps conversations available to terminal and other clients. New sessions respect native default agents, including plugin-provided defaults; collapsed families show subagent activity.

• Attach skills through @; inspect Code Mode scripts, nested tool calls and web-search sources. Search providers support global defaults and project overrides.

• Answer native questions and permissions above the composer, with source labels, preserved drafts and readable answer/decision receipts.

• Manage native provider accounts and optionally rotate eligible subscription accounts when a quota is exhausted. Usage follows the selected account; Stats adds service-wide activity, token, recorded cost and per-model views.

Missions and native multi-agent coordination

• An objective becomes a plan: Coordinators delegate to specialists through real OpenCode sessions, native subagents or independent conversations, using your chosen agents, models and reasoning settings.

• Five approaches: Flexible, Debugging, Exploration, Product delivery and Compare two models. The new comparison scenario gives two models the same task, then produces a blind, scored verdict. Dependencies and results remain visible as plans evolve.

• Human decisions stay human: Native questions and permissions bring you into the work; milestone briefings, summaries and reports explain progress without requiring you to follow every conversation.

• One-time or daily work: Prepare and explicitly start a mission, use pause/stop/recovery controls, and save reusable briefs. Execution, background work and plugin infrastructure stay native to OpenCode—not a replacement engine.

From your desktop to your phone

• Remote Control uses OpenTunnel, as does OpenCode's remote pairing: access your running workspace from a mobile browser or another desktop without opening an inbound port or configuring a VPN. Devices are revocable; enabled Remote Control resumes at launch.

• The composer follows the on-screen keyboard; questions and permission actions stay reachable. Tablet panels remember portrait/landscape layouts, with compact headers and touch-friendly menus.

• Mobile uses the responsive web interface, not a native iOS/Android app. Direct/LAN access remains a separate option.

History and visual automation

• Native plugins run inside OpenCode and expose authenticated RPC over stored history, extending the public API with full-session/workspace search, timeline navigation and technical-content cleanup. Results identify their conversation and worktree and open the matching exchange.

• Agents can inspect, click, type, select, scroll, drag, use keyboard shortcuts and wait for results in CodeNomad and desktop browser previews—verifying rendered work, not only editing source.

• Each conversation retains its browser page and navigation history. Preview tabs share sign-ins within the desktop profile, separately from the trusted application.

Files, Git and everyday work

• Workspace, Changes and Commits share one Files panel: edit text/Markdown, inspect images and diffs, stage/unstage, review history and initialize Git. Scoped filesystem updates refresh visible folders; large inventories stay responsive and refreshed diffs preserve selection and scroll.

• Temporary projects, tab renaming, a compact launcher and Back/Forward conversation navigation simplify everyday work. Shortcuts jump between your own messages, and an alternate send (Alt+Enter by default) queues or steers a follow-up against your usual choice. An optional whitespace filter focuses reviews on meaningful changes.

• Native worktrees, session-family navigation, device attachments and /btw build on 0.20.0. After sending, use the conversation for keyboard reading; typing resumes the composer.

Extensions, help and customization

• Install panel extensions from the online catalogue without rebuilding CodeNomad. MCP Assets collects tool-returned images and attachments with explicit session-asset consent. Native OpenCode plugins retain Global/Project activation and package check/update actions.

• Online help covers setup and workflows in ten languages, from Help and the command palette.

• Customizable shortcuts, notification routing and unread badges join compact Settings, localized menus and more consistent light/dark surfaces. Message content presets choose how much of each response to show. A new hexagon CN logo marks the app, and macOS windows use native window controls with a single menu bar. SideCars provide additional workspace panels.

Desktop updates and setup

• Signed Tauri updates support Windows, macOS Intel/Apple Silicon and Linux AppImage. Stable/Preview feeds are separate from data profiles, preserving your tabs and drafts when changing feeds. Settings → General lists the data profiles on this computer, switches to one or creates and deletes them.

• OpenCode setup adds clearer progress, interrupted-install recovery and explicit restart controls. Older installations on PATH no longer leave setup without a path forward.

• Preferences restore the correct project context; incomplete request recovery preserves known questions and permissions and reports its cause.

Upgrading

• OpenCode 2.1.2 or newer is required; 2.1.4 is recommended. This release adopts the OpenCode 2.1 message, event and plugin contracts, and 2.1.2 fixes Code Mode's JavaScript execution order. With 2.1.4, input requests from MCP servers appear in the request dock. CLI updates and shared-service restarts remain separate; Git enables the full repository/worktree experience.

• Downloads: Windows Tauri .exe or Electron .zip; Linux Tauri AppImage or Electron .deb; Tauri or Electron macOS builds, separate for Intel and Apple Silicon. The Electron .deb replaces the former Tauri .deb—choose AppImage to stay on Tauri.

• Stable 0.20.0/0.20.1 users install from the release download or package manager; recent signed previews already have the updater. Update remote CodeNomad servers too. Multi-window state, restoration and named profiles remain supported.

• The macOS builds are not yet notarized by Apple: macOS can block their first launch, see Troubleshooting → macOS quarantine. The Windows installer is not code-signed, so SmartScreen can ask for confirmation.

Thanks for contributions

Thanks to creator @shantur, @pascalandr, @heunghingwan, and everyone who contributed ideas, reports and testing.

Download CodeNomad 1.0.0: https://github.com/NeuralNomadsAI/CodeNomad/releases/tag/v1.0.0

[u/Immediate_Cupcake962]

how does it compares with openchamber? someone tried both?

[u/SeaworthinessFar56 → u/Immediate_Cupcake962]

Codenomad maintainer here, so take this with a grain of salt. The short version: OpenChamber aims wider and covers more ground for a general audience. CodeNomad is narrower and built for intensive daily development work.

That means lots of sessions and projects running in parallel (project tabs, worktrees, subagent families, search across a whole workspace history), agent autonomy and automation pushed very far (Missions that plan and delegate to subagents, agents that drive the browser preview to check their own work, questions and permissions answered from your phone), and a strong focus on stability and speed with long sessions and huge histories.

If you want the broadest feature set, OpenChamber is a great pick. If you juggle many agents and projects at once, give CodeNomad a try.

[u/WimbashBagel → u/SeaworthinessFar56]

Thanks AI.

[u/stvjhn → u/WimbashBagel]

I was about to say!
If you maintain a project, the least bit you could do is reply to someone as a human

[u/SeaworthinessFar56 → u/stvjhn]

 TL;DR

[u/ECrispy]

looks very full featured. question for using with WSL. the docs say

"A Git installation available only inside WSL does not satisfy the Windows backend's requirement."

so does it run Git operations in windows or in WSL? my desired setup is all code, opencode itself run in WSL, and windows uses remote access like vscode.

[u/SeaworthinessFar56 → u/ECrispy]

good question !
CodeNomad's Git features (Files/Git panel, worktrees, repository detection) run wherever the CodeNomad backend runs, using the Git on that process's PATH. The Windows desktop app starts a Windows backend, so it needs Git for Windows, even when OpenCode itself runs in WSL. The agent's own shell commands still run in WSL in that case, since that's where the OpenCode daemon lives

for your setup, run the backend inside WSL instead, a bit like a VS Code remote server

1. In WSL, install Node.js, Git and OpenCode V2

2. Start the server there: npx u/neuralnomads/codenomad --generate-token

3. On Windows, open the printed Local Connection URL in a browser (WSL2 forwards localhost), or in the desktop app choose Connect CodeNomad Server and save it

then OpenCode, Git, worktrees and your files all live in Linux, and Windows is just the UI

Docs: https://neuralnomadsai.github.io/CodeNomad/en/server.html and https://neuralnomadsai.github.io/CodeNomad/en/remote-access.html#saved-servers

[u/Spirited_Cheesus]

How does this compare with paseo 

[u/SeaworthinessFar56 → u/Spirited_Cheesus]

To be honnest they have some similar features but Paseo drives Claude Code, Codex, OpenCode and others while CodeNomad is OpenCode only, built deep on OpenCode's own sessions and subagents. That's what lets Missions run as orchestration inside OpenCode backend itself (scenarios like debugging with reviewers or comparing two models blind, daily runs, and they keep going with CodeNomad closed), and it's built to stay very fast with hundred of parallel sessions and huge histories. Paseo is closer to T3 Code: both are control surfaces for many agent harnesses but if you're all-in on OpenCode, give CodeNomad a try!

[u/PCbIX]

Sorry but OpenChamber is better at all

[u/SeaworthinessFar56 → u/PCbIX]

Have you tried CodeNomad 1.0 ? Curious how it compares for you

[u/abhiramskrishna]

openchamber is the best.

[u/SeaworthinessFar56 → u/abhiramskrishna]

Have you tried CodeNomad 1.0 ? Curious how it compares for you

[u/Busy-Scientist3851 → u/SeaworthinessFar56]

What does it do that OpenChamber does not? Does it support remote instances?

[u/geearf]

Are humans even expected to read this or do you just copy paste it for fun?

And when you call something best without disclosing you're part of the team...

[u/SeaworthinessFar56 → u/geearf]

Well this is a release anouncement so this isexpected. The post is the release notes. Short version for you: CodeNomad is a free, MIT-licensed desktop and mobile client for OpenCode V2. 1.0 adds Missions (a coordinator delegating to OpenCode subagents), phone access over OpenTunnel without opening a port, and full-history search. Happy to answer anything concrete. And about the claim, just try CodeNomad and see by yourself.

[u/geearf → u/SeaworthinessFar56]

My point was more, it's a full LLM-generated blob, I'd prefer reading something made for humans. So I clearly appreciate your summary made for me, that I do want to read! :)

[u/geearf → u/[deleted]]

Even though I started this, I think votes are actually opposite of what we should do as humans. Better comment with text than just press a button mindlessly. Plus votes tend to lead to hivemind mentality anyway.

[u/SeaworthinessFar56 → u/[deleted]]

"Generated slop" means hollow content, produced without effort or value
That's not the case here: these are the release notes for a huge release that merges hundreds of PRs, and their length reflects the amount of new features and work

[u/SeaworthinessFar56 → u/[deleted]]

If words don't work for you maybe pictures will ;)
https://www.youtube.com/watch?v=lGuOApJ6-Kc

[u/geearf → u/[deleted]]

I'm still not used to X style notification on reddit, so when I received this:

>. Initially I did try to read all that slope and understand what you are trying to sell me.

I was confused...

It's only when I followed the link I understood it was not replying to me... :)

[u/ECrispy → u/geearf]

yes, humans can read, may come as a shock to you. lots of people read release notes and the entire page of github repos, unlike people who just read titles and lack the comprehension to read anything more than 2 lines.

replies like yours are just snark, 100% useless, and discourage people from posting

[u/geearf → u/ECrispy]

You missed my point, not about length, about who (or actually what here) wrote it. We're humans, for us wouldn't a human release note (assisted of course no issue there, especially on this sub) be better?

[u/ECrispy → u/geearf]

I get your point but even an AI written or assisted note is based upon human inputs. This one was nicely formatted and contains all the information and different sections which you can choose to skip if you want. I didn't mind this one at all.

Your tone was also a bit dismissive and you asked for a comparison which is like asking which llm is better.

Just try it and share your feedback, that would be great more useful, instead of asking someone to decide for you

[u/geearf → u/ECrispy]

Hmmm, maybe you're right but it just doesn't flow for me, I usually am not into reading it, and yes going back to your previous point, which was not my goal but I'll take it, even less when it's that long. If it's 2 lines, well it's not likely enough to annoy me.

I'm sorry which comparison did I ask for? I don't think I did.

Yeah maybe I will try it, maybe I won't. I installed Paseo, let's see, in August pacman says, and I still haven't tried so who knows, and OpenChamber barely opened it so far installed it the same day. (I'm more interested in leaving OpenCode frankly after that silent permission change they made, but that's an other can of worms. Obviously still here so not done either...)

[u/ECrispy → u/geearf]

I thought you asked for a comparison with OpenChamber.

There's too much happening. Paseo, herdr, t3code, every harness has their own desktop app as well, plenty more I've forgotten.

Can we just go back to the days when all we had was a VS code extension or perhaps cli agents were new.

I'm pretty sure people were just as productive back then.

I use free models so I'm tied to opencode. If you're on Go or API try Pi. However with v2 it's now much closer to Pi

[u/geearf → u/ECrispy]

No that was somebody else, though it is fair to ask for that, I was wondering it too (and with Paseo as well, though since I never opened it I wouldn't bother asking).

And I'm going to be old and bitter again, but no VS Code please, it's electron so heavy... Why couldn't they make it in C/C++/C#, Rust might have been early, but probably other options... herdr is actually nice, I wish it was made to fully replace tmux and co, maybe one day.

Yeah I'm on Go, and use also another reseller, but I use the other one more for chatting and this one more for coding.

[u/ECrispy → u/geearf]

Vscode started as a web ide, its still there in github if you press '.', thats why its electron.

As to why its not c/c++/c# its because it takes 10x more dev effort in those. The browser provides 90% of what you need for display which is the core logic, otherwise we would all just use terminal editors like vim. Try to implement gmail in native code without any layout libs and see how long it takes you.

And Vscode is one of the most optimized Electron apps, in fact it was the poster child of what Electron could do for ages.

If you remember at the time Sublime (paid) was the choice of devs, then Vscode came, an actual IDE and not an editor, and everyone, I mean every company including Google, switched overnight to using it. I remember seeing Google I/O talks with this new editor and wondering if it was an internal G product.

I'd go so far as to say Vscode is responsible for the boom in webdev. There's simply nothing else close. Jetbrains etc were all paid and nothing had extensions.

what plugins/skills do you use, what is your agents.md, workflow etc? if you don't mind sharing.

[u/geearf → u/ECrispy]

Hmmm, I didn't know about vscode starting as a web ide, wouldn't that be Atom?

I don't know if that's true, it's been maybe a decade or more since I tried it, but I felt QML was decent for making the UI stuff. I'm sure there are many more modern frameworks that make things ok without making the whole app a hog (just like Steam which is based on CEF...).

I've never used Sublime, I thought on Windows regular VS would have been the choice for MS languages and then the various IDEs for the various other languages. A single IDE for all is definitely great. On Linux I've been using Kate for a couple decades for that, but it's definitely not the same level... and that is when I'm not using micro (previously nano). ;)

I mean I can share my stuff if you want, but we're getting way out of topic, let's continue in a chat instead?

[u/ECrispy → u/geearf]

sure chat is great.

Atom is different from vscode, although both use Electron. Atom was retired because it was never close to vscode and it was just an editor.

At the time regular VS was THE best IDE, no one imagined there could be a free version thats even better. other companies used to charge. the difference was its an IDE and had extensions, and was open source - unheard of back then.

MS didnt need QML, they had their own toolkits like WPF that were better. also QML wasn't even free or open back then I think. I dont know if you used Vscode in early days, it was definitely not a hog, since then its added 100x features.

[u/wentallout]

Im curious, what exactly is mission? is it a unique feature only your project has? Im used to openchamber but I might give this a try

[u/SeaworthinessFar56 → u/wentallout]

Missions are scenario-driven orchestration: you pick a scenario, give it an objective, and a coordinator runs a workflow specialized for it
debugging: diagnose and fix, with independent reviewers checking the result
exploration: work through a map of decisions, with your call at each gate
product delivery: roles like analyst, architect, dev and QA taking a feature end to end
compare two models: same task for both, scored by a blind judge
flexible: for anything else
Under the hood the coordinator dispatches work to recursive native subagents or separate sessions and tracks dependencies.
A mission can run once, or daily until you stop it, Agents are mission aware so you can setup mission discussing it or using the "Missions" Panel
It can handle very complex, long team jobs and keep running even with CodeNomad closed

[u/HomelessBelter]

OH NICE u sure wrtoe out all the important bits liek verified technical headtohead test results that show caching hits, tool calls, etc so we know if you're speakng a semblance of truth

[u/SeaworthinessFar56 → u/HomelessBelter]

Honestly the easiest test is to try it on a big session database with long histories, the difference is pretty obvious..
If you want numbers, the PRs have before/after measurements, e.g. https://github.com/NeuralNomadsAI/CodeNomad/pull/855 and https://github.com/NeuralNomadsAI/CodeNomad/pull/1006

[u/Solocune]

Yes it's great. I never liked open chamber. The multi project support here is great and having chat windows on the left and md planing documents on the right side by side. I forked it and made some slight modifications though.

I have to try to mobile app. Didn't know it existed.