Mirafold
在浏览器中运行并集中监管本机编码智能体。
- Star 数
- ★ 19
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 87/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 有免费版，另有付费云服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 已经在终端使用 Codex、Claude Agent、OpenCode 或 Gemini CLI，但希望通过浏览器阅读结构化输出的开发者。
- 不适合
- 需要完全离线或隔离环境运行的团队，远程配对依赖厂商中继
- 不愿为远程浏览器和手机配对购买 Mirafold Pro 许可的用户
- 需要稳定生产级工具、无法容忍公开测试版缺陷的团队
- 源码审查
- 87/100 · 表现良好
这个 Agent 能做什么，适合哪些场景？
Mirafold 是 Claude Agent、Codex、OpenCode 和 Gemini CLI 的浏览器界面，而不是位于它们之间的通用替代智能体。它通过本地守护进程连接各智能体的原生事件流，并由 React 客户端呈现流式 Markdown、表格、图表、差异、任务列表、图示和图片等输出。智能体继续使用本机上的引擎、凭据、配置、权限模型、文件系统和 Shell。产品提供持久会话、多个浏览器视图、任务控制页、会话内 Cockpit、只读文件浏览和 Git 变更审查。它还包含支持交互程序与密码提示的真实 PTY，并可通过端到端加密中继提供可选的远程浏览器和手机访问。该项目采用 MIT 许可证，但远程配对功能需要有效的 Mirafold Pro 许可证密钥。
启动后，本地守护进程以当前目录作为默认工作区，并为所选智能体建立原生会话；AgentPicker 用于选择支持的智能体、检测到的后端和工作目录。各适配器把原生事件流转换为 server/protocol.ts 定义的共享协议，会话注册表负责热会话、重放历史和浏览器连接。React 客户端将 Shell 自有控件与智能体输出区域分开，在后者中渲染经过验证的注册组件和沙箱化产物。普通提示会发送给智能体；以 ! 开头的命令在交互式 PTY 中执行，并把转录作为智能体回合的一部分，以 !! 开头的命令只在 Shell 中执行。Files 和 Changes 工作区分别读取当前目录及其 Git 工作树变更，任务控制页和 Cockpit 可预览、提示、停止、结束或切换会话。若没有可用的实时后端，系统会改用内置脚本演示，不产生模型流量。
- 已经在终端使用 Codex、Claude Agent、OpenCode 或 Gemini CLI，但希望通过浏览器阅读结构化输出的开发者。
- 同时运行多个编码会话，需要从任务控制页或 Cockpit 查看状态、切换、停止和结束会话的工程师。
- 需要在对话旁只读浏览工作区文件并检查 Git 工作树变更的代码审查者。
- 需要在编码会话中运行交互式程序或处理密码提示，同时保留真实 PTY 行为的命令行用户。
- 希望用脚本演示后端评估界面，而暂时不配置模型后端或产生模型流量的团队。
- 拥有 Mirafold Pro 许可证，并希望通过端到端加密中继从远程浏览器或手机连接本机服务的用户。
如何安装或部署这个 Agent？
前提是 Node.js 22 或更新版本。全局安装并在准备授权给智能体访问的项目目录中启动：
npm install --global mirafold
cd /path/to/trusted-projectmirafold
服务绑定到回环地址、打开浏览器，并把当前目录设为默认工作区。可用 mirafold --help、mirafold --no-open 或 mirafold --verbose。仅应在已经信任的项目中使用 npx mirafold，因为 npx 会向所启动的命令暴露项目本地可执行文件。实时会话还需要系统检测到受支持的智能体后端及其可用认证；如果没有，仍可运行内置脚本演示。
如何使用这个 Agent？
启动 mirafold 后，在 AgentPicker 中选择智能体、检测到的后端和工作目录。普通请求直接输入提示框。使用 !command 在 Mirafold 的交互式 Shell 中执行命令，并让智能体看到该回合的转录；使用 !!command 执行仅限 Shell、不会交给智能体的命令。访问 / 查看任务控制页，访问 /s/<session-id> 打开指定会话。通过活动栏打开 Cockpit，可预览、提示、停止、结束或切换实时会话；Files 和 Changes 用于查看当前目录及 Git 变更。状态栏中的 show details 仅为当前浏览器标签展开推理、例行调用、输入和保留输出。远程访问通过状态栏的 ⧉ pair 配对，并要求有效的 Mirafold Pro 许可证密钥。
这个 Agent 有哪些优点和局限？
- 为 Claude Agent、Codex、OpenCode 和 Gemini CLI 分别提供原生适配器，不用通用替代智能体接管其引擎、认证或权限模型。
- 除流式 Markdown 外，还能通过 MCP 工具呈现实时表格、图表、差异、任务列表、图示、图片和其他交互组件。
- 持久会话、多个附加浏览器视图、任务控制页和 Cockpit 支持集中监管多个会话。
- 内置真实 PTY，明确支持交互式程序和密码提示，并区分智能体可见的 ! 命令与仅限 Shell 的 !! 命令。
- 没有可用实时后端时可自动使用脚本演示，便于在不产生模型流量的情况下体验完整界面。
- 仍处于公开测试阶段，项目明确提示可能存在缺陷和体验粗糙之处。
- 要求 Node.js 22 或更新版本；实时使用还依赖本机已安装并可认证的受支持智能体后端。
- 智能体可访问文件系统和 Shell，用户必须审查权限提示，并且只应在愿意授权访问的目录中运行。
- 远程浏览器和手机配对并非完全随 MIT 代码免费提供，需要有效的 Mirafold Pro 许可证密钥。
- 浏览器重连受守护进程重放缓冲区限制，较旧历史可能已经被丢弃；大输出也只保留开头和结尾。
这个 Agent 与同类方案有什么区别？
与直接在终端中使用 Claude Agent、Codex、OpenCode 或 Gemini CLI 相比，Mirafold 保留原生智能体及其本机权限模型，同时增加浏览器界面、结构化生成式 UI、多会话监管、文件与 Git 变更视图。它不是统一代理层，也不会用自有通用智能体替代这些 CLI。四种集成各自使用独立适配器，因此是否能启动实时会话仍取决于对应后端及其认证是否可用。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Mirafold 当前 | 87 · 表现良好 | 命令行工具免费版 + 付费版 | ★ 19 | 1 个月前 | TypeScript | Codex · Claude Code |
| zerostack | 69 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.7k | 4 天前 | Rust | OpenAI API · Claude API |
| pitwall | 81 · 表现良好 | — | ★ 21 | 今天 | Go | Codex · Claude Code |
| nca 原生 AI 编程 CLI | 59 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 205 | 今天 | Rust | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
安全材料具体说明了 loopback 绑定、仅按需启用的远程中继、浏览器 CSP、凭据留在服务端、项目环境变量白名单、检查点解码限制及 CI 权限，因此最小权限和敏感数据处理证据充分。README 和安全政策说明代理拥有文件与 shell 权限、`!` 命令使用真实 PTY，要求用户审阅权限提示并谨慎选择目录；但材料没有表明每项操作都由 Mirafold 单独确认，故用户确认与外部影响未满分。检查点可原子替换且有披露渠道，但没有通用操作回滚机制的证据，回滚扣分。引擎来源通过适配器、协议和 `notice.source` 归属规则说明，归属项满分。依赖版本和锁定策略有部分证据，惟静态材料不足以证明完整漏洞监控或处置覆盖，依赖安全扣分。
README、架构描述、包脚本和 CI 对主要测试层级及 mock/live 边界相互印证；但 CLAUDE.md 与 README 对开发服务器端口的描述并不一致（3000 与脚本中的 3100），故自洽性扣分。Node 版本、安装命令和包依赖有明确说明，但所给材料未包含锁文件或备用依赖获取安排，依赖可用性评为部分充分。启动故障、弱配对码、崩溃和安全配置问题有明确日志或用户提示证据，因此失败消息项得分高。
README 面向多种终端代理、不同认证与模型后端、桌面和远程浏览场景，并提供本地模型说明。安全政策清楚界定 loopback、真实 PTY、远程中继及本地模型发现等能力边界。代理选择和 `!`/`!!` 命令触发方式有说明，但摘录未完整展示各个上下文触发规则，触发精确度扣分。Node 22、npm/Yarn、开发与打包方式及不同端口配置均有说明，环境适配证据充分。
README 按安装、首次运行、开发、架构与文档分层，文档目录用途明确；安装条件、命令及 npm exec 风险说明具体。版本为 0.10.0，安全政策限定仅支持最新发布版本，计划文档与归档及发布指南提供变更路径；但摘录未含完整变更日志，命名稳定性和常见问题/示例覆盖也未完全证明。MIT 许可证及第三方许可说明充分。安全政策提供漏洞报告邮箱、响应时限和版本支持规则，但维护主体与持续更新责任未被充分独立证实，维护责任项扣分；发布流程虽具体，发布者身份按要求仍视为未知。
产品将终端代理会话、可读输出、交互组件、会话总览及只读文件/Git 查看整合进浏览器，README 说明具体操作和输出折叠行为，输出可用性与边际价值证据充分。安装为全局 npm 包且要求 Node 22；代理本身仍需本机运行，远程功能受 Pro 授权条件限制，因此成本收益虽有说明但未量化，得部分分。
README 的产品与运行声明可与包脚本、适配器入口、注册表、CI 和安全政策交叉核对；安全设计主张有对应源文件或工作流描述支撑。CI、测试层级被描述为仓库配置而非本次执行结果，报告明确保持静态审查和低置信度，没有把这些声明冒充为独立验证。材料未覆盖整个仓库，因此未展示部分不被当作缺失。
- Mirafold 会驱动具有本机文件和 shell 权限的代理；真实 PTY 命令以当前用户权限运行，使用前应审阅权限提示并确认工作目录适合代理访问。
- 远程访问通过可选中继且需满足 Pro 授权条件；安全政策说明本地模型服务器身份无法验证，选择恶意本地端点可能暴露对话内容。
- 开发服务器端口说明存在不一致：CLAUDE.md 写 3000，README 和 package 脚本使用 3100。
你是这个项目的维护者？把 FARS 徽章加到 README
[](https://followagents.com/zh/agents/mirafold)<a href="https://followagents.com/zh/agents/mirafold"><img src="https://followagents.com/badge/mirafold.svg?lang=zh" alt="FARS 评测"></a>最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v0.9.1 mirafold v0.9.1
发布说明摘录
Bug fixes and reliability improvements following v0.9.0. - Session switches show replayed history at its end. Phone prompts wait for a tap before taking focus. - Painting file links open in Files. Question detail links remain independent of answer buttons and usable after answering. - Unfinished turns keep their work state across reconnects. Encrypted messages retain their order, stale socket work is discarded, and an unserializable action cannot block later reconnects. …在 GitHub 查看 ↗ -
v0.9.0 mirafold v0.9.0
发布说明摘录
Secure Desktop relay foundation. Highlights: - Added the private Desktop-to-Shell credential handoff so a permanent Mirafold Pro key does not enter process environment, command arguments, child processes, logs, or viewport messages. - Added an additive local-only Desktop host identity and the activation return path while preserving older Desktop and ordinary terminal launches. - Hardened entitlement expiry and refresh behavior, malformed token handling, relay setup and reconnect failures, billing redaction, subscription claim validation, and persistent relay logging. …在 GitHub 查看 ↗ -
v0.8.4 mirafold v0.8.4
发布说明摘录
Architecture and development-reliability release. Highlights: - Clarified code ownership with stable domain folders for server adapters, session persistence and workspace services, test infrastructure, and client-side transport, transcript, input, and workspace logic. - Fixed yarn dev port coordination so an occupied daemon port fails the whole development stack instead of leaving Vite connected to an unrelated listener, while preserving source reloads across native and portable file watchers. - Preserved the active PTY controls when an overlapping ! or !! command is rejected. …在 GitHub 查看 ↗
常见问题
使用 Mirafold 是否必须配置模型凭据？
它会把智能体或文件系统移到云端吗？
远程手机访问包含在开源版本中吗？
浏览器重新连接后能否看到完整历史？
运行它有哪些主要安全风险？
谢谢反馈，我们会据此改进页面。