Mimi Remote CLI
A remote for Codex and Claude Code from iPhone and iPad: follow progress, reply and approve what the agent does on your computer.
- 112 ★ on the repository
- Last commit
Broad access
Why this level
- The gateway on the computer accepts commands from the phone, and new sessions default to full file access without asking.
- The connection runs over the local network or Tailscale, and any paired phone gains access to the computer.
Install
- Works in
Manual install
Download the host installer from the Releases of gaixianggeng/mimi-remote, then use the `install-mimi-remote` skill from `packaging/skill` to install and verify the `agentd` gateway on this computer.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The gateway on the computer accepts commands from the phone, and new sessions default to full file access without asking.
- The connection runs over the local network or Tailscale, and any paired phone gains access to the computer.
This is third-party code. Review the repository files before installing.
What it does
Mimi Remote is a free open-source app for iPhone and iPad that controls agent sessions running on your computer. The agent, projects and sessions stay on the computer. The app connects to it over a trusted local network or Tailscale and turns the conversation, tool steps, approvals and changes into a phone interface. On the computer (Mac, Windows 10 or 11, Linux) a Go gateway `agentd` authenticates the app and routes requests to the selected runtime. The main runtime is Codex, with live progress, approvals and task controls. Claude Code is experimental: sessions and approvals but no goals, archive or fork. DeepSeek Harness is also supported with text sessions. To install and set up the computer side, you can give Codex the `install-mimi-remote` skill from `packaging/skill`. Notifications arrive on the lock screen, and pairing is done by scanning a QR code.
Who it is for. Developers who run Codex or Claude Code on a laptop and want to watch the work and approve actions from a phone.
Good fit when
- The agent works on a task for a long time and you want to follow progress on your phone away from home.
- The agent stopped at an approval and a lock-screen notification reaches you.
- You have several computers and want to switch among them in one app.
- You want to continue on the phone a session started on the computer, without re-explaining.
Not a fit when
- You need a remote desktop or an arbitrary shell: the app controls agent sessions only.
- The computer shuts down or sleeps: the agent runs on it and must stay online.
- You have no iPhone or iPad running iOS or iPadOS 18 or newer.
Example request
Show from the phone which step the test migration task is at and let me allow the migration run once.Limitations
An iPhone or iPad on iOS 18 or newer and a computer that stays awake are required: macOS 15 or newer, Windows 10 or 11 x64, or Linux with systemd. An installed and signed-in Codex CLI is mandatory, and Claude Code support is experimental. New sessions default to the Full File Access mode, where the agent runs commands without asking until you choose approval prompts. Outside the local network you need Tailscale or the experimental Tailcat connection. The license is GPLv3 with an extra store-distribution permission.
How to disable. Delete the app from the phone, quit Mimi Remote in the computer menu and uninstall the program. Sessions remain in Codex or Claude Code.
FAQ
How do I get started?
Install and sign in to Codex CLI on the computer, install the host from Releases, install the app from the App Store or TestFlight and scan the QR code in the app.
Do I sign in to OpenAI or Anthropic on the phone?
No. The app only connects to your computer, and the agent uses the sign-in already done there. Mimi Remote never handles those credentials.
How do I connect away from home?
Put the phone and computer on the same private network with Tailscale. Mac, Windows and Linux also offer an experimental Tailcat connection, off by default.
Where are sessions stored?
On your computer, kept by Codex, Claude Code or DeepSeek Harness. Mimi Remote has no cloud account or session hosting.
Does it cost anything?
The app and the computer software are free and open source, with no in-app purchases or subscriptions. Model usage counts against the Codex or Claude Code account on your computer.
Discussion
No questions or reviews yet.
Related
CLI toolsA CLI for macOS and Linux: Codex, Claude Code and Grok sessions on your computer open on your phone via QR, end-to-end encrypted
Claude-to-IM
claude-to-im
A bridge between Claude Code or Codex and messengers: talk to the agent from Telegram, Discord, Feishu, QQ or WeChat
Codex Relay lets you follow Codex CLI sessions and answer the agent from a phone while the work stays on your computer.
Mac screen HUD for agents: quotas, tokens and sessions of Claude Code, Codex and more, plus a built-in MCP server.
Voice control of Claude Code and Codex sessions on your machines: a small agent on each box links it to the pitupitu cloud.
Agent Standup shows Claude Code, Codex and Mistral Vibe sessions as a live team call: who works, who waits.
README in short
The repository holds the SwiftUI iPhone and iPad app, the Go `agentd` gateway, the Mac menu bar app, the Windows and Linux tray and the Claude bridge. It differs from remote desktop and SSH with a phone-shaped interface and approval buttons.