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

Shantur Rathore 403a3ff189 Scroll fixes - Improve scroll to bottom handling for reasoning, bash and task tools (#288 ) Fixes #286 and more		2026-04-04 15:11:45 +01:00
.github	fix(workflows): recheck non-dev PR authorization by author	2026-04-01 23:11:25 +01:00
.opencode	Add release notes command	2026-01-24 19:21:56 +00:00
dev-docs	refactor message stream layout	2025-12-02 19:23:05 +00:00
docs/screenshots	Update README	2026-03-31 22:50:40 +01:00
images	Move screenshots to correct folder	2025-11-21 21:59:58 +00:00
packages	Scroll fixes - Improve scroll to bottom handling for reasoning, bash and task tools (#288 )	2026-04-04 15:11:45 +01:00
scripts	Fix bumpVersion script for both npm and tauri	2026-03-31 20:15:16 +01:00
tasks	Batch hydrate normalized messages for session load	2025-11-26 10:57:39 +00: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
LICENSE	chore(license): add MIT license	2026-02-02 11:22:49 +00:00
package-lock.json	Bump version to 0.13.3	2026-03-31 20:15:25 +01:00
package.json	Bump version to 0.13.3	2026-03-31 20:15:25 +01:00
PROGRESS.md	chore: rebrand client and add icon tooling	2025-11-13 22:58:57 +00:00
README.md	Refresh README with modern marketing-focused layout	2026-03-31 22:53:58 +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
⌨️ 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

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