duxweb/codux

Codux – 高性能 AI 编码终端（已归档）

它是什么

• 一个原生桌面（macOS、Windows、Linux）和移动应用，充当使用 AI 驱动的编码助手（例如 OpenAI Codex、Claude Code、Kimi 等）的开发者的控制平面。
• 它集成了终端、项目感知工作区、令牌使用分析、凭据隔离的 SSH/DB 辅助工具，以及加密的点对点链接，以便您可以在设备和无头主机之间保持长时间运行的 AI 代理会话。

核心概念

问题	Codux 的解决方案
每个 AI CLI 都有自己的状态 → 工作树、终端、令牌之间混乱	一个统一的工作区，跟踪每个项目的每个 AI CLI、Git 工作树和终端
长时间运行的代理难以恢复	实时状态、本地历史和会话恢复；您可以从手机或另一台计算机分离和重新附加
令牌支出不透明	按工具、模型、项目和日期细分的实时令牌使用情况
凭据最终出现在提示中	codux-ssh 和 codux-db 包装器在受保护的进程中注入密码/密钥 – 模型永远不会看到它们
工作位于远程机器上	一个无头主机（codux-agent）在任何服务器/Mac/Linux 机器上运行；桌面或手机通过端到端加密的 P2P/中继链接连接

主要功能

• 多工具支持 – 支持 Codex、Claude Code、Oh My Pi、OpenCode、MiMo、Kiro、CodeWhale、Agy、Kimi 等的包装器。
• 工作树优先模型 – 每个 Git 工作树都有自己的终端、Git 状态和 AI 会话。
• 令牌分析 – 仪表板显示每个模型/工具/项目的使用情况。
• 凭据隔离 – codux-ssh / codux-db 命令允许代理访问服务器/数据库，而不会在提示或 shell 历史中暴露密码。
• 设备无关配对 – 桌面、手机和任何无头主机通过 iroh 网络库成为对等节点；连接是加密的，可以回退到中继。
• Web 隧道浏览器 – 内置的 Chromium 视图，通过主机代理 Web 流量，让您像本地一样浏览远程机器上的 Vite 开发服务器。
• 终端宠物 – 一个异想天开的像素宠物，根据令牌消耗升级（纯装饰）。
• 本地优先 – 所有数据（项目、内存、凭据、令牌统计）都保留在您的机器上；没有云服务或账户。

架构（高层）

• 桌面应用 – 用 Rust + GPUI 编写，提供 UI、终端模拟器，以及将环境指令注入受支持的 AI CLI 的包装器。
• 移动应用 – 一个 Flutter 前端，连接到相同的对等网络，显示相同的工作区。
• 无头主机（codux-agent） – 一个轻量级 Rust 二进制文件，可在任何操作系统上运行，通过加密链接暴露终端、Git 和 AI 会话。
• 网络 – 由 iroh 库提供支持，用于端到端加密的 P2P 连接，并可选的中继回退。
• 凭据辅助工具 – 小型子进程（codux-ssh、codux-db），读取存储的配置文件并执行实际连接，使秘密不进入 AI 模型的上下文。

安装

• 桌面 – macOS 通过 Homebrew Cask（brew install --cask duxweb/tap/codux）或直接下载 .dmg / Windows .exe 安装程序。
• Windows 上的 WSL – 启用 WSL，安装 Linux 发行版，然后从应用的设置中安装 Codux Runtime。
• 移动 – Android APK 来自 codux-flutter 发布；iOS 应用是付费的（涵盖 Apple 开发者费用），但源代码是开源的。
• 无头主机 – 一行脚本 curl …/install.sh | sh（自动检测 OS/架构）或手动下载二进制文件。

许可证与状态

• 采用 GPL-3.0 许可。
• 仓库已归档；积极开发已移至 Sailry 项目（sailry-harness）。代码仍可供参考。

谁可能使用它

• 大量使用 AI 辅助编码工具并需要稳定、项目范围环境的开发者。
• 希望将长时间运行的 AI 代理保留在服务器上，同时仍能从任何设备监控和交互的团队。
• 任何担心凭据泄露到 LLM 提示中的人。

---

以上所有信息均直接取自 README；未推断任何额外功能。