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é d9ff1e03cf revert: remove tracked NomadWorks task artifacts (#531 ) ## Summary This PR removes tracked NomadWorks/OpenCode/task-tracking artifacts that were accidentally committed to the repository and now interfere with local NomadWorks usage for other contributors. NomadWorks generates local workflow state such as `tasks/`, SCR registries, and codemaps as needed. Keeping those generated artifacts tracked in the shared repository creates stale state, false active tasks, and confusing/broken NomadWorks behavior for other users who initialize or run the workflow locally. ## Problematic commits / artifacts The cleanup addresses artifacts introduced by the following Shantur-authored commits: - ``e708c565ef`` - `docs(wake-lock): record wake-lock change workflow` - Introduced NomadWorks wake-lock SCR/task artifacts: - `docs/scrs/SCR-2026-04-21-001-wake-lock-system-sleep-only.md` - `tasks/current.md` - `tasks/discussions/DISCUSSION-001-wake-lock-behavior-change-for-macos-sleep-vs-screen-lock.md` - `tasks/todo/055-wake-lock-investigation.md` - `tasks/todo/056-wake-lock-behavior-change.md` - `tasks/todo/057-implement-system-sleep-only-wake-lock.md` - ``a337c19b63`` - `Init nomadworks` - Introduced tracked NomadWorks/OpenCode initialization artifacts: - `.nomadworks/*` - root `codemap.yml` - `docs/scrs/current.md` - `docs/scrs/done.md` - `tasks/done.md` - `.opencode/opencode.jsonc` - `.opencode/package-lock.json` - The removed `.opencode/opencode.jsonc` only contained the OpenCode schema plus a commented NomadWorks plugin entry: - `"$schema": "https://opencode.ai/config.json"` - `// "@neuralnomads/nomadworks@0.1.0-rc.10"` - The removed `.opencode/package-lock.json` was an orphan lockfile with no tracked `.opencode/package.json`. It pinned old OpenCode plugin/runtime packages, notably: - `@opencode-ai/plugin@1.14.24` - `@opencode-ai/sdk@1.14.24` - Those pinned OpenCode versions are stale for the current CodeNomad/OpenCode integration, so keeping this lockfile is misleading and can imply an unsupported local plugin setup. - ``b06b8104a5`` - `Add task specifications for Phase 5 advanced input features` - Introduced tracked task-planning artifacts including: - `tasks/todo/015-keyboard-shortcuts.md` - `tasks/todo/020-command-palette.md` - `tasks/todo/021-file-attachments.md` - `tasks/todo/022-long-paste-handling.md` - `tasks/todo/023-symbol-attachments.md` - `tasks/todo/024-agent-attachments.md` - `tasks/todo/025-image-clipboard-support.md` - ``0a3ac6cbf2`` - `docs: add theme overhaul task series` - Introduced tracked task-planning artifacts `tasks/todo/041-` through `tasks/todo/045-`. - ``cb56eed4f9`` - `docs: add tailwind refactor follow-up tasks` - Introduced tracked task-planning artifacts `tasks/todo/046-` through `tasks/todo/048-`. - ``7267baf23d`` - `docs: queue remaining style cleanup tasks` - Introduced tracked task-planning artifacts `tasks/todo/049-` through `tasks/todo/054-`. Some older mixed product commits also added `tasks/done/` or `PROGRESS.md` while introducing real product code. Those commits should not be fully reverted because that would remove product functionality, so this PR removes the stale tracking files directly in a final cleanup commit. ## Changes - Reverts the previous partial NomadWorks cleanup so the full original faulty state can be reverted cleanly. - Fully reverts the original `Init nomadworks` commit. - Fully reverts the wake-lock NomadWorks workflow artifact commit. - Removes remaining stale historical progress/task-tracking files that are not used by CodeNomad runtime, builds, or GitHub workflows. - Removes stale `.opencode` root config/lock artifacts introduced by the NomadWorks initialization because the config only references a commented NomadWorks plugin and the lockfile pins unsupported old OpenCode packages without a matching package manifest. ## Validation - `git status --short` is clean. - `git diff --check upstream/dev..HEAD` passes with no output. - Final diff only removes tracked NomadWorks/OpenCode/task/progress artifacts; no runtime source files are changed.		2026-06-08 17:20:31 +01:00
.github	chore: TASK-075 automate Winget updates on release (#513 )	2026-06-03 09:03:46 +02:00
.opencode	revert: remove tracked NomadWorks task artifacts (#531 )	2026-06-08 17:20:31 +01:00
dev-docs	refactor message stream layout	2025-12-02 19:23:05 +00:00
docs	revert: remove tracked NomadWorks task artifacts (#531 )	2026-06-08 17:20:31 +01:00
images	Move screenshots to correct folder	2025-11-21 21:59:58 +00:00
packages	fix(ui): add retry logic to SSE pong to improve connection resilience (#519 )	2026-06-08 17:20:10 +01:00
scripts	chore: TASK-075 automate Winget updates on release (#513 )	2026-06-03 09:03:46 +02: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: require detailed commit messages	2026-05-07 17:45:31 +01: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	Support OpenCode SDK 1.16 runtime APIs (#526 )	2026-06-07 11:59:56 +01:00
package.json	Bump version to 0.17.0	2026-06-04 21:05:56 +01:00
README.md	docs: add auth requirement and self-signed cert warning to quick-start (#481 )	2026-05-26 22:29:42 +02: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 --password <your-password> --launch

Authentication required: The server requires a password on first run. You can pass it via --password, the CODENOMAD_SERVER_PASSWORD environment variable, or create an auth.json file (see Server Documentation).

Self-signed certificate: On first launch with HTTPS enabled (the default), your browser will show a "Your connection is not private" warning. This is expected — the server generates a local self-signed certificate automatically. Click Advanced → Proceed to localhost to continue. For local-only use without the warning, run with --https=false --http=true.

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

🧪 Dev Releases

Bleeding-edge builds from the dev branch:

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