CodeNomad transforms OpenCode from a terminal tool into a premium desktop workspace — built for developers who live inside AI coding sessions for hours and need control, speed, and clarity.

OpenCode gives you the engine. CodeNomad gives you the cockpit.

• 🚀 Multi-Instance Workspace
• 🌐 Remote Access
• 🧠 Session Management
• 🎙️ Voice Input & Speech
• 🌳 Git Worktrees
• 💬 Rich Message Experience
• 🧩 SideCars
• ⌨️ Command Palette
• 📁 File System Browser
• 🔐 Authentication & Security
• 🔔 Notifications
• 🎨 Theming
• 🌍 Internationalization

Available as both Electron and Tauri builds — choose based on your preference.

Download the latest installer for your platform from Releases.

The Tauri deb is currently built and installation-tested on Ubuntu 24.04. Compatibility with older Debian-based distributions is not yet guaranteed.

Run as a local server and access via browser. Perfect for remote development.

npx @neuralnomads/codenomad --password <your-password> --launch

Authentication required: The server requires a password on first run. You can pass it via --password, the CODENOMAD_SERVER_PASSWORD environment variable, or create an auth.json file (see Server Documentation).

Self-signed certificate: On first launch with HTTPS enabled (the default), your browser will show a "Your connection is not private" warning. This is expected — the server generates a local self-signed certificate automatically. Click Advanced → Proceed to localhost to continue. For local-only use without the warning, run with --https=false --http=true.

See Server Documentation for flags, TLS, auth, and remote access.

Bleeding-edge builds from the dev branch:

npx @neuralnomads/codenomad-dev --password <your-password> --launch

SideCars let you open local web tools inside CodeNomad as tabs.

• Name: Display name used in CodeNomad
• Port: Local HTTP or HTTPS service running on 127.0.0.1:<port>
• Base path: Mounted under /sidecars/:id
• Prefix mode:
  • Preserve prefix forwards the full /sidecars/:id/... path upstream
  • Strip prefix removes /sidecars/:id before forwarding the request upstream

Run with Docker:

docker run -it --init -p 8000:3000 -v "${HOME}:${HOME}:cached" -e HOME=${HOME} gitpod/openvscode-server --server-base-path /sidecars/vscode

Add SideCar as:

• Name: VSCode
• Port: http://127.0.0.1:8000
• Base path: /sidecars/vscode
• Prefix mode: Preserve prefix

Run with:

ttyd --writable zsh

Add SideCar as:

• Name: Terminal
• Port: http://127.0.0.1:7681
• Base path: /sidecars/terminal
• Prefix mode: Strip prefix

• OpenCode CLI — must be installed and in your PATH
• Node.js 18+ — for server mode or building from source

CodeNomad is a monorepo built with:

git clone https://github.com/NeuralNomadsAI/CodeNomad.git
cd CodeNomad
npm install
npm run dev

Gatekeeper flag due to missing notarization. Clear the quarantine attribute:

xattr -dr com.apple.quarantine /Applications/CodeNomad.app

On Intel Macs, also check System Settings → Privacy & Security on first launch.

WebKitGTK DMA-BUF/GBM issue. Run with:

WEBKIT_DISABLE_DMABUF_RENDERER=1 codenomad-tauri

See full workaround in the original README.

Built with ♥ by Neural Nomads · MIT License