NeuralNomadsAI/CodeNomad

CodeNomad: The command center that puts AI coding on steroids.

2,557

stars

1,326

commits

TypeScript

primary language

Sep 11, 2026

updated

README

CodeNomad

The AI Coding Cockpit for OpenCode

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

Features

🚀 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

Getting Started

🖥️ Desktop App

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

Download the latest installer for your platform from Releases.

Platform	Formats
macOS	DMG, ZIP (Universal: Intel + Apple Silicon)
Windows	NSIS Installer, ZIP (x64, ARM64)
Linux	Tauri deb, Electron portable tar.gz (x64)

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

💻 CodeNomad Server

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.

🧪 Dev Releases

Bleeding-edge builds from the dev branch:

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

SideCars

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

Configuration

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

VSCode (OpenVSCode Server)

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

Terminal (ttyd)

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

Requirements

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

Development

CodeNomad is a monorepo built with:

Package	Description
packages/server	Core logic & CLI — workspaces, OpenCode proxy, API, auth, speech
packages/ui	SolidJS frontend — reactive, fast, beautiful
packages/electron-app	Desktop shell — process management, IPC, native dialogs
packages/tauri-app	Tauri desktop shell (experimental)

Quick Start

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

Troubleshooting

macOS: "CodeNomad.app is damaged and can't be opened"

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.

Linux (Wayland + NVIDIA): Tauri App closes immediately

WebKitGTK DMA-BUF/GBM issue. Run with:

WEBKIT_DISABLE_DMABUF_RENDERER=1 codenomad-tauri

See full workaround in the original README.

Community

Built with ♥ by Neural Nomads · MIT License

Contributors

1,128 commits

99 commits

22 commits

15 commits

Similar repos

eneskirca/nodeterm

Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent…

1,765

pingdotgg/t3code

22,377

different-ai/openwork

The open-source alternative to Claude Cowork (powered by opencode)

23,472

inkshell/inkshell

A tabbed desktop workspace for Claude Code. The CLI, with style. Every session in a tab, every…

swarajbachu/zuse

Zuse

coder/code-server

VS Code in the browser

79,260

nimbalyst/nimbalyst

Nimbalyst - The open-source visual workspace for Claude Code, Codex, and OpenCode. Run multiple…

1,643

btriapitsyn/openchamber

Agentic Development Environment based on OpenCode AI agent

9,541

Languages

TypeScript

87.4%

Rust

6.5%

CSS

4.7%

JavaScript

1.3%

NeuralNomadsAI/CodeNomad

CodeNomad: The command center that puts AI coding on steroids.

2,557

stars

1,326

commits

TypeScript

primary language

Sep 11, 2026

updated

README

CodeNomad

The AI Coding Cockpit for OpenCode

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

Features

🚀 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

Getting Started

🖥️ Desktop App

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

Download the latest installer for your platform from Releases.

Platform	Formats
macOS	DMG, ZIP (Universal: Intel + Apple Silicon)
Windows	NSIS Installer, ZIP (x64, ARM64)
Linux	Tauri deb, Electron portable tar.gz (x64)

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

💻 CodeNomad Server

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.

🧪 Dev Releases

Bleeding-edge builds from the dev branch:

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

SideCars

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

Configuration

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

VSCode (OpenVSCode Server)

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

Terminal (ttyd)

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

Requirements

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

Development

CodeNomad is a monorepo built with:

Package	Description
packages/server	Core logic & CLI — workspaces, OpenCode proxy, API, auth, speech
packages/ui	SolidJS frontend — reactive, fast, beautiful
packages/electron-app	Desktop shell — process management, IPC, native dialogs
packages/tauri-app	Tauri desktop shell (experimental)

Quick Start

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

Troubleshooting

macOS: "CodeNomad.app is damaged and can't be opened"

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.

Linux (Wayland + NVIDIA): Tauri App closes immediately

WebKitGTK DMA-BUF/GBM issue. Run with:

WEBKIT_DISABLE_DMABUF_RENDERER=1 codenomad-tauri

See full workaround in the original README.

Community

Built with ♥ by Neural Nomads · MIT License

Similar repos

eneskirca/nodeterm

Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent…

1,765

pingdotgg/t3code

22,377

different-ai/openwork

The open-source alternative to Claude Cowork (powered by opencode)

23,472

inkshell/inkshell

A tabbed desktop workspace for Claude Code. The CLI, with style. Every session in a tab, every…

swarajbachu/zuse

Zuse

coder/code-server

VS Code in the browser

79,260

nimbalyst/nimbalyst

Nimbalyst - The open-source visual workspace for Claude Code, Codex, and OpenCode. Run multiple…

1,643

btriapitsyn/openchamber

Agentic Development Environment based on OpenCode AI agent

9,541

Contributors

1,128 commits

99 commits

22 commits

15 commits

Languages

TypeScript

87.4%

Rust

6.5%

CSS

4.7%

JavaScript

1.3%