mirror of https://github.com/NeuralNomadsAI/CodeNomad.git synced 2026-07-10 00:14:27 +00:00

mirror of https://github.com/NeuralNomadsAI/CodeNomad link from https://www.reddit.com/r/opencodeCLI/comments/1txd7ua/comment/opvreck/

Find a file

Pascal André ff4446a367 feat(server): expose opencode server proxy url env (#351 ) Fixes #321 ## Summary - expose OPENCODE_SERVER_BASE_URL in the spawned OpenCode workspace environment - point it at the current workspace's stable CodeNomad proxy URL - propagate the new variable through WSL launches alongside the existing auth env vars ## Why Tools and plugins already receive the auth credentials needed to call the current workspace instance, but they still need an extra lookup to discover the correct URL. The proxy URL is already known before runtime startup, so exposing it directly removes that lookup without changing OpenCode's port selection flow. ## What Changed - packages/server/src/workspaces/opencode-auth.ts: added the OPENCODE_SERVER_BASE_URL env var constant - packages/server/src/workspaces/manager.ts: injects OPENCODE_SERVER_BASE_URL into the workspace runtime environment using CODENOMAD_BASE_URL + proxyPath - packages/server/src/workspaces/__tests__/spawn.test.ts: updates WSL env propagation coverage for the new variable ## Validation - npx tsx --test "packages/server/src/workspaces/__tests__/spawn.test.ts"		2026-05-01 21:46:34 +02:00
.github	fix(desktop): restore managed Node server startup (#348 )	2026-04-26 13:20:47 +01:00
.nomadworks	Init nomadworks	2026-04-26 12:06:06 +01:00
.opencode	Init nomadworks	2026-04-26 12:06:06 +01:00
dev-docs	refactor message stream layout	2025-12-02 19:23:05 +00:00
docs	Init nomadworks	2026-04-26 12:06:06 +01:00
images	Move screenshots to correct folder	2025-11-21 21:59:58 +00:00
packages	feat(server): expose opencode server proxy url env (#351 )	2026-05-01 21:46:34 +02:00
scripts	Fix bumpVersion script for both npm and tauri	2026-03-31 20:15:16 +01:00
tasks	Init nomadworks	2026-04-26 12:06:06 +01:00
temp	Bump to v0.11.2	2026-02-17 18:47:21 +00:00
.gitignore	chore: ignore local artifacts and add cloudflare lockfile	2026-01-22 16:42:47 +00:00
AGENTS.md	docs: document i18n conventions for agents	2026-02-11 10:55:57 +00:00
BUILD.md	Rename electron app package to @neuralnomads/codenomad-electron-app	2025-11-21 00:10:31 +00:00
codemap.yml	Init nomadworks	2026-04-26 12:06:06 +01:00
LICENSE	chore(license): add MIT license	2026-02-02 11:22:49 +00:00
package-lock.json	feat(ui): add markdown preview to file viewer (#352 )	2026-04-26 21:24:19 +01:00
package.json	fix(config): install opencode plugin workspace deps (#360 )	2026-04-26 16:28:07 +01:00
PROGRESS.md	chore: rebrand client and add icon tooling	2025-11-13 22:58:57 +00:00
README.md	docs: add SideCars README section	2026-04-16 09:59:53 +01:00

README.md

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.

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	AppImage, deb, tar.gz (x64, ARM64)

💻 CodeNomad Server

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

npx @neuralnomads/codenomad --launch

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

🧪 Dev Releases

Bleeding-edge builds from the dev branch:

npx @neuralnomads/codenomad-dev --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

See full workaround in the original README.

Community

Built with ♥ by Neural Nomads · MIT License