CodeNomad – 一个 AI 驱动的编码驾驶舱

它是什么 – CodeNomad 是一个桌面和浏览器应用程序，基于 OpenCode V2，这是来自 OpenCode.ai 的神经代码生成引擎。它提供了一个功能齐全的工作区，开发者可以在其中管理多个项目、保持长时间的 AI 驱动对话，并在不离开 UI 的情况下使用 Git worktree。

核心功能

功能	你得到什么
项目与窗口	独立的桌面窗口，每个窗口都有自己的标签栏、草稿、文件附件和布局恢复。
会话与历史	嵌套的 AI 聊天会话、时间线（可让你跳转长对话）以及跨所有消息的全文搜索。
Git worktree 支持	直接从 UI 创建、切换和移动 worktree；无需打开终端即可查看差异和提交历史。
丰富的对话	Markdown、代码块、差异、工具结果图像，以及用于附带问题的 `/btw` 命令。
文件处理	拖放、粘贴或选择文件；`@` 引用可让你将项目文件插入聊天中。
远程访问	在任何机器上运行 CodeNomad 服务器，并通过 HTTPS（密码保护）连接。可选的远程控制通过 OpenTunnel 中继配对手机或另一台计算机，避免端口转发。
SideCars	将外部网页工具（VS Code 服务器、终端、自定义服务）作为标签嵌入 CodeNomad 中。
代理驱动的浏览器预览	AI 代理可以在 Electron 或 Windows-Tauri 中打开网页预览并自动检查。
语音输入/输出	口述提示并听取模型的回复。
可自定义 UI	命令面板、通知、浅色/深色主题、多语言面板和可配置面板。

开始使用

桌面客户端（Electron 或 Tauri）

从 Releases 页面下载适用于 macOS、Windows 或 Linux 的相应归档文件。
安装（deb、AppImage、ZIP 或 Windows 安装程序）。捆绑包包含 Node.js，因此无需额外运行时。
首次启动时，将 CodeNomad 指向现有的 OpenCode V2 可执行文件，或让设置向导为您安装。
打开文件夹，连接您的模型提供商，然后开始会话。

服务器模式（仅浏览器）

npx @neuralnomads/codenomad --password "my-pwd" --launch

运行一个本地 Node.js 服务器，在 https://localhost 提供 UI。添加 --host 0.0.0.0 以用于远程浏览器。
认证基于密码；自动生成自签名 TLS 证书。

开发构建

git clone -b dev https://github.com/NeuralNomadsAI/CodeNomad.git
cd CodeNomad
npm ci --workspaces --include=optional
npm run dev   # Electron 开发主机
# 或 npm run dev:tauri 用于 Tauri shell

先决条件

OpenCode V2（≥ 2.0.7，推荐 2.0.21）– 实际生成代码的 AI 引擎。
Git – worktree 功能必需；必须在后端的 PATH 中。
Node.js 24 LTS – 服务器和从源代码构建所需（与桌面安装程序捆绑）。

扩展工作区

SideCars 允许您将任何本地网页服务（例如 VS Code Server、ttyd 终端）作为标签嵌入。在 偏好设置 → SideCars 中配置名称、端口、协议和路径前缀处理。
插件（全局或项目范围）可以从 UI 激活以添加自定义工具。

故障排除要点

macOS 公证：使用 xattr -dr com.apple.quarantine … 清除隔离属性。
Linux Tauri 在 Wayland + NVIDIA 上：禁用 WebKitGTK DMA-BUF 渲染器（WEBKIT_DISABLE_DMABUF_RENDERER=1）。

谁在背后？

由 Neural Nomads（GitHub 组织 NeuralNomadsAI）开发，并在 MIT 许可下发布。

CodeNomad 将 OpenCode 引擎变成一个功能齐全的 IDE 类驾驶舱，让您可以在一个地方编码、聊天和管理 Git。

NeuralNomadsAI/CodeNomad