MindFS：开源Agent远程网关，将本地AI CLI无缝延伸至手机与平板

Image

远程访问 · AI Agent · 终端工具

MindFS 是一个开源网关，让你在本机跑 Agent CLI 的同时，通过浏览器把会话、文件和终端能力搬到手机、平板或其他设备上。

17+

支持 Agent CLI

AGPL-3.0

开源协议

<10MB

单文件安装包

刚在本机搭好一个 AI 编程 Agent 的终端 CLI，体验畅快，可一旦离开座位，整个交互链路就会断掉。过往的 session 滞留在本地，日志只能回到主机翻阅，手机或第二台设备完全无法触达。MindFS 正是为填补这个断层面设计出来的开源网关，让你在本地跑着 Claude Code、Codex、Qwen 等 Agent 的同时，将操作窗口、文件和历史会话一并映射到任意远程设备上，保持对话延续。

Image

MindFS 的定位与核心能力

MindFS 本质上是一个 Agent 远程访问网关加结果可视化层。它坐落在本机 Agent CLI 和浏览器之间，负责转发对话流、文件树和工具调用流，让同一份 Agent 会话能被多个终端看到并继续推进。官方仓库为 a9gent/mindfs，采用 AGPL-3.0 协议。开发团队同时运营着 relay 服务 relay.a9gent.com，为那些不想折腾端口映射的用户提供一条公网可达的访问通道。

它自身不捆绑任何模型，也不内嵌 Agent，只专注于打通“输入‑输出”的全路径。底层的智能替换工作交给你本机已安装的 Claude Code、OpenAI Codex、Gemini CLI、Cursor、Copilot CLI、Qwen、Kimi、Hermes、OpenClaw 等 17 个主流 Agent CLI。安装时你需要主动声明当前使用的 Agent，MindFS 会通过已有配置去发现并代理它们，透明地接管交互。

适用场景：四种典型困境的打通方式

最常见的一个使用场景就是“用 iPad/Android 躺在床上查看电脑上跑着的 Agent”。“远端”不必是云服务器，而可以是除本机外的任何一种浏览器交互入口。在四种高频需求里，MindFS 都能给出直接路径：

  • 随时恢复历史会话：Agent 先前因本机中断而丢失链接，传统重开无法回溯。MindFS 通过内部绑定将 session id 与底层 Agent 的 PID/终端状态关联，即使重启服务也能恢复之前的上下文。
  • 共享文件与上下文：浏览器界面自带文件树，支持 Markdown 和图片预览；输入框里键入 @ 会自动补全路径，把任意文件当作上下文直接发给 Agent。
  • 不暴露端口的外网访问：通过内置的 relay.a9gent.com 通道，本地无需任何防火墙端口映射，即可在外部访问。
  • 低成本切换设备：手机上不用安装任何 Agent 原生客户端，浏览器保持登录就能继续观看 token 流和交互界面，真正实现设备无关。

关于“免费”的真实含义

MindFS 本体完全免费开源（AGPL-3.0），本地无论多少用户都不收费。其 relay.a9gent.com 提供公网访问通道，开发团队没有对 relay 授权收取费用。真正产生费用的是模型 API 的消耗——只要你在本地订阅过 Claude API、OpenAI token 或 DeepSeek 等渠道，MindFS 不会多收一分钱。换句话说，它免费的部分是“带宽与窗口”，而“智能”的账单仍由你原模型账号承担。

不过要注意，开源团队对 relay 的稳定性没有给出 SLA 承诺。在需要稳定外网访问的重要任务中，最好准备一套 tailscale 之类的私有网络作为 fallback。

安装与启动：单文件分发，无重型依赖

MindFS 的单文件分发做得相当彻底，无需 Node、Docker 或守护进程管理器。macOS、Linux、Windows 都有独立的安装脚本，行为标准化：自动检测操作系统和架构，从 Releases 的第一个发布说明条目里读取版本号，下载对应二进制并加入 PATH。卸载时会抹掉二进制和 PATH 注册，但保留用户配置和项目目录下的 .mindfs 文件夹，防止误删重要数据。

以 macOS 为例，安装完成后最简单的入手方式是直接执行：

mindfs /path/to/your/project

它会在该 project 目录下创建一个 .mindfs 文件夹，内部存放会话、文件元数据和视图配置。多个项目可分别在不同目录重复执行来独立托管。浏览器打开 localhost:7331 即进入本地模式，无需账号。

提示　以项目根目录启动是最顺手的方式。MindFS 会同时充当目录的服务器、文件浏览器和 Agent 转发器，避免路径对齐时出现奇怪的解析错误。

Relay 远程模式：不暴露端口也能外网访问

