mirror of
https://github.com/NeuralNomadsAI/CodeNomad.git
synced 2026-07-10 00:14:27 +00:00
43db9cdb50
## Thanks for contributions - PR #262 “fix(server): show sane remote URLs for 0.0.0.0 binds” by @VooDisss - PR #270 “Implement shared compact split and unified tool-call diff layout” by @VooDisss - PR #272 “Add log level configuration support” by @bluelovers - PR #274 “perf(ui): fix O(n²) reactive subscriptions in timeline effects (HUGE SPEED IMPROVEMENT)” by @pascalandr - PR #285 “fix(ui): preserve prompt text when dismissing mention picker” by @app/codenomadbot - PR #291 “perf(ui): virtualize message timeline rendering, #274 follow-up ( BIG SPEED IMPROVEMENT )” by @pascalandr - PR #309 “fix(ui): stop forced auto-follow during streaming” by @VooDisss - PR #320 “fix(tauri): own Windows CLI subtree with a job object” by @pascalandr ## Highlights - **Remote access is much easier to use**: Connect to remote CodeNomad servers directly from the app and have full app experience remotely. - **Sidecars**: Open locally hosted services directly in CodeNomad. OpenVSCode Server, Terminal ( using ttyd ) and many more all available remotely and on the move. - **Background task notifications**: LLMs can now run background task asynchronously and be notified when the task is done. No need to wait or periodically checking the status. - **Long conversations are much smoother**: Large sessions and busy timelines render much faster, and chat scrolling behaves better while responses stream in. - **Clearer diffs and output views**: Tool-call diffs and session changes now render more consistently with improved split/unified layouts and support for unified diff patch formats. ## What’s Improved - **Big timeline performance gains**: The message timeline got two major performance passes, including virtualization, so large sessions stay responsive much longer. - **More useful context information**: Token stats are shown more clearly, and context window reporting is simpler to understand. - **Smoother voice and speech flows**: Speech input stays chained correctly, dictated text inserts more naturally into prompts, and voice mode state stays synced across listeners. - **More dependable desktop behavior**: Desktop auth isolation is safer per app, startup is more stable, and Windows process cleanup is more reliable. ## Fixes - **Less frustrating auto-scroll behavior**: Streaming reasoning, tool output, and oversized assistant replies no longer pull you to the bottom as aggressively, and you can toggle hold behavior for long replies. - **More reliable timeline previews**: Message preview tooltips now escape clipping so previews remain usable. - **Safer prompt editing**: Dismissing the mention picker no longer wipes your draft text. - **Better remote session stability**: Remote keyboard handling, reconnect flows, TLS exception scoping, and remote URL display are more predictable. - **Better small-screen and desktop polish**: The settings modal behaves better on phones, speech input stays pinned correctly, and Windows desktop builds handle CLI subprocess ownership more safely. ## Docs - **Refreshed project docs**: README and supporting presentation content were updated to better reflect the current product. ### Contributors - @pascalandr - @VooDisss - @bluelovers **Full Changelog**: https://github.com/NeuralNomadsAI/CodeNomad/compare/v0.13.3...v0.14.0 |
||
|---|---|---|
| .github | ||
| .opencode | ||
| dev-docs | ||
| docs/screenshots | ||
| images | ||
| packages | ||
| scripts | ||
| tasks | ||
| temp | ||
| .gitignore | ||
| AGENTS.md | ||
| BUILD.md | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| PROGRESS.md | ||
| 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