CodeNomad：面向 OpenCode V2 的 AI 编程桌面与浏览器工作台

核心能力与快速开始

★ 2657 · TypeScript

能做什么

为 OpenCode V2 提供桌面端（Electron/Tauri）与浏览器工作区；多项目窗口与标签页、草稿、附件和视图恢复；嵌套会话浏览、会话分叉、跨已加载消息搜索与长历史时间线；Git worktree 创建与切换、随会话迁移子会话、工作区内查看 Git 变更；Markdown/代码/diff/工具结果图片展示与推理、工具可见性配置，/btw 临时侧问；设备文件选择、粘贴、拖放与 @ 引用项目文件；远程访问支持密码认证与 HTTPS，Remote Control 可经 OpenTunnel 中继配对手机或其他电脑；SideCars 将服务端 Web 工具作为标签页打开；后台 shell 监控、MCP 连接与全局/项目插件管理；Agent 驱动的浏览器预览（Electron 与 Windows Tauri，其余 Tauri 平台为 iframe 预览）；语音输入与朗读；命令面板、通知、可定制面板、明暗配色与多界面语言。

适用场景

适合跨多个项目、长对话和 Git worktree 工作的开发者，在桌面或浏览器中统一管理 OpenCode 编程会话；需要从远程设备或手机接入开发机上的 AI 编程会话；需要在同一工作区查看代码 diff、工具输出与文件并让 Agent 检查 Web 预览；需要为不同 worktree 并行开展任务并在其间迁移会话；希望以 SideCars 方式在 IDE 或终端等 Web 工具间切换。

项目形态

可直接使用的工具

部署方式

提供 Electron 与 Tauri 桌面安装包（macOS ZIP、Windows ZIP/安装器、Linux deb/AppImage），也可在开发机上用 npx 运行服务端并通过浏览器访问；服务端默认绑定 127.0.0.1，远程访问需指定 --host 0.0.0.0 并配置密码与 TLS。Linux 构建目前在 Ubuntu 24.04 上构建和测试，旧发行版兼容性未保证。

主要依赖

需要 OpenCode V2（1.0.0 最低 2.2.3、推荐 2.2.5）与 Git（Git 需位于后端 PATH，桌面安装包不捆绑 Git）。独立 npm 服务端和源码构建需要 Node.js/npm，推荐 Node.js 24 LTS；桌面版捆绑 Node.js 与 npm。开发需 Node.js（见 .node-version，当前 24.20.0）、Git 和兼容的 OpenCode V2 CLI；Tauri 开发还需平台构建前置条件。

使用限制

1.0.0 不支持 OpenCode V1 及旧 V2 beta 协议。缺少 Git 时仅能降级为目录模式，Git 操作与 worktree 管理不可用，且会话访问限于显式打开的物理文件夹。SideCar 以与 CodeNomad 相同的权限运行，只应添加可信服务，并避免展示不受控内容。首次以默认 HTTPS 启动会出现自签名证书警告。macOS 未公证，可能需清除 quarantine 属性；Linux Wayland + NVIDIA 下 Tauri 版可能需关闭 DMA-BUF 渲染器。Agent 驱动的原生浏览器自动化仅在 Electron 和 Windows Tauri 支持。模型提供方、API 费用与硬件要求未说明。

许可证

MIT

最近推送

2026-11-03 05:49

资料检查：2026-11-03 07:00 · 卡片整理：2026-11-03 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证

职业应用

程序员

作为 OpenCode V2 的桌面/浏览器工作台，用于跨项目进行 AI 辅助编程：管理多项目窗口与嵌套会话历史、创建和切换 Git worktree 并查看变更、展示代码 diff 与工具结果、通过 @ 引用项目文件，以及管理 MCP 连接和插件。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证