vrr/CodeNomad
2
0
Fork 0
mirror of https://github.com/NeuralNomadsAI/CodeNomad.git synced 2026-07-10 00:14:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
mirror of https://github.com/NeuralNomadsAI/CodeNomad link from https://www.reddit.com/r/opencodeCLI/comments/1txd7ua/comment/opvreck/
268 commits 32 branches 172 tags 111 MiB
Find a file
Exact
Shantur Rathore 459b950ab6 Install rollup native binary before server publish
2025-11-21 14:58:33 +00:00
.github/workflows Install rollup native binary before server publish 2025-11-21 14:58:33 +00:00
.opencode/agent Add web_developer 2025-10-28 18:47:30 +00:00
dev-docs Add CLI instance proxy and route UI traffic through it 2025-11-19 02:03:15 +00:00
docs/screenshots Puff-up README 2025-11-14 23:26:13 +00:00
images Updated browser screenshot 2025-11-21 14:48:28 +00:00
packages Add repository and homepage metadata for electron build 2025-11-21 14:40:06 +00:00
tasks chore: rebrand client and add icon tooling 2025-11-13 22:58:57 +00:00
.gitignore Working messages display 2025-10-22 22:10:51 +01:00
AGENTS.md Add CLI instance proxy and route UI traffic through it 2025-11-19 02:03:15 +00:00
BUILD.md Rename electron app package to @neuralnomads/codenomad-electron-app 2025-11-21 00:10:31 +00:00
package-lock.json Rename electron app package to @neuralnomads/codenomad-electron-app 2025-11-21 00:10:31 +00:00
package.json Bump workspace and packages to 0.2.0 2025-11-21 10:51:31 +00:00
PROGRESS.md chore: rebrand client and add icon tooling 2025-11-13 22:58:57 +00:00
README.md More screenshots 2025-11-21 13:30:59 +00:00

README.md

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.

Multi-instance workspace Manage multiple OpenCode sessions side-by-side.

📸 More Screenshots

Command palette overlay Global command palette for keyboard-first control.

Image Previews Rich media previews for images and assets.

Browser Support Browser support via CodeNomad Server.

Getting Started

Choose the way that fits your workflow:

🖥️ Desktop App (Recommended)

The best experience. A native application 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.

💻 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.