Luna Mux

面向 Coding Agent 的终端工作台

下载 · 开发文档 · AI 协作开发规范 · 设计方案

Luna Mux 是一个面向 Coding Agent 的终端工作台。它以项目目录为单位维护会话，一个会话里可以有多个终端窗格，每个窗格既可以是本地终端，也可以是 SSH 远程终端。在这些终端里启动 Codex、Claude Code 等 Agent 时，Luna Mux 会自动注入 Hook 和 MCP 来扩展 Agent 的能力：Hook 负责状态监控，Luna Mux MCP 让 Agent 控制 Luna Mux 自身的各个功能，agent-browser MCP 让 Agent 操作浏览器。此外还内置了移植自 Luna Remote 的完整 SSH 与 SFTP 能力。

项目会话与终端窗格

一个会话对应一个项目目录，保存项目根目录和窗格布局。

• 一个会话里有多个终端窗格，支持横向/纵向分割、拖动比例、布局预设、重命名和最大化。
• 每个窗格既可以是本地终端（macOS 的 zsh/bash、Windows 的 PowerShell 或 WSL），也可以是 SSH 远程终端。
• 本地和远程终端共用 xterm.js 界面，包括搜索、复制粘贴、主题、字体、背景和输出流控。
• 应用重启后恢复会话与布局，但不擅自重连服务器或重启进程。

数据库窗格

数据库窗格可在当前会话中连接 SQLite、MySQL / MariaDB 和 PostgreSQL，浏览表与视图、查看字段/索引/外键、执行分页 SQL 查询，并导入导出 CSV、JSON 与 SQL；SQLite 还支持部分结构编辑。

• 每个数据库窗格使用独立连接；连接配置可保存，密码保存在系统凭据库。
• 窗格默认以只读模式打开，DML 和 DDL 写入需要经过当前会话授权确认。

终端里的 Agent

在任意终端窗格里启动受支持的 Agent（目前包括 Codex 和 Claude Code），Luna Mux 会自动发现这个 Agent，并注入 Hook 和 MCP 来扩展它的能力。

状态监控（Hook）

• Hook 把 Agent 的工作、等待输入、等待权限、完成和错误状态反馈给 Luna Mux。
• 需要关注的窗格会在侧边栏、窗格边框和桌面通知中标记，点击通知即可回到对应位置。
• Agent 环境视图显示 Adapter、Hook、Luna MCP 和 Browser MCP 的健康状态。
• Agent 生命周期跟随应用，退出时关闭受管终端、Agent 和 Chrome。

控制 Luna Mux（Luna Mux MCP）

• Luna Mux MCP 向 Agent 开放会话、窗格、终端、Agent、连接、设置、诊断、传输和隧道等控制能力。
• Agent 可以发现会话、窗格、Terminal Runtime 和其他受管 Agent。
• Agent 可以创建窗格、修改布局、读取有界终端输出、写入终端输入。
• Agent 也可以通过 Luna Mux MCP 控制数据库管理窗格，自主读写数据库。
• Agent 可以查询 Agent 状态、投递任务、发送中断。
• Agent 可以读取安全的连接摘要、修改主题和终端外观、运行内置诊断。
• 关闭 Runtime、启动传输或隧道等重要副作用，需要先在桌面端确认。
• 凭据、私钥和 API Key 不会通过 MCP 暴露给 Agent。

浏览器自动化（agent-browser MCP）

Agent 可以自主操作浏览器完成网页任务：打开页面、点击、填表、读取快照、截图、检查控制台和网络。它通过 agent-browser MCP 驱动一个会话专属的隔离 Chrome，浏览器以独立窗口运行，用户随时可以接管。

• 支持快照、交互、等待、标签页、截图、控制台、网络请求和 HAR。
• 首次使用时按需启动 Chrome，后续复用同一 Runtime 和页面。
• 远程 SSH Agent 通过认证代理使用本机 Chrome，不向远端暴露原始 CDP 端口。

SSH 与 SFTP

完整 SSH 与 SFTP 能力移植自 Luna Remote。

• SSH 支持密码、私钥、SSH Agent、Host Key 校验、保活和一级跳板机。
• 在 SSH 终端里启动的 Agent 同样会被注入 Hook 和 MCP，可以远程控制本机的 Luna Mux，也能通过 agent-browser MCP 操作本机浏览器。
• 连接可分组、排序、备份，可从 OpenSSH Config 或 Luna Remote 数据库导入。
• SFTP 支持本地/远程目录浏览、上传、下载、预览、拖放、队列和失败重试。
• 支持本地转发、远程转发和 SOCKS5 动态转发。

AI 命令助手

AI 命令助手与 Codex、Claude Code 等 Agent 相互独立，使用用户配置的 OpenAI 兼容服务，为当前本地或 SSH 终端生成 Linux Shell、PowerShell、CMD 或 macOS 命令。

设计这一功能是为了让不使用 Agent 的场景也能获得 AI 辅助：无论是在本地终端还是 SSH 远程终端中，都可以让 AI 协助编写命令。

• 结果包含说明、前提、警告和风险等级，可复制、只填入终端，或经风险确认后执行。
• 附带终端上下文时，可选的常见个人信息脱敏在请求前执行。
• 不配置 AI 服务不影响其他功能。

开发

环境搭建、检查命令和打包发布说明见 开发文档。

致谢

Luna Mux 建立在众多优秀的开源项目之上，在此向它们的作者和维护者表示感谢：

• Tauri — 桌面应用框架
• agent-browser — 面向 Agent 的浏览器自动化 MCP
• React — 用户界面
• xterm.js — 终端模拟器
• russh — Rust SSH 客户端与服务器库，支撑 SSH/SFTP 能力
• rmcp — Model Context Protocol 官方 Rust SDK
• tokio — 异步运行时

同时感谢所有在本项目中直接或间接使用的其他开源库的作者。

许可证

Luna Mux 基于 MIT License 发布。第三方组件、字体和内置工具保留各自的许可证与分发条件。