【独立开发】Agentmux：在手机上续接远程 tmux 与 AI Agent 会话

saxlamen
38 阅读4分钟

大家好，过去几个月我在做一款 iOS 应用 Agentmux，今天它已经在 App Store 正式上架。

感谢 TestFlight 期间所有参与测试、留言反馈的朋友。从最初的 beta 版到现在，累计 400+ commits，不只是加功能，也在键盘闪烁、tmux 重连、文件预览这些细节上反复打磨。

如果你平时在 终端 + SSH + tmux 里工作，并且开始在远程机器上跑 Claude Code、OpenCode、Gemini CLI 等 Agent，这篇文章或许对你有用。

iphone-raw-run-coding-agents-anywhere.webp

ipad-raw-run-coding-agents-anywhere.webp

我遇到了什么问题

在 iPhone / iPad 上连回远程服务器写代码、跑脚本，摩擦感很强：

  1. 网络一切换，任务就断 —— 地铁进隧道、Wi-Fi 切 5G，AI 生成到一半的任务直接停掉
  2. App 来回切 —— 想看 Agent 刚生成的 Markdown 或图片，得在终端和 SFTP 软件之间跳
  3. 启动成本高 —— 小屏幕上每次 cd 到项目目录再敲启动命令，很麻烦

传统 SSH 客户端擅长「连上服务器」，但对 长时运行的 AI Agent 工作流 理解不够：session 要持久、文件要就近查看、项目入口要够快。

Agentmux 的定位很直白：不是取代桌面上的 OpenCode / Claude Code，而是让你在手机上把远程机器上的 session 续下去。

典型使用场景

家里 / 云上的 Linux 开发机
    ├── tmux session（持久）
    ├── OpenCode / Claude Code / Gemini CLI
    └── 项目代码

         ↕ SSH

iPhone / iPad（Agentmux）
    ├── 一键进入项目 + 启动 Agent
    ├── 终端继续刚才的 TUI
    └── 同屏浏览、预览 Agent 生成的文件

国内很多开发者用 自有 VPS、内网穿透、Tailscale / Netbird 等方式连回家里的机器或云端环境，Agentmux 都适用。核心前提是：你已经在远程机上跑 Agent，只是想在移动端「盯进度、改个小配置、回两句 prompt」。

从 TestFlight 到正式版，改了什么

模块正式版强化
Session锁屏 Live Activities / 动态岛显示后台任务与 active session
编辑器Tree-sitter 语法高亮（17+ 语言）、JSON / YAML / TOML 语法校验
终端键盘高度学习（切换输入法减少闪烁）、OSC 52（Vim/Neovim 复制到 iOS 剪贴板）
同步iCloud 增量同步服务器配置
整体Agent 检测、tmux 重连、文件预览稳定性

tmux 仍是核心设计
每次连接都走 tmux；服务器没装可以一键安装。网络断了，重连后回到同一个 session，而不是重开 Agent。

核心功能

手机端启动 AI Agent

支持在远程项目 session 中直接启动：

Claude、Codex、Gemini、OpenCode、Antigravity 以及自定义 CLI Agent。

App 会扫描服务器上的项目目录，并把已安装的 Agent 列在仪表盘，点一下就能进项目、开 session，不用记路径。

tmux + Live Activity

  • 网络切换、App 进后台、锁屏后 session 尽量保持
  • 锁屏 / 动态岛查看后台任务状态
  • 服务器无 tmux → 一键安装

远程文件浏览与编辑

  • SFTP / SSH 文件浏览器，查看 Git 状态
  • Tree-sitter 语法高亮（Python、Rust、Swift、Go、TS 等）
  • JSON / YAML / TOML 严格校验，手机上改配置不怕少逗号
  • Markdown 预览、远程图片手势滑动浏览

移动端终端优化

  • iPhone 快捷键面板：Ctrl、Esc、Tab、Home/End、方向键
  • 键盘高度学习：切换输入法时减少画面抖动
  • iPad：实体键盘、触控板、横向 Split View

工作流同步与安全

  • iCloud 同步服务器配置（iPhone 添加，iPad 直接连）
  • SSH 密钥与凭证存在 Keychain

技术栈（给关心实现的同学）

Agentmux 是原生 iOS 应用，主要技术选型：

  • SwiftUI + SwiftData — UI 与本地数据
  • SwiftTerm — 终端仿真；针对移动端惯性滚动做过调优
  • Tree-sitter — 编辑器语法高亮
  • tmux over SSH — session 持久化的基石

终端类 App 的难点不在「能连上」，而在 输入法切换不闪、CJK 宽字符对齐、后台重连、OSC 52 剪贴板 这些细节。400 个 commits 里相当一部分花在这里。

定价

  • 14 天完整功能 Pro 试用
  • Pro 为 一次性买断，无订阅

下载与文档

想听听你的 remote coding workflow

还有很多可以改进的地方，欢迎在评论区聊聊：

  • 你的远程开发环境怎么搭的？（VPS / 家里 NAS / 内网穿透？）
  • 远程跑 OpenCode / Claude Code 时，最烦的一步是什么？
  • tmux 重连、Agent 检测有没有踩坑？

🎁 Promo Code 赠送（5 名）

为感谢掘金读者的支持，准备了 5 组 Pro 版终身解锁 Promo Code。

请在评论区 分享你平时的 remote coding workflow（用什么机器、什么 Agent、怎么连、tmux 怎么用——几句话即可）。我会从评论中选出 前 5 位 私信发送兑换码。

Agentmux 是个人开发项目，为「住在终端里的人」而作。欢迎试用，期待你的反馈。

如果这篇文章对你有帮助，欢迎点赞收藏，也欢迎把你在移动端远程开发的经验留在评论区。

avatar
文章
阅读
粉丝