CodeNomad

A fast, multi-instance workspace for running OpenCode sessions.

CodeNomad is built for people who live inside OpenCode for hours on end and need a cockpit, not a kiosk. It delivers a premium, low-latency workspace that favors speed, clarity, and direct control.

Manage multiple OpenCode sessions side-by-side.

📸 More Screenshots

Global command palette for keyboard-first control.

Rich media previews for images and assets.

Browser support via CodeNomad Server.

Getting Started

Choose the way that fits your workflow:

🖥️ Desktop App (Recommended)

The best experience. A native application (Electron-based) with global shortcuts, deeper system integration, and a dedicated window.

• Download: Grab the latest installer for macOS, Windows, or Linux from the Releases Page.
• Run: Install and launch like any other app.

🦀 Tauri App (Experimental)

We are also working on a lightweight, high-performance version built with Tauri. It is currently in active development.

• Download: Experimental builds are available on the Releases Page.
• Source: Check out packages/tauri-app if you're interested in contributing.

💻 CodeNomad Server

Run CodeNomad as a local server and access it via your web browser. Perfect for remote development (SSH/VPN) or running as a service.

npx @neuralnomads/codenomad --launch

This command starts the server and opens the web client in your default browser.

Highlights

• Multi-Instance: Juggle several OpenCode sessions side-by-side with tabs.
• Long-Session Native: Scroll through massive transcripts without hitches.
• Command Palette: A single global palette to jump tabs, launch tools, and control everything.
• Deep Task Awareness: Monitor background tasks and child sessions without losing flow.

Requirements

• OpenCode CLI: Must be installed and available in your PATH.
• Node.js 18+: Required if running the CLI server or building from source.

Architecture & Development

CodeNomad is a monorepo split into specialized packages. If you want to contribute or build from source, check out the individual package documentation:

Package	Description
packages/electron-app	The native desktop application shell. Wraps the UI and Server.
packages/server	The core logic and CLI. Manages workspaces, proxies OpenCode, and serves the API.
packages/ui	The SolidJS-based frontend. Fast, reactive, and beautiful.

Quick Build

To build the Desktop App from source:

1. Clone the repo.
2. Run npm install (requires pnpm or npm 7+ for workspaces).
3. Run npm run build --workspace @neuralnomads/codenomad-electron-app.