Relay 远程模式是 MindFS 当前最强调的亮点。本地电脑可以困在公司弱网 NAT 后面，不开放任何入站端口，只需在浏览器里点击“绑定”按钮，完成一次简单的登录授权，随后节点就会由 relay.a9gent.com 分配一个公网可达的访问入口。用户不需要持续开着的 SSH 跳板机、不需要 tailscale 或 ngrok 之类的额外组件，手机打开链接就是完整的 UI。

操作顺序如下：

  1. 本地先执行 mindfs /project 启动服务，浏览器打开 localhost:7331。
  2. 在左下角找到“绑定/Bind”按钮，点击后进入账户流程，登录 relay.a9gent.com。
  3. 确认绑定授权，待状态更新完成后，点击“打开节点/Open Node”。
  4. 系统分配一个公网地址，把这个链接发给其他设备（例如手机），即可完成地址层面的远程接管。

手机端如何运行远程终端 CLI

MindFS 默认用结构卡片展示 Agent 的 token 流和工具调用，但如果你想直接执行 shell 命令，或用传统终端方式接管本机 CLI，一个稳妥的组合是“MindFS + SSH tunnel 子终端”。

  • 方案一：Relay 直达（上策）。手机浏览器打开 relay 分配的链接，界面与桌面端一致，可直接发起 Agent 对话、查看文件。无需额外部署 sidecar 服务，不要求穿透内网。
  • 方案二：私有网络 + 手机终端（中策）。如果你已布置 tailscale、zerotier、nebula 等组网工具，本机和手机各获得固定虚拟 IP。本地固定端口运行 MindFS：mindfs . -port 7331，手机端用任意 SSH/SFTP 客户端登录本机虚拟 IP 的 22 端口，即可实时操控主机 shell，而 Agent 读写文件也都在同一目录。适合已有组网的服务端或 NAS 用户。
  • 方案三：纯局域网直连（下策）。仅在同一局域网内查看终端，直接以 http://局域网IP:7331 打开 MindFS，无需任何外网通道。

直接在手机上操作 Command Shell 时，MindFS 界面内提供了命令执行卡片，可在会话里派发命令并保留历史。但最直观的路径仍是并行使用“MindFS 大屏界面”和“手机上的 SSH 终端”，而非强行将 UI 复杂化。推荐的一些终端工具：

  • iOS：Blink Shell，支持 Mosh，适合高丢包场景（高铁、地铁）。
  • Android：Termux 与 ConnectBot 均可实现。Android 上更可以直接在本机安装 Agent CLI，与同设备 MindFS 走本地配对，完全绕过 SSH。
  • 跨平台：任意 SSH 客户端配合 vtt+jsdelivr 均可打开 MindFS relay 链接，控制目标机。

若公司或工作室的账号策略只允许 Relay（如无 tailscale 落地），则优先选用 Relay 绑定方式，将所有 Agent 操作折叠在 MindFS 界面内，不额外暴露 22 端口。

小白上手顺序：从零到可用

以下为 macOS 用户的最短路径，假设你已安装至少一个 Agent CLI 且位于主 PATH 中。

  1. 安装二进制：
    curl -fsSL https://get.mindfs.sh | sh
mindfs -version
  2. 启动服务，指向工作目录：
    mindfs ~/Projects/my-app
  3. 浏览器打开 localhost:7331，进入本地模式，验证文件树和会话界面是否正常。
  4. 点击左下角“绑定”，走一次 relay.a9gent.com 授权。
  5. 绑定成功后，将显示的节点链接发给手机，浏览器打开即可远程接管。

节点链接格式通常为 https://relay.a9gent.com/node/{id}，只要未主动解绑，该链接持续有效，也可发给其他设备共同访问同一台 MindFS 实例。

常见踩坑提醒

  1. 本地没有 Agent 也能跑 MindFS，但对话面板为空。务必先在本机装好至少一个 Agent CLI，再开启 relay 链路，否则远程打开后无法使用任何智能功能。
  2. TLS 与端到端加密需成对使用。开启 E2EE 后，跳板机必须也启用 -tls，否则验证环节会失败；-tls 模式便于给局域网设备添加 HTTPS。
  3. MindFS 不会替你跑起 SSH 服务。别期望“开 MindFS 就能 SSH 进手机”。如果需要在手机上直接敲主机 shell，仍需搭配手机的 SSH 客户端——MindFS 解决的是“随时随地使用 Agent”，而不是替换传统终端。
  4. 多用户同步访问时注意权限。单个项目目录内 .mindfs 未做多用户权限隔离，当前所有登录了节点链接的用户都能自由读写，共享时需谨慎。

结语

如果你已经有了一个愿意长期使用的 Agent CLI，却不断被“必须回到主机才能继续”这种束缚卡住，MindFS 是一个相当省事的解方：单文件、支持 17+ Agent、多端 PWA，无需再学一个新工具，只是在本机之上盖了一扇通向手机和平板的门。那扇门，目前还在免费敞开。