mimi-remote
Mimi Remote is an open-source native mobile app for iOS/iPadOS that allows users to continue their computer agent sessions (Codex or Claude Code) on iPhone, iPad, or Mac without rebuilding context.
Ficha actualizada 23 sept 2026, 6:32 · upstream 23 sept 2026, 5:59 · release v1.0.0
Qué es mimi-remote
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Mimi Remote connects directly to your macOS, Windows, or Linux computer through Tailscale or the same local network. It does not operate a relay, account system, or hosted session service — your computer remains the control plane where agentd runs and manages sessions. The app simply bridges your mobile device to that trusted host, preserving all existing context, approvals, tasks, and runtime state. Data you intentionally send to Codex, Claude Code, GitHub, voice transcription, or MCP servers is still handled by those services under their own terms of service.
The project ships a native SwiftUI app for iPhone and iPad, plus Go-based agentd on macOS, Windows, and Linux. The mobile app connects only to your own host computer via private network protocols (REST/WebSocket), so no credentials or billing data are transferred across devices. This keeps the session model simple: one trusted machine holds all state, while the mobile interface provides a consistent experience regardless of device.
Codex is the primary supported runtime, with an optional Claude Code bridge that adapts its sessions and approvals to the same structured workflow. The app supports full agent lifecycle management — from starting new sessions to approving actions, changing models, or interrupting turns. It also integrates with Git tools like GitHub for pull request creation, diff inspection, and worktree management.
The mobile interface is designed around context preservation rather than screen size. iPhone keeps the current task in a compact hierarchy; iPad opens the same capabilities into a multi-column workspace that preserves project and session visibility while adding more detail. Both devices share token usage, connected hosts, language settings, model choices, and permission modes in one place — with appearance customization (light/dark mode, workspace icon sets) as a first-class feature.
Diagnostics, readiness checks, bounded log export, and reconnection capabilities help users recover from network drops or service interruptions without returning to the desktop. The app also includes a Mac menu bar utility for quick access to host health, runtime status, quota rings, pairing, diagno
- Continue an active agent session on iPhone or iPad after leaving the computer, so work doesn't restart from scratch
- Follow live progress of a running task — see when it's thinking, waiting, failed, or complete while structured replies arrive
- Add context to a session mid-conversation without restarting the conversation
- Queue a new instruction and continue an existing agent turn without losing state
- Change model choices (e.g., from Codex to Claude Code) during an active session
- Approve or reject actions taken by the agent before they execute
- Create pull requests directly from mobile for code changes made on a connected computer
- Inspect diffs and manage worktrees of files modified during the session
- Native SwiftUI app for iOS/iPadOS with a consistent design across devices
- Connects directly to your own computer via Tailscale or local network — no relay needed
- Preserves full session context, approvals, and task state without rebuilding history
- Codex is the primary runtime; Claude Code bridge is optional and experimental
- Mac menu bar app keeps host health, quota rings, and diagnostics one click away
- Supports Git integration for pull requests, diffs, and worktree management
- Mobile interface adapts layout per device (compact iPhone vs. multi-column iPad)
- Reduce Motion enabled to keep state changes clear without spatial effects
- Only supports Codex as the primary runtime; Claude Code bridge is experimental and disabled by default
- Requires a trusted local network or Tailscale connection — no public internet access for agentd
- No support for multi-device sessions across different computers (only one host at a time)
- Token usage, quota limits, and billing are managed on the host computer, not in the app
- Voice transcription is limited to iOS 26+ native Apple Speech; older iOS versions use system-level transcription
- No support for Windows or Linux desktop environments — only macOS, Windows, and Linux terminal clients
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Install agentd on your target machine (macOS, Windows, or Linux) using the provided Go binary or Docker image For macOS: brew install go && go mod download && ./agentd --version For Windows: Download from GitHub releases and run as administrator For Linux: Install via package manager (e.g., apt install agentd) Start the service with: sudo systemctl start mimi-remote-agentd or ./agentd --start,Connect your iPhone/iPad to the same trusted network using Tailscale, Wi-Fi, or Ethernet On iOS: Open Settings > General > VPN & Network > Add Device and enter the agentd hostname (e.g., mimi-remote.local) Verify connection with: curl -s http://localhost:4222/health,Configure your Codex or Claude Code instance to accept connections from the agentd IP address For macOS, add the agentd's IP to the allowed hosts list in the runtime configuration file
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.