Mimi Remote

Mimi Remote 是一款开源、原生且本地优先的 iOS/iPadOS 应用，旨在打破桌面端的限制，让用户能够在移动设备上无缝续接 AI 编程工作流。它并非简单的 SSH 终端或网页镜像，而是专为 Codex（稳定主通道）和 Claude Code（实验性通道）设计的原生交互界面。

通过 Tailscale 组建的私有网络，Mimi Remote 安全地连接用户自己 Mac 上运行的 agentd 服务，实现代码审查、任务审批、Git 操作及上下文补充等功能。所有数据、凭证和会话均保留在用户本地设备中，不经过任何第三方云端服务器，确保了极致的隐私与安全性。

核心亮点：为何选择 Mimi Remote？

• 📱 原生移动端体验：基于 SwiftUI 构建，支持深浅色模式、自适应布局及富文本渲染。告别在手机终端里辨认转义字符的痛苦，提供清晰的 Markdown 阅读、Diff 检查和工具审批界面。
• 🔒 极致隐私与本地优先：
  • 零云端中转：App 仅通过 Tailscale 私网连接你的 Mac，项目方不提供任何中继云服务。
  • 数据主权：代码、AI 凭证（API Key）、完整会话历史均存储在用户自己的设备上。
  • 安全边界：iOS 端仅保存访问 Token（存于 Keychain），Mac 端 agentd 严格限制可访问的项目路径和操作权限。
• 🛠️ 完整的 Git 闭环：支持在移动端执行 stage/unstage/revert、commit、push 以及创建草稿 PR，适合在离开电脑时完成最后的代码收尾工作。
• 🤖 双引擎支持：
  • Codex：作为稳定主通道，支持完整的会话管理、流式输出、Steer/Interrupt 控制。
  • Claude Code：通过独立的 Rust bridge (alleycat-claude-bridge) 实验性接入，共用同一套移动端 UI。

主要功能清单

安全架构

Mimi Remote 的设计遵循“最小权限”原则：

1. Tailscale 私网：默认建议通过 Tailscale 进行内网穿透，避免将 agentd 暴露于公网。
2. 短期票据：配对二维码使用短期、单次兑换票据，不直接传输长期 Token。
3. 命令白名单：远程命令仅允许执行配置中定义的 action，并带有确认提示、超时控制和输出上限。
4. 隔离环境：Codex app-server capability token 仅保存在 Mac 的 loopback 环境中，外部无法直接访问。

快速开始指南

1. Mac 端安装与配置

要求：已安装 Codex CLI，Mac 与 iOS 设备在同一 Tailscale 网络，已安装 Homebrew。

# 安装 Mimi Remote 服务端
brew update
brew install gaixianggeng/tap/mimi-remote

# 启动 agentd 服务
agentd up
# 此时会生成配置和 Token，并显示配对二维码

常用维护命令：

• agentd status：查看服务状态
• agentd pair：重新生成配对码
• agentd doctor --fix：自动修复常见问题
• agentd logs -n 200：查看最近日志

2. iOS 端安装（目前需源码构建）

由于尚未上架 App Store，用户需自行编译：

# 生成 Xcode 工程
xcodegen generate \
  --spec ios/MimiRemote/project.yml \
  --project ios/MimiRemote

# 打开工程并在 Xcode 中运行
open ios/MimiRemote/MimiRemote.xcodeproj

注意：工程要求 iOS / iPadOS 26 或更高版本（注：此处原文可能指未来版本或笔误，实际构建时请留意兼容性）。

配对：首次启动 App 时，扫描 Mac 终端显示的二维码即可完成安全连接。

3. 启用 Claude Code 实验通道（可选）

若需使用 Claude Code，需安装独立的 Bridge 组件：

# 安装 bridge
cargo install --git https://github.com/gaixianggeng/codex-ipad-agent.git \
  --locked --force --bin alleycat-claude-bridge alleycat-claude-bridge

# 在用户配置中启用
{
  "claude": {
    "enabled": true,
    "bridge_bin": "/opt/homebrew/bin/alleycat-claude-bridge",
    ...
  }
}

# 重启服务并验证
agentd restart
agentd doctor

总结

Mimi Remote 填补了 AI 编程助手在移动端体验上的巨大空白。它让开发者能够真正意义上地“带着 AI 去旅行”，在咖啡店里用 iPad 审查代码，在通勤路上用 iPhone 批准工具调用。对于追求效率、隐私和本地化控制的 Codex/Claude Code 用户而言，这是一个不可或缺的进阶工具。