eneskirca/nodeterm

nodeterm – 空间化终端与 AI 代理管理器

核心概念 – nodeterm 是一款使用 Electron 构建的跨平台桌面（macOS, Linux, Windows）与服务器端网页应用。它让您能在无限的平移与缩放画布上创建节点。每个节点可以是真实的终端（由 tmux 支持）、AI 代理（Claude Code, Gemini, Copilot 等）、便签、基于 Monaco 的代码编辑器、差异视图或网页/视频嵌入。所有节点在应用重启后依然存在，确保您的 Shell 持续运行且 AI 对话保持活跃。

为何重要 – 传统的终端标签页会隐藏上下文；nodeterm 将每个会话转变为可标记、分组与链接的空间对象。同一个画布可作为 Trello 风格的看板，且状态可通过自托管浏览器服务器或 iOS 配套应用访问。这使得复杂的多进程工作流（例如执行构建、调试与提示 AI 助手）更易于可视化与管理，特别适合偏好可视化布局的用户。

主要功能

• 基于节点的画布 – 右键点击以添加终端、AI 代理、笔记、编辑器、差异视图或网页嵌入；可自由拖拽、缩放与标记。
• 持久化 tmux 会话 – 终端在节点重新挂载与机器重启后仍持续运行（包含进程与滚动记录）。
• AI 代理 – 内置支持 Claude Code 与其他模型；代理显示实时状态徽章（RUNNING / NEEDS YOU），可读取链接笔记中的上下文，并可通过 CLI 操作画布。
• 看板视图 – 使用 ⌘⇧B 切换；每个节点显示为一张卡片，可在列间移动，同时底层会话持续运行。
• 远程与移动端 – 通过 QR code 配对手机；iOS 应用显示相同的实时会话并可回复代理提示。“Server Edition”可在 Linux 主机上以无头模式运行，并可从任何浏览器访问。
• 语音听写 – 按住 ⌘⌥ (Ctrl+Alt) 使用 Whisper 在本地转录并输入至终端提示符。
• Git 集成 – 支持 worktree 的分组、完整的暂存/提交 UI，以及可选的 GitHub-Issues-to-Kanban 同步。
• 跨平台打包 – 提供 .dmg, Homebrew cask, AppImage, .deb, .rpm, Windows 安装程序与 iOS 应用。

典型工作流

1. 打开新项目 → 出现空白画布。
2. 右键点击放置终端节点；它会生成一个 tmux 会话。
3. 添加一个 AI 代理节点（例如 Claude Code）并链接包含上下文的便签。
4. 切换至看板视图，将代理卡片移至 In Progress；代理持续运行。
5. 配对 iPhone，扫描 QR code，并从手机应用监控会话。
6. 当代理发出 NEEDS YOU 信号时，点击徽章，回答提示，徽章即变为绿色。

如何获取 – 从 https://nodeterm.dev 下载预构建的二进制文件，或通过 Homebrew 安装 (brew install --cask nodeterm)。源代码可使用 Node 20+, tmux 与标准 Electron 工具链构建 (npm ci && npm run dist)。

许可 – Business Source License 1.1 (BUSL-1.1)。