cloudx

Cloudx 是一个为 Codex CLI 设计的本地优先工作台，运行在用户自己的 Linux 构建机上，并通过桌面或手机浏览器驱动。代码、凭据、shell 工具和 Codex 登录信息均保留在主机上；该项目建议使用私有 tailnet，并声明不支持公开互联网暴露。README 警告称，Cloudx 可以创建终端、向 shell 和 Codex 发送文本、读取和编辑配置根目录下的文件，以及嵌入带有令牌 URL 的本地仪表板，且它不对直接的 LAN 客户端进行身份验证。对于受信任且有防火墙保护的 LAN，存在明确的 0.0.0.0 绑定选项。 UI 适配桌面端和手机端。工作区是基于服务器的窗口，具有独立的窗格布局、默认工作目录、快速名称搜索和 AI 辅助的上下文搜索。窗格的行为类似于 tmux，具有可移动的插件标签页，布局模板可以将窗格/标签页排列保存并在不同的项目路径上重新打开。 README 中描述的插件和工具包括：Codex 和标准 shell 终端标签页，支持将 PNG/JPEG/WebP/GIF 粘贴到 Codex 标签页中（保存至 .cloudx/pasted-images 并作为 @ 文件引用插入）；一个具有语音读写操作、活动文件搜索、可选 Git 设置、修改文件徽章和逐文件渲染 diff 的文件浏览器；一个用于创建或克隆裸仓库并管理项目 worktrees 的 worktree 管理器；一个用于托管仪表板的本地 Web 插件；一个 Jira Cloud 插件，提供按 Epic 分组的指派问题仪表板、评论、状态转换、链接、浏览器链接以及轮询或手动自动化触发器；以及一个文档存档插件，用于摄取文件、路径、URL、YouTube 播放列表、复制的文本和媒体转录，支持搜索、源检查、失效处理、队列导入以及自动 Codex 规则/技能注入。 自动化标签页将触发事件、插件钩子、原语和转换器组合成保存的图表，具有 Python 和 Bash 执行原语以及 cloudx.call_hook API。语音控制使用浏览器音频、本地 Faster Whisper 服务和配置的规划模型。Cloudx 在 3001 端口提供 HTTPS 服务，使用本地自签名证书以获取麦克风访问权限。 Codex 终端默认设置经过管理：Codex 以明确的 --yolo 模式运行，禁用本地记忆和 Codex Apps，禁用 Agent 插件，且仅在标签页生成的 Codex 主页中启用 Cloudx 选定、系统和捆绑的技能。重新加载页面会重新连接运行中的终端标签页并带有回放缓冲区；重启 Cloudx 服务将结束这些进程。恢复模式（picker, last, ID）使用共享会话。 仓库组件包括：apps/server（Fastify 服务器、插件宿主、会话、终端、本地 Web 代理、ASR 桥接、语音控制器）、apps/web（React/Vite UI）、packages/plugin-api、packages/shared、services/asr（Faster Whisper）、services/documentation-indexer（FastAPI 索引器）、一个无需凭据且无网络的验证器容器，以及涵盖安全模型、安装、动机和 AI 相关贡献流程的若干文档。插件也可以作为元数据从包含 .cloudx-plugin/plugin.json 的 GitHub 仓库安装；该路径不执行第三方插件代码。 安装目标为 Ubuntu 22.04 或更高版本，通过引导式 install.sh 完成，该脚本会预览每个阶段，在需要时安装系统软件包和 Node.js 22，检查 Git 2.36+，安装固定的 Codex CLI 版本，准备 ASR 和 documentation-indexer 环境，写入配置，通过 nvidia-smi 检测 NVIDIA GPU，并可安装用户级服务。文档中记录了 --dry-run, --yes, --verbose, --update 和 --uninstall 选项，以及手动 npm ci/build/dev 启动方式和需要允许精确 origin 的 Vite 开发工作流。 配置由环境变量驱动，涵盖绑定主机和端口、受信任的 origin、日志级别、允许的根目录、助手二进制文件、ASR URL/设备/计算类型和音频上传限制、文档索引器 URL、主机、端口、超时、上传上限和数据目录，以及语音规划模型。README 指出，该项目是通过高度 Agent 辅助的工作流构建的，虽然有用但并非经过加固的服务，并在 MIT 协议下发布。