278b563c1a
## Thanks for contributions - PR #252 “feat: Enable file editing and saving” by @jchadwick - PR #256 “feat(ui): add session yolo mode controls” by @pascalandr - PR #257 “fix(tauri): sync native app version with package releases” by @pascalandr - PR #258 “fix(tauri): stop stale UI assets from shadowing desktop builds” by @pascalandr - PR #260 “fix(ui): escape raw HTML in user prompt messages” by @app/codenomadbot ## Highlights - **Edit and save files directly in CodeNomad**: Update workspace files in the built-in editor, save them without leaving the app, and get safer handling for unsaved changes or edit conflicts. - **More control over session automation**: Turn on per-session YOLO mode from the Status tab, keep it visible with a clear badge, and let long-running sessions continue auto-accepting prompts as expected. - **Better voice conversation options**: Use spoken summary mode for replies and keep conversation speech settings isolated per client, so one device’s voice preferences do not unexpectedly affect another. - **Faster session recovery**: Reload a session transcript from the sidebar and see when a session is retrying, including live status feedback. ## What’s Improved - **Smoother desktop setup**: Desktop builds now bundle the right CLI resources and handle microphone access more cleanly. - **More reliable cross-platform desktop behavior**: Windows process handling and npm invocation are safer, reducing environment-specific issues. - **Clearer session status visibility**: Retrying sessions now show more useful state in the sidebar and header, so it is easier to tell what is happening. - **Cleaner in-app feedback**: Long toast messages wrap properly, GitHub star counts display more cleanly, and message/code rendering behaves more predictably. ## Fixes - **Safer prompt rendering**: Raw HTML in user prompts is escaped so messages display safely instead of being interpreted. - **More reliable code previews**: Incomplete syntax highlighting results are no longer cached, which helps prevent broken-looking file views. - **Better voice handoff**: Conversation playback stops when voice input starts, avoiding overlapping speech. - **More dependable desktop releases**: Native app versions now stay aligned with package releases, and stale UI assets no longer shadow new desktop builds. ### Contributors - @jchadwick - @pascalandr
CodeNomad
A fast, multi-instance workspace for running OpenCode sessions.
CodeNomad is built for people who live inside OpenCode for hours on end and need a cockpit, not a kiosk. It delivers a premium, low-latency workspace that favors speed, clarity, and direct control.
Manage multiple OpenCode sessions side-by-side.
📸 More Screenshots
Global command palette for keyboard-first control.
Rich media previews for images and assets.
Browser support via CodeNomad Server.
Getting Started
Choose the way that fits your workflow:
🖥️ Desktop App (Recommended)
The best experience. A native application (Electron-based) with global shortcuts, deeper system integration, and a dedicated window.
- Download: Grab the latest installer for macOS, Windows, or Linux from the Releases Page.
- Run: Install and launch like any other app.
🦀 Tauri App (Experimental)
We are also working on a lightweight, high-performance version built with Tauri. It is currently in active development.
- Download: Experimental builds are available on the Releases Page.
- Source: Check out
packages/tauri-appif you're interested in contributing.
💻 CodeNomad Server
Run CodeNomad as a local server and access it via your web browser. Perfect for remote development (SSH/VPN) or running as a service.
npx @neuralnomads/codenomad --launch
Full server/CLI documentation (flags + env vars, TLS, auth, remote access):
To see all available options:
npx @neuralnomads/codenomad --help
🧪 Dev Releases
Bleeding-edge builds are published as GitHub pre-releases and are generated automatically from the dev branch.
npx @neuralnomads/codenomad-dev --launch
Highlights
- Multi-Instance: Juggle several OpenCode sessions side-by-side with tabs.
- Long-Session Native: Scroll through massive transcripts without hitches.
- Command Palette: A single global palette to jump tabs, launch tools, and control everything.
- Deep Task Awareness: Monitor background tasks and child sessions without losing flow.
Requirements
- OpenCode CLI: Must be installed and available in your
PATH. - Node.js 18+: Required if running the CLI server or building from source.
Troubleshooting
macOS says the app is damaged
If macOS reports that "CodeNomad.app is damaged and can't be opened," Gatekeeper flagged the download because the app is not yet notarized. You can clear the quarantine flag after moving CodeNomad into /Applications:
xattr -l /Applications/CodeNomad.app
xattr -dr com.apple.quarantine /Applications/CodeNomad.app
After removing the quarantine attribute, launch the app normally. On Intel Macs you may also need to approve CodeNomad from System Settings → Privacy & Security the first time you run it.
Linux (Wayland + NVIDIA): Tauri AppImage closes immediately
On some Wayland compositor + NVIDIA driver setups, WebKitGTK can fail to initialize its DMA-BUF/GBM path and the Tauri build may exit right away.
Try running with one of these environment variables:
# Most reliable workaround (can reduce rendering performance)
WEBKIT_DISABLE_DMABUF_RENDERER=1 codenomad
# Alternative for some Wayland setups
__NV_DISABLE_EXPLICIT_SYNC=1 codenomad
If you're running the Tauri AppImage and want the workaround applied every time, create a tiny wrapper script on your PATH:
#!/bin/bash
export WEBKIT_DISABLE_DMABUF_RENDERER=1
exec ~/.local/share/bauh/appimage/installed/codenomad/CodeNomad-Tauri-0.4.0-linux-x64.AppImage "$@"
Upstream tracking: https://github.com/tauri-apps/tauri/issues/10702
Architecture & Development
CodeNomad is a monorepo split into specialized packages. If you want to contribute or build from source, check out the individual package documentation:
| Package | Description |
|---|---|
| packages/electron-app | The native desktop application shell. Wraps the UI and Server. |
| packages/server | The core logic and CLI. Manages workspaces, proxies OpenCode, and serves the API. |
| packages/ui | The SolidJS-based frontend. Fast, reactive, and beautiful. |
Quick Build
To build the Desktop App from source:
- Clone the repo.
- Run
npm install(requires pnpm or npm 7+ for workspaces). - Run
npm run build --workspace @neuralnomads/codenomad-electron-app.